APM-platforms configureren voor Tomcat-, JBoss- of Java SE-apps in Azure-app Service

In dit artikel wordt beschreven hoe u Java-toepassingen verbindt die zijn geïmplementeerd op Azure-app Service met Azure Monitor Application Insights-, NewRelic- en AppDynamics-platformen (Application Performance Monitoring).

Azure-app Service voert Java-webtoepassingen uit op een volledig beheerde service in drie varianten:

• Java SE: kan een app uitvoeren die is geïmplementeerd als een JAR-pakket dat een ingesloten server bevat (zoals Spring Boot, Dropwizard, Quarkus of een met een ingesloten Tomcat- of Jetty-server).
• Tomcat: de ingebouwde Tomcat-server kan een app uitvoeren die is geïmplementeerd als een WAR-pakket.
• JBoss EAP : alleen ondersteund voor Linux-apps in de prijscategorieën Free, Premium v3 en Isolated v2. De ingebouwde JBoss EAP-server kan een app uitvoeren die is geïmplementeerd als WAR- of EAR-pakket.

Notitie

Voor Spring-toepassingen wordt u aangeraden Azure Spring Apps te gebruiken. U kunt echter nog steeds Azure-app Service als bestemming gebruiken. Zie de richtlijnen voor java-workloadbestemmingen voor advies.

Application Insights configureren

Azure Monitor Application Insights is een cloudeigen toepassingsbewakingsservice waarmee klanten fouten, knelpunten en gebruikspatronen kunnen observeren om de prestaties van toepassingen te verbeteren en de gemiddelde tijd tot oplossing (MTTR) te verminderen. Met een paar klikken of CLI-opdrachten kunt u bewaking inschakelen voor uw Node.js- of Java-apps, het automatisch verzamelen van logboeken, metrische gegevens en gedistribueerde traceringen, waardoor u geen SDK in uw app hoeft op te nemen. Zie de Application Insights-documentatie voor meer informatie over de beschikbare app-instellingen voor het configureren van de agent.

Azure-portal

Als u Application Insights vanuit Azure Portal wilt inschakelen, gaat u naar Application Insights in het menu aan de linkerkant en selecteert u Application Insights inschakelen. Standaard wordt een nieuwe Application Insights-resource met dezelfde naam als uw web-app gebruikt. U kunt ervoor kiezen om een bestaande Application Insights-resource te gebruiken of de naam te wijzigen. Selecteer Toepassen onderaan.

Azure-CLI

Als u via de Azure CLI wilt inschakelen, moet u een Application Insights-resource maken en een aantal app-instellingen instellen in Azure Portal om Application Insights te verbinden met uw web-app.

1. De Application Insights-extensie inschakelen

   az extension add -n application-insights
   

2. Maak een Application Insights-resource met behulp van de volgende CLI-opdracht. Vervang de tijdelijke aanduidingen door de gewenste resourcenaam en -groep.

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

   Noteer de waarden voor connectionString en instrumentationKeyu hebt deze waarden nodig in de volgende stap.

   Notitie

   Als u een lijst met andere locaties wilt ophalen, voert u het volgende uit az account list-locations.

3. Stel de instrumentatiesleutel, verbindingsreeks en bewakingsagentversie in als app-instellingen in de web-app. Vervang <instrumentationKey> en <connectionString> door de waarden uit de vorige stap.

   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"
   

New Relic configureren

Linux

Notitie

In de nieuwste Documentatie van New Relic wordt JBoss EAP-ondersteuning tot 7.x vermeld. JBoss EAP 8.x wordt nog niet ondersteund.

1. Een NewRelic-account maken op NewRelic.com

2. Download de Java-agent van NewRelic.

3. Kopieer uw licentiesleutel. U hebt deze nodig om de agent later te configureren.

4. SSH in uw App Service-exemplaar en maak een nieuwe map /home/site/wwwroot/apm.

5. Upload de uitgepakte NewRelic Java-agentbestanden naar een map onder /home/site/wwwroot/apm. De bestanden voor uw agent moeten zich in /home/site/wwwroot/apm/newrelic bevinden.

6. Wijzig het YAML-bestand op /home/site/wwwroot/apm/newrelic/newrelic.yml en vervang de waarde van de tijdelijke aanduiding door uw eigen licentiesleutel.

7. Blader in Azure Portal naar uw toepassing in App Service en maak een nieuwe toepassingsinstelling.

   Maak een omgevingsvariabele met de naam JAVA_OPTS met de waarde -javaagent:/home/site/wwwroot/apm/newrelic/newrelic.jar.

   Maak een omgevingsvariabele met de naam CATALINA_OPTS met de waarde -javaagent:/home/site/wwwroot/apm/newrelic/newrelic.jar.

Windows

1. Een NewRelic-account maken op NewRelic.com

2. Download de Java-agent van NewRelic. Het heeft een bestandsnaam die vergelijkbaar is met newrelic-java-x.x.x.zip.

3. Kopieer uw licentiesleutel. U hebt deze nodig om de agent later te configureren.

4. SSH in uw App Service-exemplaar en maak een nieuwe map /home/site/wwwroot/apm.

