Konfigurera APM-plattformar för Tomcat-, JBoss- eller Java SE-appar i Azure App Service

Den här artikeln visar hur du ansluter Java-program som distribuerats i Azure App Service med Azure Monitor Application Insights-, NewRelic- och AppDynamics-programprestandaövervakningsplattformar (APM).

Azure App Service kör Java-webbprogram på en fullständigt hanterad tjänst i tre varianter:

• Java SE – Kan köra en app som distribueras som ett JAR-paket som innehåller en inbäddad server (till exempel Spring Boot, Dropwizard, Quarkus eller en med en inbäddad Tomcat- eller Jetty-server).
• Tomcat – Den inbyggda Tomcat-servern kan köra en app som distribueras som ett WAR-paket.
• JBoss EAP – Stöds endast för Linux-appar på prisnivåerna Kostnadsfri, Premium v3 och Isolerad v2. Den inbyggda JBoss EAP-servern kan köra en app som distribueras som ett WAR- eller EAR-paket.

Kommentar

För Spring-program rekommenderar vi att du använder Azure Spring Apps. Du kan dock fortfarande använda Azure App Service som mål. Mer information finns i Vägledning för Java-arbetsbelastningsmål.

Konfigurera Application Insights

Azure Monitor Application Insights är en molnbaserad programövervakningstjänst som gör det möjligt för kunder att observera fel, flaskhalsar och användningsmönster för att förbättra programmets prestanda och minska tiden till lösning (MTTR). Med några klick eller CLI-kommandon kan du aktivera övervakning för dina Node.js- eller Java-appar, automatiskt samla in loggar, mått och distribuerade spårningar, vilket eliminerar behovet av att inkludera en SDK i din app. Mer information om tillgängliga appinställningar för att konfigurera agenten finns i Application Insights-dokumentationen.

Azure-portalen

Om du vill aktivera Application Insights från Azure Portal går du till Application Insights på menyn till vänster och väljer Aktivera Application Insights. Som standard används en ny application insights-resurs med samma namn som webbappen. Du kan välja att använda en befintlig application insights-resurs eller ändra namnet. Välj Använd längst ned.

Azure CLI

Om du vill aktivera via Azure CLI måste du skapa en Application Insights-resurs och ange ett par appinställningar på Azure Portal för att ansluta Application Insights till din webbapp.

1. Aktivera Application Insights-tillägget

   az extension add -n application-insights
   

2. Skapa en Application Insights-resurs med följande CLI-kommando. Ersätt platshållarna med önskat resursnamn och din grupp.

   az monitor app-insights component create --app <resource-name> -g <resource-group> --location westus2  --kind web --application-type web
   

   Observera värdena för connectionString och instrumentationKey, du behöver dessa värden i nästa steg.

   Kommentar

   Om du vill hämta en lista över andra platser kör du az account list-locations.

3. Ange instrumenteringsnyckeln, anslutningssträng och övervakningsagentversionen som appinställningar i webbappen. Ersätt <instrumentationKey> och <connectionString> med värdena från föregående steg.

   Linux

   az webapp config appsettings set -n <webapp-name> -g <resource-group> --settings "APPINSIGHTS_INSTRUMENTATIONKEY=<instrumentationKey>" "APPLICATIONINSIGHTS_CONNECTION_STRING=<connectionString>" "ApplicationInsightsAgent_EXTENSION_VERSION=~3" "XDT_MicrosoftApplicationInsights_Mode=default"
   

   Windows

   az webapp config appsettings set -n <webapp-name> -g <resource-group> --settings "APPINSIGHTS_INSTRUMENTATIONKEY=<instrumentationKey>" "APPLICATIONINSIGHTS_CONNECTION_STRING=<connectionString>" "ApplicationInsightsAgent_EXTENSION_VERSION=~3" "XDT_MicrosoftApplicationInsights_Mode=default" "XDT_MicrosoftApplicationInsights_Java=1"
   

Konfigurera ny relik

Linux

Kommentar

Den senaste nya Relic-dokumentationen visar JBoss EAP-stöd på upp till 7.x. JBoss EAP 8.x stöds inte ännu.

1. Skapa ett NewRelic-konto på NewRelic.com

2. Ladda ned Java-agenten från NewRelic.

3. Kopiera licensnyckeln. Du behöver den för att konfigurera agenten senare.

4. SSH till din App Service-instans och skapa en ny katalog /home/site/wwwroot/apm.

5. Ladda upp de uppackade Java-agentfilerna i NewRelic till en katalog under /home/site/wwwroot/apm. Filerna för din agent ska finnas i /home/site/wwwroot/apm/newrelic.

6. Ändra YAML-filen på /home/site/wwwroot/apm/newrelic/newrelic.yml och ersätt platshållarlicensvärdet med din egen licensnyckel.

7. I Azure Portal bläddrar du till ditt program i App Service och skapar en ny programinställning.

   Skapa en miljövariabel med namnet JAVA_OPTS med värdet -javaagent:/home/site/wwwroot/apm/newrelic/newrelic.jar.

   Skapa en miljövariabel med namnet CATALINA_OPTS med värdet -javaagent:/home/site/wwwroot/apm/newrelic/newrelic.jar.

Windows

1. Skapa ett NewRelic-konto på NewRelic.com

