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,New Relic- och AppDynamics-programprestandaövervakningsplattformar (APM).

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

• Java Standard Edition (SE). Java SE kan köra en app som distribueras som ett Java-arkivpaket (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). Det här alternativet stöds för Linux-appar i en uppsättning prisnivåer som inkluderar Kostnadsfri, Premium v3 och Isolerad v2.

Anteckning

JBoss EAP på App Service stöder nu BYOL-fakturering (Bring Your Own License). BYOL gör det möjligt för kunder som har befintliga Red Hat-prenumerationer att tillämpa dessa licenser direkt på sina JBoss EAP-distributioner i Azure App Service. Mer information finns i BYOL-stöd för JBoss EAP på App Service.

Konfigurera Application Insights

Azure Monitor Application Insights är en molnbaserad programövervakningstjänst. Det gör att du kan observera fel, flaskhalsar och användningsmönster för att förbättra programmets prestanda och minska genomsnittlig tid till lösning (MTTR). Du kan aktivera övervakning för dina Node.js- eller Java-appar, automatiskt samla in loggar, mått och distribuerade spårningar. Application Insights 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-portalen går du till den vänstra menyn och väljer Övervaka>Application Insights. Välj 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 Apply längst ner.

Azure CLI

Om du vill aktivera med hjälp av Azure CLI måste du skapa en Application Insights-resurs och ange ett par appinställningar 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 resursnamnet och gruppen.

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

   Notera värden för connectionString och instrumentationKey. Du behöver 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

Så här konfigurerar du 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 ännu inte.

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

2. Ladda ned Java-agenten från New Relic.

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 Java-agentfilerna för Relic 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. Ersätt licensens platshållarvärde med din 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 nytt Relic-konto på NewRelic.com.

2. Ladda ned Java-agenten från New Relic. 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 Java-agentfilerna för Relic 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. Ersätt licensens platshållarvärde med din 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

Så här konfigurerar du AppDynamics:

Linux

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

2. Ladda ner 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 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 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 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. Information om hur du övervakar Azure App Services med Dynatrace finns i den officiella Dokumentationen om Dynatrace för Azure.

Windows

Dynatrace erbjuder 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.

Relaterat innehåll

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