Konfigurieren von APM-Plattformen für Tomcat-, JBoss- oder Java SE-Apps in Azure App Service

In diesem Artikel wird gezeigt, wie Java-Anwendungen, die auf Azure App Service bereitgestellt werden, mit Azure Monitor Application Insights, New Relic und AppDynamics-Anwendungsleistungsüberwachungsplattformen (APM) verbunden werden.

Azure App Service führt Java-Webanwendungen in drei Typen in einem vollständig verwalteten Dienst aus:

• Java Standard Edition (SE). Java SE kann eine App ausführen, die als Java-Archivpaket (JAR) bereitgestellt wird, das einen eingebetteten Server enthält, z. B. Spring Boot, Aspxus, Dropwizard oder eine App mit einem eingebetteten Tomcat- oder Jetty-Server.
• Tomcat. Der integrierte Tomcat-Server kann eine App ausführen, die als War-Paket (Web Application Archive) bereitgestellt wird.
• JBoss Enterprise Application Platform (EAP): Der integrierte JBoss EAP-Server kann eine App ausführen, die als WAR- oder Enterprise-Archivpaket (EAR) bereitgestellt wird. Diese Option wird für Linux-Apps in einer Reihe von Preisstufen unterstützt, die free, Premium v3 und Isolated v2 enthalten.

Hinweis

JBoss EAP on App Service unterstützt jetzt die Bring Your Own License (BYOL)-Abrechnung. BYOL ermöglicht Kunden, die über vorhandene Red Hat-Abonnements verfügen, diese Lizenzen direkt auf ihre JBoss EAP-Bereitstellungen in Azure App Service anzuwenden. Weitere Informationen finden Sie unter BYOL-Support für JBoss EAP für App Service.

Application Insights konfigurieren

Azure Monitor Application Insights ist ein cloudeigener Anwendungsüberwachungsdienst. Sie können Fehler, Engpässe und Verwendungsmuster beobachten, um die Anwendungsleistung zu verbessern und die mittlere Zeit zur Auflösung (MTTR) zu reduzieren. Sie können die Überwachung für Ihre Node.js- oder Java-Apps aktivieren, um die automatische Erfassung von Protokollen, Metriken und verteilten Ablaufverfolgungen zu ermöglichen. Application Insights beseitigt die Notwendigkeit, ein SDK in Ihre App einzuschließen. Weitere Informationen zu den verfügbaren App-Einstellungen zum Konfigurieren des Agents finden Sie in der Application Insights-Dokumentation.

Azure-Portal

Um Application Insights aus dem Azure-Portal zu aktivieren, wählen Sie im linken Menü "Monitoring>Application Insights" aus. Wählen Sie "Application Insights aktivieren" aus.

Standardmäßig wird eine neue Application Insights-Ressource mit demselben Namen wie Ihre Web-App verwendet. Sie können eine vorhandene Application Insights-Ressource verwenden oder den Namen ändern. Wählen Sie unten Anwenden aus.

Azure-Befehlszeilenschnittstelle

Um die Verwendung der Azure CLI zu ermöglichen, müssen Sie eine Application Insights-Ressource erstellen und ein paar App-Einstellungen festlegen, um Application Insights mit Ihrer Web-App zu verbinden.

1. Aktivieren Sie die Application Insights-Erweiterung.

   az extension add -n application-insights
   

2. Erstellen Sie mit dem folgenden CLI-Befehl eine Application Insights-Ressource. Ersetzen Sie die Platzhalter durch den Ressourcennamen und die Gruppe.

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

   Notieren Sie die Werte für connectionString und instrumentationKey. Sie benötigen diese Werte im nächsten Schritt.

   Hinweis

   Um eine Liste anderer Standorte abzurufen, führen Sie az account list-locations aus.

3. Legen Sie den Instrumentierungsschlüssel, die Verbindungszeichenfolge und die Version des Überwachungs-Agents als App-Einstellungen für die Web-App fest. Ersetzen Sie <instrumentationKey> und <connectionString> durch die Werte aus dem vorherigen Schritt.

   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"
   

   Fenster

   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"
   

Konfigurieren von NewRelic

So konfigurieren Sie New Relic:

Linux

Hinweis