2. Ladda ned Java-agenten från NewRelic. Det har ett filnamn som liknar newrelic-java-x.x.x.zip.

3. Kopiera licensnyckeln. Du behöver den för att konfigurera agenten senare.

4. SSH till din App Service-instans och skapa en ny katalog /home/site/wwwroot/apm.

5. Ladda upp de uppackade Java-agentfilerna i NewRelic till en katalog under /home/site/wwwroot/apm. Filerna för din agent ska finnas i /home/site/wwwroot/apm/newrelic.

6. Ändra YAML-filen på /home/site/wwwroot/apm/newrelic/newrelic.yml och ersätt platshållarlicensvärdet med din egen licensnyckel.

7. I Azure Portal bläddrar du till ditt program i App Service och skapar en ny programinställning.

   Skapa en miljövariabel med namnet JAVA_OPTS med värdet -javaagent:/home/site/wwwroot/apm/newrelic/newrelic.jar.

   Skapa en miljövariabel med namnet CATALINA_OPTS med värdet -javaagent:/home/site/wwwroot/apm/newrelic/newrelic.jar.

Kommentar

Om du redan har en miljövariabel för JAVA_OPTSlägger du till -javaagent:/... alternativet i slutet av det aktuella värdet.

Kommentar

Om du redan har en miljövariabel för CATALINA_OPTSlägger du till -javaagent:/... alternativet i slutet av det aktuella värdet.

Konfigurera AppDynamics

Linux

1. Skapa ett AppDynamics-konto på AppDynamics.com

2. Ladda ned Java-agenten från AppDynamics webbplats. Filnamnet liknar AppServerAgent-x.x.x.xxxxx.zip

3. SSH till din App Service-instans och skapa en ny katalog /home/site/wwwroot/apm.

4. Ladda upp Java-agentfilerna till en katalog under /home/site/wwwroot/apm. Filerna för din agent ska finnas i /home/site/wwwroot/apm/appdynamics.

5. I Azure Portal bläddrar du till ditt program i App Service och skapar en ny programinställning.

   Skapa en miljövariabel med namnet JAVA_OPTS med värdet -javaagent:/home/site/wwwroot/apm/appdynamics/javaagent.jar -Dappdynamics.agent.applicationName=<app-name> där <app-name> är ditt App Service-namn. Om du redan har en miljövariabel för JAVA_OPTSlägger du till -javaagent:/... alternativet i slutet av det aktuella värdet.

   Skapa en miljövariabel med namnet CATALINA_OPTS med värdet -javaagent:/home/site/wwwroot/apm/appdynamics/javaagent.jar -Dappdynamics.agent.applicationName=<app-name> där <app-name> är ditt App Service-namn. Om du redan har en miljövariabel för CATALINA_OPTSlägger du till -javaagent:/... alternativet i slutet av det aktuella värdet.

Windows

1. Skapa ett AppDynamics-konto på AppDynamics.com

2. Ladda ned Java-agenten från AppDynamics webbplats. Filnamnet liknar AppServerAgent-x.x.x.xxxxx.zip

3. Använd Kudu-konsolen för att skapa en ny katalog /home/site/wwwroot/apm.

4. Ladda upp Java-agentfilerna till en katalog under /home/site/wwwroot/apm. Filerna för din agent ska finnas i /home/site/wwwroot/apm/appdynamics.

5. I Azure Portal bläddrar du till ditt program i App Service och skapar en ny programinställning.

   Skapa en miljövariabel med namnet JAVA_OPTS med värdet -javaagent:/home/site/wwwroot/apm/appdynamics/javaagent.jar -Dappdynamics.agent.applicationName=<app-name> där <app-name> är ditt App Service-namn. Om du redan har en miljövariabel för JAVA_OPTSlägger du till -javaagent:/... alternativet i slutet av det aktuella värdet.

   Skapa en miljövariabel med namnet CATALINA_OPTS med värdet -javaagent:/home/site/wwwroot/apm/appdynamics/javaagent.jar -Dappdynamics.agent.applicationName=<app-name> där <app-name> är ditt App Service-namn. Om du redan har en miljövariabel för CATALINA_OPTSlägger du till -javaagent:/... alternativet i slutet av det aktuella värdet.

Konfigurera Datadog

Linux

Konfigurationsalternativen skiljer sig beroende på vilken Datadog-plats din organisation använder. Se den officiella dokumentationen om Datadog-integrering för Azure

Windows

Konfigurationsalternativen skiljer sig beroende på vilken Datadog-plats din organisation använder. Se den officiella dokumentationen om Datadog-integrering för Azure

Konfigurera Dynatrace

Linux

Dynatrace tillhandahåller en Azure Native Dynatrace-tjänst. Information om hur du övervakar Azure App Services med Dynatrace finns i den officiella Dokumentationen om Dynatrace för Azure

Windows

Dynatrace tillhandahåller en Azure Native Dynatrace-tjänst. Information om hur du övervakar Azure App Services med Dynatrace finns i den officiella Dokumentationen om Dynatrace för Azure

Nästa steg

Besök Azure for Java Developers Center för att hitta Azure-snabbstarter, självstudier och Java-referensdokumentation.

• Vanliga frågor och svar om App Service på Linux
• Referens för miljövariabler och appinställningar