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

  • Artikel

Kommentar

Azure Spring Apps är det nya namnet på Azure Spring Cloud-tjänsten. Även om tjänsten har ett nytt namn ser du det gamla namnet på vissa platser ett tag medan vi arbetar med att uppdatera tillgångar som skärmbilder, videor och diagram.

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:

  1. Skapa en instans av Azure Spring Apps.

  2. Skapa ett program.

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

  3. 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-portalen med följande procedur.

  1. I din Azure Spring Apps-instans väljer du Appar i navigeringsfönstret.

    Screenshot of the Azure portal showing the Apps page for an Azure Spring Apps instance.

  2. Välj programmet i listan och välj sedan Konfiguration i navigeringsfönstret.

  3. Använd fliken Allmänna inställningar för att uppdatera värden, till exempel JVM-alternativen.

    Screenshot of the Azure portal showing the Configuration page for an app with the General settings tab selected.

  4. Välj Miljövariabler för att lägga till eller uppdatera variablerna som används av ditt program.

    Screenshot of the Azure portal showing the Configuration page for an app with the Environment variables tab selected.

  5. Visa sidan program-API/gatewaysammanfattning från instrumentpanelen Ny relik.

    Screenshot of the New Relic dashboard showing the API Gateway summary page.

  6. Visa sidan Sammanfattning av programkunder-tjänst från instrumentpanelen Ny relik.

    Screenshot of the New Relic dashboard showing the Customers Service page.

  7. Visa sidan Tjänstkarta från instrumentpanelen Ny relik.

    Screenshot of the New Relic dashboard showing the Service Map page.

  8. Visa JVM-sidan för programmet från instrumentpanelen Ny relik.

    Screenshot of the New Relic dashboard showing the JVM page.

  9. Visa programprofilen från instrumentpanelen Ny relik.

    Screenshot of the New Relic dashboard showing the Application Profile page.

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