5. Upload de uitgepakte NewRelic Java-agentbestanden naar een map onder /home/site/wwwroot/apm. De bestanden voor uw agent moeten zich in /home/site/wwwroot/apm/newrelic bevinden.

6. Wijzig het YAML-bestand op /home/site/wwwroot/apm/newrelic/newrelic.yml en vervang de waarde van de tijdelijke aanduiding door uw eigen licentiesleutel.

7. Blader in Azure Portal naar uw toepassing in App Service en maak een nieuwe toepassingsinstelling.

   Maak een omgevingsvariabele met de naam JAVA_OPTS met de waarde -javaagent:/home/site/wwwroot/apm/newrelic/newrelic.jar.

   Maak een omgevingsvariabele met de naam CATALINA_OPTS met de waarde -javaagent:/home/site/wwwroot/apm/newrelic/newrelic.jar.

Notitie

Als u al een omgevingsvariabele hebt, JAVA_OPTSvoegt u de -javaagent:/... optie toe aan het einde van de huidige waarde.

Notitie

Als u al een omgevingsvariabele hebt, CATALINA_OPTSvoegt u de -javaagent:/... optie toe aan het einde van de huidige waarde.

AppDynamics configureren

Linux

1. Een AppDynamics-account maken op AppDynamics.com

2. Download de Java-agent van de AppDynamics-website. De bestandsnaam is vergelijkbaar met AppServerAgent-x.x.x.xxxxx.zip

3. SSH in uw App Service-exemplaar en maak een nieuwe map /home/site/wwwroot/apm.

4. Upload de Java-agentbestanden naar een map onder /home/site/wwwroot/apm. De bestanden voor uw agent moeten zich in /home/site/wwwroot/apm/appdynamics bevinden.

5. Blader in Azure Portal naar uw toepassing in App Service en maak een nieuwe toepassingsinstelling.

   Maak een omgevingsvariabele met JAVA_OPTS de waarde -javaagent:/home/site/wwwroot/apm/appdynamics/javaagent.jar -Dappdynamics.agent.applicationName=<app-name> waar <app-name> uw App Service-naam is. Als u al een omgevingsvariabele hebt, JAVA_OPTSvoegt u de -javaagent:/... optie toe aan het einde van de huidige waarde.

   Maak een omgevingsvariabele met CATALINA_OPTS de waarde -javaagent:/home/site/wwwroot/apm/appdynamics/javaagent.jar -Dappdynamics.agent.applicationName=<app-name> waar <app-name> uw App Service-naam is. Als u al een omgevingsvariabele hebt, CATALINA_OPTSvoegt u de -javaagent:/... optie toe aan het einde van de huidige waarde.

Windows

1. Een AppDynamics-account maken op AppDynamics.com

2. Download de Java-agent van de AppDynamics-website. De bestandsnaam is vergelijkbaar met AppServerAgent-x.x.x.xxxxx.zip

3. Gebruik de Kudu-console om een nieuwe map /home/site/wwwroot/apm te maken.

4. Upload de Java-agentbestanden naar een map onder /home/site/wwwroot/apm. De bestanden voor uw agent moeten zich in /home/site/wwwroot/apm/appdynamics bevinden.

5. Blader in Azure Portal naar uw toepassing in App Service en maak een nieuwe toepassingsinstelling.

   Maak een omgevingsvariabele met JAVA_OPTS de waarde -javaagent:/home/site/wwwroot/apm/appdynamics/javaagent.jar -Dappdynamics.agent.applicationName=<app-name> waar <app-name> uw App Service-naam is. Als u al een omgevingsvariabele hebt, JAVA_OPTSvoegt u de -javaagent:/... optie toe aan het einde van de huidige waarde.

   Maak een omgevingsvariabele met CATALINA_OPTS de waarde -javaagent:/home/site/wwwroot/apm/appdynamics/javaagent.jar -Dappdynamics.agent.applicationName=<app-name> waar <app-name> uw App Service-naam is. Als u al een omgevingsvariabele hebt, CATALINA_OPTSvoegt u de -javaagent:/... optie toe aan het einde van de huidige waarde.

Datadog configureren

Linux

De configuratieopties verschillen, afhankelijk van welke Datadog-site uw organisatie gebruikt. Raadpleeg de officiële Documentatie voor Datadog-integratie voor Azure

Windows

De configuratieopties verschillen, afhankelijk van welke Datadog-site uw organisatie gebruikt. Raadpleeg de officiële Documentatie voor Datadog-integratie voor Azure

Dynatrace configureren

Linux

Dynatrace biedt een Azure Native Dynatrace-service. Raadpleeg de officiële Dynatrace voor Azure-documentatie voor het bewaken van Azure-app Services met behulp van Dynatrace

Windows

Dynatrace biedt een Azure Native Dynatrace-service. Raadpleeg de officiële Dynatrace voor Azure-documentatie voor het bewaken van Azure-app Services met behulp van Dynatrace

Volgende stappen

Ga naar het Azure voor Java-ontwikkelaarscentrum om azure-snelstartgidsen, zelfstudies en Java-referentiedocumentatie te vinden.

• Veelgestelde vragen over App Service Linux
• Naslaginformatie over omgevingsvariabelen en app-instellingen