Konfigurace platforem APM pro aplikace Tomcat, JBoss nebo Java SE ve službě Aplikace Azure Service

Tento článek ukazuje, jak připojit aplikace Java nasazené ve službě Aplikace Azure pomocí platforem Azure Monitor Application Insights, NewRelic a AppDynamics Application Performance Monitoring (APM).

Aplikace Azure Služba spouští webové aplikace Java v plně spravované službě ve třech variantách:

• Java SE – Může spustit aplikaci nasazenou jako balíček JAR, který obsahuje vložený server (například Spring Boot, Dropwizard, Quarkus nebo jeden s vloženým serverem Tomcat nebo Jetty).
• Tomcat – Integrovaný server Tomcat může spustit aplikaci nasazenou jako balíček WAR.
• JBoss EAP – Podporuje se jenom pro linuxové aplikace v cenových úrovních Free, Premium v3 a Isolated v2. Integrovaný server JBoss EAP může spustit aplikaci nasazenou jako balíček WAR nebo EAR.

Poznámka:

Pro aplikace Spring doporučujeme používat Azure Spring Apps. Službu Aplikace Azure však můžete použít jako cíl. Rady najdete v pokynech k cíli úloh v Javě.

Konfigurace Application Insights

Azure Monitor Application Insights je cloudová nativní služba pro monitorování aplikací, která zákazníkům umožňuje sledovat chyby, kritické body a vzorce použití, aby zlepšili výkon aplikace a zkrátili střední dobu řešení (MTTR). Pomocí několika kliknutí nebo příkazů rozhraní příkazového řádku můžete povolit monitorování vašich Node.js nebo aplikací v Javě, automatické shromažďování protokolů, metrik a distribuovaných trasování, což eliminuje potřebu zahrnutí sady SDK do vaší aplikace. Další informace o dostupných nastaveních aplikace pro konfiguraci agenta najdete v dokumentaci k Application Insights.

Azure Portal

Pokud chcete povolit Application Insights z webu Azure Portal, přejděte v nabídce vlevo do Application Insights a vyberte Zapnout Application Insights. Ve výchozím nastavení se používá nový prostředek Application Insights se stejným názvem jako vaše webová aplikace. Můžete použít existující prostředek Application Insights nebo změnit název. Vyberte Použít v dolní části.

Azure CLI

Pokud chcete povolit prostřednictvím Azure CLI, musíte vytvořit prostředek Application Insights a nastavit několik nastavení aplikace na webu Azure Portal pro připojení Application Insights k webové aplikaci.

1. Povolení rozšíření Application Insights

   az extension add -n application-insights
   

2. Pomocí následujícího příkazu rozhraní příkazového řádku vytvořte prostředek Application Insights. Zástupné symboly nahraďte požadovaným názvem a skupinou prostředků.

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

   Poznamenejte si hodnoty a connectionString instrumentationKeytyto hodnoty budete potřebovat v dalším kroku.

   Poznámka:

   Pokud chcete načíst seznam dalších umístění, spusťte az account list-locationspříkaz .

3. Nastavte instrumentační klíč, připojovací řetězec a verzi agenta monitorování jako nastavení aplikace ve webové aplikaci. Nahraďte <instrumentationKey> hodnoty z předchozího kroku a <connectionString> nahraďte je.

   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"
   

Konfigurace New Relic

Linux

Poznámka:

Nejnovější dokumentace New Relic obsahuje seznam podpory JBoss EAP až 7.x. JBoss EAP 8.x se zatím nepodporuje.

1. Vytvoření účtu NewRelic na NewRelic.com

2. Stáhněte agenta Java z NewRelic.

3. Zkopírujte licenční klíč, budete ho potřebovat k pozdější konfiguraci agenta.

4. Připojte se ke své instanci služby App Service SSH a vytvořte nový adresář /home/site/wwwroot/apm.

5. Nahrajte rozbalené soubory agenta NewRelic Java do adresáře v adresáři v části /home/site/wwwroot/apm. Soubory vašeho agenta by měly být na adrese /home/site/wwwroot/apm/newrelic.

6. Upravte soubor YAML na adrese /home/site/wwwroot/apm/newrelic/newrelic.yml a nahraďte zástupnou hodnotu licence vlastním licenčním klíčem.

7. Na webu Azure Portal přejděte do aplikace ve službě App Service a vytvořte nové nastavení aplikace.

   Vytvořte proměnnou prostředí s názvem JAVA_OPTS s hodnotou -javaagent:/home/site/wwwroot/apm/newrelic/newrelic.jar.

   Vytvořte proměnnou prostředí s názvem CATALINA_OPTS s hodnotou -javaagent:/home/site/wwwroot/apm/newrelic/newrelic.jar.

Windows

1. Vytvoření účtu NewRelic na NewRelic.com

2. Stáhněte agenta Java z NewRelic. Má název souboru podobný newrelic-java-x.x.x.zip.

3. Zkopírujte licenční klíč, budete ho potřebovat k pozdější konfiguraci agenta.

4. Připojte se ke své instanci služby App Service SSH a vytvořte nový adresář /home/site/wwwroot/apm.