In der aktuellen Dokumentation zu New Relic ist die JBoss EAP-Unterstützung bis 7.x aufgeführt. JBoss EAP 8.x wird noch nicht unterstützt.

1. Erstellen Sie ein New Relic-Konto bei NewRelic.com.

2. Laden Sie den Java-Agent von New Relic herunter.

3. Kopieren Sie Ihren Lizenzschlüssel. Sie benötigen ihn später zum Konfigurieren des Agents.

4. Stellen Sie eine SSH-Verbindung mit Ihrer App Service-Instanz her, und erstellen Sie das neue Verzeichnis /home/site/wwwroot/apm.

5. Laden Sie die entpackten New Relic Java-Agent-Dateien in ein Verzeichnis unter "/home/site/wwwroot/apm" hoch. Die Dateien für Ihren Agenten sollten Sie unter /home/site/wwwroot/apm/newrelic finden.

6. Ändern Sie die YAML-Datei unter /home/site/wwwroot/apm/newrelic/newrelic.yml. Ersetzen Sie den Platzhalterlizenzwert durch Ihren Lizenzschlüssel.

7. Navigieren Sie im Azure-Portal zu Ihrer Anwendung in App Service, und erstellen Sie eine neue Anwendungseinstellung.

   Erstellen Sie eine Umgebungsvariable namens JAVA_OPTS mit dem Wert -javaagent:/home/site/wwwroot/apm/newrelic/newrelic.jar.

   Erstellen Sie eine Umgebungsvariable namens CATALINA_OPTS mit dem Wert -javaagent:/home/site/wwwroot/apm/newrelic/newrelic.jar.

Fenster

1. Erstellen Sie ein New Relic-Konto bei NewRelic.com.

2. Laden Sie den Java-Agent von New Relic herunter. Der Dateiname hat das Format newrelic-java-x.x.x.zip.

3. Kopieren Sie Ihren Lizenzschlüssel. Sie benötigen ihn später zum Konfigurieren des Agents.

4. Stellen Sie eine SSH-Verbindung mit Ihrer App Service-Instanz her, und erstellen Sie das neue Verzeichnis /home/site/wwwroot/apm.

5. Laden Sie die entpackten New Relic Java-Agent-Dateien in ein Verzeichnis unter "/home/site/wwwroot/apm" hoch. Die Dateien für Ihren Agenten sollten Sie unter /home/site/wwwroot/apm/newrelic finden.

6. Ändern Sie die YAML-Datei unter /home/site/wwwroot/apm/newrelic/newrelic.yml. Ersetzen Sie den Platzhalterlizenzwert durch Ihren Lizenzschlüssel.

7. Navigieren Sie im Azure-Portal zu Ihrer Anwendung in App Service, und erstellen Sie eine neue Anwendungseinstellung.

   Erstellen Sie eine Umgebungsvariable namens JAVA_OPTS mit dem Wert -javaagent:/home/site/wwwroot/apm/newrelic/newrelic.jar.

   Erstellen Sie eine Umgebungsvariable namens CATALINA_OPTS mit dem Wert -javaagent:/home/site/wwwroot/apm/newrelic/newrelic.jar.

Hinweis

Falls Sie bereits über eine Umgebungsvariable für JAVA_OPTS verfügen, können Sie die Option -javaagent:/... am Ende des aktuellen Werts anhängen.

Hinweis

Falls Sie bereits über eine Umgebungsvariable für CATALINA_OPTS verfügen, können Sie die Option -javaagent:/... am Ende des aktuellen Werts anhängen.

Konfigurieren von AppDynamics

So konfigurieren Sie AppDynamics:

Linux

1. Erstellen Sie ein AppDynamics-Konto bei AppDynamics.com.

2. Laden Sie den Java-Agent von der AppDynamics-Website herunter. Der Dateiname ähnelt AppServerAgent-x.x.x.xxxxx.zip.

3. Stellen Sie eine SSH-Verbindung mit Ihrer App Service-Instanz her, und erstellen Sie das neue Verzeichnis /home/site/wwwroot/apm.

4. Laden Sie die Dateien für den Java-Agent in ein Verzeichnis unter /home/site/wwwroot/apm herunter. Die Dateien für Ihren Agenten sollten Sie unter /home/site/wwwroot/apm/appdynamics finden.

