Så här övervakar du Spring Boot-appar med hjälp av En ny Relic Java-agent

Artikel
10/01/2024

Kommentar

Basic-, Standard- och Enterprise-planerna kommer att vara inaktuella från och med mitten av mars 2025, med en 3-årig pensionsperiod. Vi rekommenderar att du övergår till Azure Container Apps. Mer information finns i meddelandet om azure Spring Apps-pensionering.

Standardförbrukningen och den dedikerade planen kommer att vara inaktuell från och med den 30 september 2024, med en fullständig avstängning efter sex månader. Vi rekommenderar att du övergår till Azure Container Apps. Mer information finns i Migrera Azure Spring Apps Standard-förbrukning och dedikerad plan till Azure Container Apps.

Den här artikeln gäller för: ✔️ Standardförbrukning och dedikerad (förhandsversion) ✔️ Basic/Standard ❌ Enterprise

Den här artikeln visar hur du övervakar Spring Boot-program i Azure Spring Apps med Den nya Relic Java-agenten.

Med Den nya Relic Java-agenten kan du:

Använd Den nya Relic Java-agenten.
Konfigurera Den nya Relic Java-agenten med hjälp av miljövariabler.
Kontrollera alla övervakningsdata från instrumentpanelen Ny relik.

I följande video beskrivs hur du aktiverar och övervakar Spring Boot-program i Azure Spring Apps med hjälp av New Relic One.

Förutsättningar

Aktivera den nya Relic Java i processagenten

Använd följande procedur för att komma åt agenten:

Skapa en instans av Azure Spring Apps.

Skapa ett program.

az spring app create \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <app-name> \
    --is-public true \

Skapa en distribution med variablerna Ny relikagent och miljö.

az spring app deploy \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <app-name> \
    --artifact-path app.jar \
    --jvm-options="-javaagent:/opt/agents/newrelic/java/newrelic-agent.jar" \
    --env NEW_RELIC_APP_NAME=appName \
          NEW_RELIC_LICENSE_KEY=newRelicLicenseKey

Azure Spring Apps förinstallerar Den nya Relic Java-agenten till /opt/agents/newrelic/java/newrelic-agent.jar. Kunder kan aktivera agenten från programmens JVM-alternativ och konfigurera agenten med hjälp av miljövariablerna för New Relic Java-agenten.

Azure Portal

Du kan också aktivera den här agenten från Azure Portal med följande procedur.

I din Azure Spring Apps-instans väljer du Appar i navigeringsfönstret.
Välj programmet i listan och välj sedan Konfiguration i navigeringsfönstret.
Använd fliken Allmänna inställningar för att uppdatera värden, till exempel JVM-alternativen.
Välj Miljövariabler för att lägga till eller uppdatera variablerna som används av ditt program.
Visa sidan program-API/gatewaysammanfattning från instrumentpanelen Ny relik.
Visa sidan Sammanfattning av programkunder-tjänst från instrumentpanelen Ny relik.
Visa sidan Tjänstkarta från instrumentpanelen Ny relik.
Visa JVM-sidan för programmet från instrumentpanelen Ny relik.
Visa programprofilen från instrumentpanelen Ny relik.

Automatisera etablering

Du kan också köra en pipeline för etableringsautomatisering med Terraform, Bicep eller en Azure Resource Manager-mall (ARM-mall). Den här pipelinen kan ge en fullständig praktisk upplevelse för att instrumentera och övervaka alla nya program som du skapar och distribuerar.

Automatisera etablering med Terraform

Om du vill konfigurera miljövariablerna i en Terraform-mall lägger du till följande kod i mallen och ersätter <platshållarna ...> med dina egna värden. Mer information finns i Hantera en aktiv Azure Spring Apps-distribution.

resource "azurerm_spring_cloud_java_deployment" "example" {
  ...
  jvm_options = "-javaagent:/opt/agents/newrelic/java/newrelic-agent.jar"
  ...
    environment_variables = {
      "NEW_RELIC_APP_NAME": "<app-name>",
      "NEW_RELIC_LICENSE_KEY": "<new-relic-license-key>"
  }
}