5. Nahrajte rozbalené soubory agenta NewRelic Java do adresáře v adresáři v části /home/site/wwwroot/apm. Soubory vašeho agenta by měly být na adrese /home/site/wwwroot/apm/newrelic.

6. Upravte soubor YAML na adrese /home/site/wwwroot/apm/newrelic/newrelic.yml a nahraďte zástupnou hodnotu licence vlastním licenčním klíčem.

7. Na webu Azure Portal přejděte do aplikace ve službě App Service a vytvořte nové nastavení aplikace.

   Vytvořte proměnnou prostředí s názvem JAVA_OPTS s hodnotou -javaagent:/home/site/wwwroot/apm/newrelic/newrelic.jar.

   Vytvořte proměnnou prostředí s názvem CATALINA_OPTS s hodnotou -javaagent:/home/site/wwwroot/apm/newrelic/newrelic.jar.

Poznámka:

Pokud už máte proměnnou prostředí , JAVA_OPTSpřipojte -javaagent:/... možnost na konec aktuální hodnoty.

Poznámka:

Pokud už máte proměnnou prostředí , CATALINA_OPTSpřipojte -javaagent:/... možnost na konec aktuální hodnoty.

Konfigurace AppDynamics

Linux

1. Vytvoření účtu AppDynamics na AppDynamics.com

2. Stáhněte agenta Java z webu AppDynamics. Název souboru je podobný AppServerAgent-x.x.x.xxxxx.zip

3. Připojte se ke své instanci služby App Service SSH a vytvořte nový adresář /home/site/wwwroot/apm.

4. Nahrajte soubory agenta Java do adresáře v umístění /home/site/wwwroot/apm. Soubory pro vašeho agenta by měly být v /home/site/wwwroot/apm/appdynamics.

5. Na webu Azure Portal přejděte do aplikace ve službě App Service a vytvořte nové nastavení aplikace.

   Vytvořte proměnnou prostředí s názvem JAVA_OPTS -javaagent:/home/site/wwwroot/apm/appdynamics/javaagent.jar -Dappdynamics.agent.applicationName=<app-name> , kde <app-name> je název vaší služby App Service. Pokud už máte proměnnou prostředí , JAVA_OPTSpřipojte -javaagent:/... možnost na konec aktuální hodnoty.

   Vytvořte proměnnou prostředí s názvem CATALINA_OPTS -javaagent:/home/site/wwwroot/apm/appdynamics/javaagent.jar -Dappdynamics.agent.applicationName=<app-name> , kde <app-name> je název vaší služby App Service. Pokud už máte proměnnou prostředí , CATALINA_OPTSpřipojte -javaagent:/... možnost na konec aktuální hodnoty.

Windows

1. Vytvoření účtu AppDynamics na AppDynamics.com

2. Stáhněte agenta Java z webu AppDynamics. Název souboru je podobný AppServerAgent-x.x.x.xxxxx.zip

3. Pomocí konzoly Kudu vytvořte nový adresář /home/site/wwwroot/apm.

4. Nahrajte soubory agenta Java do adresáře v umístění /home/site/wwwroot/apm. Soubory pro vašeho agenta by měly být v /home/site/wwwroot/apm/appdynamics.

5. Na webu Azure Portal přejděte do aplikace ve službě App Service a vytvořte nové nastavení aplikace.

   Vytvořte proměnnou prostředí s názvem JAVA_OPTS -javaagent:/home/site/wwwroot/apm/appdynamics/javaagent.jar -Dappdynamics.agent.applicationName=<app-name> , kde <app-name> je název vaší služby App Service. Pokud už máte proměnnou prostředí , JAVA_OPTSpřipojte -javaagent:/... možnost na konec aktuální hodnoty.

   Vytvořte proměnnou prostředí s názvem CATALINA_OPTS -javaagent:/home/site/wwwroot/apm/appdynamics/javaagent.jar -Dappdynamics.agent.applicationName=<app-name> , kde <app-name> je název vaší služby App Service. Pokud už máte proměnnou prostředí , CATALINA_OPTSpřipojte -javaagent:/... možnost na konec aktuální hodnoty.

Konfigurace služby Datadog

Linux

Možnosti konfigurace se liší v závislosti na tom, který web Datadog vaše organizace používá. Prohlédnou si oficiální dokumentace k integraci služby Datadog pro Azure.

Windows

Možnosti konfigurace se liší v závislosti na tom, který web Datadog vaše organizace používá. Prohlédnou si oficiální dokumentace k integraci služby Datadog pro Azure.

Konfigurace dynatrace

Linux

Dynatrace poskytuje službu Azure Native Dynatrace Service. Pokud chcete monitorovat Aplikace Azure Služby pomocí dynatrace, prohlédnou si oficiální dokumentace k Dynatrace pro Azure.

Windows

Dynatrace poskytuje službu Azure Native Dynatrace Service. Pokud chcete monitorovat Aplikace Azure Služby pomocí dynatrace, prohlédnou si oficiální dokumentace k Dynatrace pro Azure.

Další kroky

Navštivte centrum pro vývojáře v Azure pro Javu a najděte referenční dokumentaci k Azure pro rychlý start, kurzy a referenční dokumentaci k Javě.

• Nejčastější dotazy k App Service v Linuxu
• Referenční informace k proměnným prostředí a nastavením aplikace