Freigeben über

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

  • Artikel

In diesem Artikel wird veranschaulicht, wie Sie Java-Anwendungen, die in Azure App Service mit Azure Monitor Application Insights bereitgestellt werden, mit den Plattformen NewRelic und AppDynamics für die Überwachung der Anwendungsleistung (Application Performance Monitoring, APM) verbinden.

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

  • Java SE: Kann eine App ausführen, die als JAR-Paket bereitgestellt wird, das einen eingebetteten Server enthält (z. B. Spring Boot, Dropwizard, Quarkus oder eine App mit einem eingebetteten Tomcat- oder Jetty-Server).
  • Tomcat: Der integrierte Tomcat-Server kann eine als WAR-Paket bereitgestellte App ausführen.
  • JBoss EAP: Wird nur für Linux-Apps in den Tarifen „Free“, „Premium v3“ und „V2 isoliert“ unterstützt. Der integrierte JBoss EAP-Server kann eine als WAR- oder EAR-Paket bereitgestellte App ausführen.

Hinweis

Für Spring-Anwendungen wird die Verwendung von Azure Spring Apps empfohlen. Sie können Azure App Service jedoch weiterhin als Ziel verwenden. Weitere Informationen finden Sie unter Java-Workload-Zielleitfaden.

Application Insights konfigurieren

Azure Monitor Application Insights ist ein Cloud-nativer Anwendungsüberwachungsdienst, der es Kunden ermöglicht, Ausfälle, Engpässe und Nutzungsmuster zu beobachten, um die Anwendungsleistung zu verbessern und die mittlere Zeit bis zur Lösung (MTTR) zu reduzieren. Mit wenigen Mausklicks oder CLI-Befehlen können Sie die Überwachung für Ihre Node.js- oder Java-Apps aktivieren, wobei Protokolle, Metriken und verteilte Ablaufverfolgungen automatisch erfasst werden, sodass Sie in Ihrer App kein SDK bereitstellen müssen. Weitere Informationen zu den verfügbaren App-Einstellungen zum Konfigurieren des Agents finden Sie in der Application Insights-Dokumentation.

Um Application Insights über das Azure-Portal zu aktivieren, wechseln Sie im Menü auf der linken Seite zu Application Insights und wählen 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.

Konfigurieren von NewRelic

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 NewRelic-Konto unter NewRelic.com.

  2. Laden Sie den Java-Agent von NewRelic 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 Dateien für den NewRelic-Java-Agent in ein Verzeichnis unter /home/site/wwwroot/apm herunter. 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, und ersetzen Sie den Platzhalter-Lizenzwert durch Ihren eigenen 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

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

  2. Laden Sie den Java-Agent von der AppDynamics-Website herunter. Der Dateiname hat das Format 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.

Konfigurieren von Datadog

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

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

Nächste Schritte

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