5. Navigieren Sie im Azure-Portal zu Ihrer Anwendung in App Service, und erstellen Sie eine neue Anwendungseinstellung.

   Erstellen Sie eine Umgebungsvariable namens JAVA_OPTS mit dem Wert -javaagent:/home/site/wwwroot/apm/appdynamics/javaagent.jar -Dappdynamics.agent.applicationName=<app-name>, wobei <app-name> für Ihren App Service-Namen steht. Falls Sie bereits über eine Umgebungsvariable für JAVA_OPTS verfügen, können Sie die Option -javaagent:/... am Ende des aktuellen Werts anhängen.

   Erstellen Sie eine Umgebungsvariable namens CATALINA_OPTS mit dem Wert -javaagent:/home/site/wwwroot/apm/appdynamics/javaagent.jar -Dappdynamics.agent.applicationName=<app-name>, wobei <app-name> für Ihren App Service-Namen steht. Falls Sie bereits über eine Umgebungsvariable für CATALINA_OPTS verfügen, können Sie die Option -javaagent:/... am Ende des aktuellen Werts anhängen.

Fenster

1. Erstellen Sie ein AppDynamics-Konto bei AppDynamics.com.

2. Laden Sie den Java-Agent von der AppDynamics-Website herunter. Der Dateiname ähnelt AppServerAgent-x.x.x.xxxxx.zip.

3. Verwenden Sie die Kudu-Konsole, um ein neues Verzeichnis namens /home/site/wwwroot/apm zu erstellen.

4. Laden Sie die Dateien für den Java-Agent in ein Verzeichnis unter /home/site/wwwroot/apm herunter. Die Dateien für Ihren Agenten sollten Sie unter /home/site/wwwroot/apm/appdynamics finden.

5. Navigieren Sie im Azure-Portal zu Ihrer Anwendung in App Service, und erstellen Sie eine neue Anwendungseinstellung.

   Erstellen Sie eine Umgebungsvariable namens JAVA_OPTS mit dem Wert -javaagent:/home/site/wwwroot/apm/appdynamics/javaagent.jar -Dappdynamics.agent.applicationName=<app-name>, wobei <app-name> für Ihren App Service-Namen steht. Falls Sie bereits über eine Umgebungsvariable für JAVA_OPTS verfügen, können Sie die Option -javaagent:/... am Ende des aktuellen Werts anhängen.

   Erstellen Sie eine Umgebungsvariable namens CATALINA_OPTS mit dem Wert -javaagent:/home/site/wwwroot/apm/appdynamics/javaagent.jar -Dappdynamics.agent.applicationName=<app-name>, wobei <app-name> für Ihren App Service-Namen steht. Falls Sie bereits über eine Umgebungsvariable für CATALINA_OPTS verfügen, können Sie die Option -javaagent:/... am Ende des aktuellen Werts anhängen.

Konfigurieren von Datadog

Linux

Die Konfigurationsoptionen unterscheiden sich je nachdem, welche Datadog-Website Ihre Organisation verwendet. Siehe die offizielle Dokumentation für die Datadog-Integration für Azure

Fenster

Die Konfigurationsoptionen unterscheiden sich je nachdem, welche Datadog-Website Ihre Organisation verwendet. Siehe die offizielle Dokumentation für die Datadog-Integration für Azure

Konfigurieren von Dynatrace

Linux

Dynatrace stellt einen Azure-nativen Dynatrace-Dienst bereit. Informationen zum Überwachen von Azure App Services mit Dynatrace finden Sie in der offiziellen Dynatrace für Azure-Dokumentation.

Fenster

Dynatrace stellt einen Azure-nativen Dynatrace-Dienst bereit. Informationen zum Überwachen von Azure App Services mit Dynatrace finden Sie in der offiziellen Dynatrace für Azure-Dokumentation.

Verwandte Inhalte

Besuchen Sie das Center Azure für Java-Entwickler, um Azure-Schnellstarts, Tutorials und Java-Referenzdokumentation zu finden.

• Häufig gestellte Fragen (FAQ) zu Azure App Service unter Linux
• Referenz zu Umgebungsvariablen und App-Einstellungen