Automatisera etablering med hjälp av en Bicep-fil

Om du vill konfigurera miljövariablerna i en Bicep-fil lägger du till följande kod i mallen och ersätter <platshållarna ...> med dina egna värden. Mer information finns i Microsoft.AppPlatform Spring/apps/deployments.

deploymentSettings: {
  environmentVariables: {
    NEW_RELIC_APP_NAME : '<app-name>',
    NEW_RELIC_LICENSE_KEY : '<new-relic-license-key>'
  },
  jvmOptions: '-javaagent:/opt/agents/newrelic/java/newrelic-agent.jar',
  ...
}

Automatisera etablering med hjälp av en ARM-mall

Om du vill konfigurera miljövariablerna i en ARM-mall lägger du till följande kod i mallen och ersätter <platshållarna ...> med dina egna värden. Mer information finns i Microsoft.AppPlatform Spring/apps/deployments.

"deploymentSettings": {
  "environmentVariables": {
    "NEW_RELIC_APP_NAME" : "<app-name>",
    "NEW_RELIC_LICENSE_KEY" : "<new-relic-license-key>"
  },
  "jvmOptions": "-javaagent:/opt/agents/newrelic/java/newrelic-agent.jar",
  ...
}

Vidarebefordra programloggar till New Relic

New Relic-agenten kan samla in programloggar direkt från dina appar och vidarebefordra dem till New Relic. Mer information finns i Vidarebefordra loggarna till Nya Relic - och APM-loggar i kontext.

Visa nya Java-agentloggar för Relic

Som standard skriver Azure Spring Apps ut loggarna för Den nya Relic Java-agenten till STDOUT. Loggarna blandas med programloggarna. Du hittar den explicita agentversionen från programloggarna.

Du kan också hämta loggarna för New Relic-agenten från följande platser:

Azure Spring Apps-loggar
Azure Spring Apps Application Insights
Azure Spring Apps LogStream

Du kan använda vissa miljövariabler som tillhandahålls av New Relic för att konfigurera loggning av den nya agenten, till exempel för NEW_RELIC_LOG_LEVEL att styra loggnivån. Mer information finns i Konfiguration av ny relikloggning.

Kommentar

Använd finer inte eller finest såvida inte New Relic Support ber dig att göra det. Dessa loggningsnivåer kan generera överdrivna omkostnader. I de flesta situationer använder du info.

Varning

Vi rekommenderar starkt att du inte åsidosätter standardbeteendet för loggning som tillhandahålls av Azure Spring Apps for New Relic. Om du gör det blockeras loggningsscenarierna som beskrivits tidigare och loggfilerna kan gå förlorade. Du bör till exempel inte skicka följande miljövariabler till dina program. Loggfiler kan gå förlorade efter omstart eller omdistribution av program.

NEW_RELIC_LOG
NEW_RELIC_LOG_FILE_PATH

Ny uppdatering/uppgradering av Relic Java Agent

Den nya Relic Java-agenten uppdaterar/uppgraderar JDK regelbundet. Agentuppdateringen/-uppgraderingen kan påverka följande scenarier.

Befintliga program som använder Den nya Relic Java-agenten före uppdatering/uppgradering är oförändrade.
Befintliga program som använder Den nya Relic Java-agenten före uppdatering/uppgradering kräver omstart eller omdistribution för att aktivera den nya versionen av Den nya Relic Java-agenten.
Nya program som skapats efter uppdatering/uppgradering använder den nya versionen av Den nya Relic Java-agenten.

Utgående trafikkonfiguration för Vnet-instansinstans

För en vnet-inmatningsinstans av Azure Spring Apps måste du se till att den utgående trafiken är korrekt konfigurerad för Den nya Relic Java-agenten. Mer information finns i Nätverk av ny relik.

Nästa steg

Använda Application Insights Java In-Process Agent i Azure Spring Apps

Dela via