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

Den här artikeln visar hur man kopplar Java-applikationer som är distribuerade på Azure App Service med Azure Monitor Application Insights, NewRelic och AppDynamics plattformar för applikationsövervakning (APM).

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

• Java Standard Edition (SE): Kan köra en app som distribueras som ett Java Archive-paket (JAR) som innehåller en inbäddad server (till exempel Spring Boot, Quarkus, Dropwizard eller en app med en inbäddad Tomcat- eller Jetty-server).
• Tomcat: Den inbyggda Tomcat-servern kan köra en app som distribueras som ett WAR-paket (Web Application Archive).
• JBoss Enterprise Application Platform (EAP): Den inbyggda JBoss EAP-servern kan köra en app som distribueras som ett WAR- eller företagsarkivpaket (EAR). Stöds för Linux-appar i en uppsättning prisnivåer som innehåller Kostnadsfri, Premium v3 och Isolerad v2.gti

Konfigurera Application Insights

Azure Monitor Application Insights är en molnbaserad applikationsö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 applikationens prestanda och minska genomsnittlig tid till lösning (MTTR). Med några få klick eller CLI-kommandon kan du aktivera övervakning för dina Node.js- eller Java-appar, som automatiskt samlar in loggar, mätvärden och distribuerade spår, vilket eliminerar behovet av att inkludera ett SDK i din app. För mer information om de tillgängliga applikationsinställningarna för att konfigurera agenten, se Application Insights-dokumentationen.

Azure Portal

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 din webbapp. Du kan välja att använda en befintlig Application Insights-resurs eller ändra namnet. Välj Apply längst ner.

Azure CLI

För att aktivera via Azure CLI behöver du skapa en Application Insights-resurs och ställa in ett par app-inställningar i Azure-portalen för att ansluta Application Insights till din webbapp.

1. Aktivera Applications 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 grupp.

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

   Notera värdena för connectionString och instrumentationKey, du kommer att behöva dessa värden i nästa steg.

   Anteckning

   För att hämta en lista över andra platser, kör az account list-locations.

3. Ställ in instrumentnyckel, anslutningssträng och övervakningsagentversion som appinställningar på 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 New Relic

Linux

Anteckning

Den senaste New Relic-dokumentationen listar JBoss EAP-stöd upp till version 7.x. JBoss EAP 8.x stöds inte ännu.

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

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

3. Kopiera din licensnyckel, 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 NewRelic Java-agentfilerna till en katalog under /home/site/wwwroot/apm. Filfilerna för din agent bör 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. Gå till din applikation i App Service i Azure-portalen och skapa en ny applikationsinställning.

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

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

Windows

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

2. Ladda ner Java-agenten från NewRelic. Filnamnet liknar newrelic-java-x.x.x.zip.

3. Kopiera din licensnyckel, 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 NewRelic Java-agentfilerna till en katalog under /home/site/wwwroot/apm. Filfilerna för din agent bör 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. Gå till din applikation i App Service i Azure-portalen och skapa en ny applikationsinställning.

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

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

Anteckning

Om du redan har en miljövariabel för JAVA_OPTS, lägg till alternativet -javaagent:/... till slutet av det aktuella värdet.

Anteckning

Om du redan har en miljövariabel för CATALINA_OPTS, lägg till alternativet -javaagent:/... till slutet av det aktuella värdet.

Konfigurera AppDynamics

Linux

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

2. Ladda ner Java-agenten från AppDynamics webbplats. Filnamnet är liknande 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 i en katalog under /home/site/wwwroot/apm. Filmerna för din agent ska vara i /home/site/wwwroot/apm/appdynamics.

5. Gå till din applikation i App Service i Azure-portalen och skapa en ny applikationsinställning.

   Skapa en miljövariabel som heter 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_OPTS, lägg till alternativet -javaagent:/... till slutet av det aktuella värdet.

   Skapa en miljövariabel som heter 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_OPTS, lägg till alternativet -javaagent:/... till slutet av det aktuella värdet.

Windows

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

2. Ladda ner Java-agenten från AppDynamics webbplats. Filnamnet är liknande 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 i en katalog under /home/site/wwwroot/apm. Filmerna för din agent ska vara i /home/site/wwwroot/apm/appdynamics.

5. Gå till din applikation i App Service i Azure-portalen och skapa en ny applikationsinställning.

   Skapa en miljövariabel som heter 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_OPTS, lägg till alternativet -javaagent:/... till slutet av det aktuella värdet.

   Skapa en miljövariabel som heter 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_OPTS, lägg till alternativet -javaagent:/... till slutet av det aktuella värdet.

Konfigurera Datadog

Linux

Konfigurationsalternativen skiljer sig åt beroende på vilken Datadog-webbplats din organisation använder. Se den officiella Datadog-integrationen för Azure-dokumentation

Windows

Konfigurationsalternativen skiljer sig åt beroende på vilken Datadog-webbplats din organisation använder. Se den officiella Datadog-integrationen för Azure-dokumentation

Konfigurera Dynatrace

Linux

Dynatrace erbjuder en Azure Native Dynatrace-tjänst. För att övervaka Azure App Services med Dynatrace, se den officiella Dynatrace-dokumentationen för Azure

Windows

Dynatrace erbjuder en Azure Native Dynatrace-tjänst. För att övervaka Azure App Services med Dynatrace, se den officiella Dynatrace-dokumentationen för Azure

Nästa steg

Besök Azure för Java-utvecklare för att hitta Azure-snabbstarter, handledningar och Java-referensdokumentation.

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