Partager via

Configurer des plateformes APM pour des applications Tomcat, JBoss ou Java SE dans Azure App Service

  • Article

Cette article explique comment connecter des applications Java déployées sur Azure App Service avec Azure Monitor Application Insights, NewRelic et des plateformes APM AppDynamics.

Azure App Service exécute des applications web Java sur un service complètement géré en trois variantes :

  • Java SE : peut exécuter une application déployée en tant que package JAR qui contient un serveur incorporé (par exemple Spring Boot, Dropwizard, Quarkus ou avec un serveur Tomcat ou Jetty incorporé).
  • Tomcat : le serveur Tomcat intégré peut exécuter une application déployée en tant que package WAR.
  • JBoss EAP – Pris en charge pour les applications Linux seulement dans les niveaux de tarification Gratuit, Premium v3 et Isolé v2. Le serveur JBoss EAP intégré peut exécuter une application déployée en tant que package WAR ou EAR.

Remarque

Pour les applications Spring, nous vous recommandons d’utiliser Azure Spring Apps. Toutefois, vous pouvez toujours utiliser Azure App Service comme destination. Pour obtenir des conseils, consultez l’Aide de destination de la charge de travail Java.

Configurer Application Insights

Azure Monitor Application Insights est un service de surveillance des applications natif cloud, qui permet aux clients d’observer les défaillances, les goulots d’étranglement et les modèles d’utilisation pour améliorer les performances des applications et réduire le temps moyen de résolution. Quelques clics ou commandes de l’interface CLI suffisent pour activer la supervision de vos applications Node.js ou Java, journaux de collecte automatique, métriques et traces distribuées, éliminant ainsi la nécessité d’inclure un kit de développement logiciel (SDK) dans votre application. Pour plus d’informations sur les paramètres d’application disponibles pour la configuration de l’agent, consultez la documentation Application Insights.

Pour activer Application Insights à partir du portail Azure, accédez à Application Insights dans le menu de gauche, puis sélectionnez Activer Application Insights. Par défaut, une nouvelle ressource Application Insights du même nom que votre application web est utilisée. Vous pouvez choisir d’utiliser une ressource Application Insights existante ou de modifier le nom. Sélectionnez Appliquer en bas.

Configurer New Relic

Remarque

La documentation la plus récente de New Relic indique la prise en charge de JBoss EAP jusqu’à 7.x. JBoss EAP 8.x n’est pas encore pris en charge.

  1. Créez un compte NewRelic sur NewRelic.com

  2. Téléchargez l’agent Java auprès de New Relic.

  3. Copiez votre clé de licence, vous en avez besoin pour configurer l’agent par la suite.

  4. Connectez-vous avec SSH à votre instance App Service et créez un répertoire /home/site/wwwroot/apm.

  5. Chargez les fichiers de l’agent Java de NewRelic décompressés dans un répertoire sous /home/site/wwwroot/apm. Les fichiers de votre agent doivent se trouver dans /home/site/wwwroot/apm/newrelic.

  6. Modifiez le fichier YAML dans /home/site/wwwroot/apm/newrelic/newrelic.yml et remplacez la valeur de la licence d’espace réservé par votre propre clé de licence.

  7. Dans le portail Azure, accédez à votre application dans App Service et créez un paramètre d’application.

    Créez une variable d’environnement nommée JAVA_OPTS avec la valeur -javaagent:/home/site/wwwroot/apm/newrelic/newrelic.jar.

    Créez une variable d’environnement nommée CATALINA_OPTS avec la valeur -javaagent:/home/site/wwwroot/apm/newrelic/newrelic.jar.

Remarque

Si vous avez déjà une variable d’environnement pour JAVA_OPTS, ajoutez l’option -javaagent:/... à la fin de la valeur actuelle.

Remarque

Si vous avez déjà une variable d’environnement pour CATALINA_OPTS, ajoutez l’option -javaagent:/... à la fin de la valeur actuelle.

Configurer AppDynamics

  1. Créez un compte AppDynamics sur AppDynamics.com

  2. Téléchargez l’agent Java à partir du site web AppDynamics. Le nom de fichier est similaire à AppServerAgent-x.x.x.xxxxx.zip

  3. Connectez-vous avec SSH à votre instance App Service et créez un répertoire /home/site/wwwroot/apm.

  4. Chargez les fichiers de l’agent Java dans un répertoire sous /home/site/wwwroot/apm. Les fichiers de votre agent doivent se trouver dans /home/site/wwwroot/apm/appdynamics.

  5. Dans le portail Azure, accédez à votre application dans App Service et créez un paramètre d’application.

    Créez une variable d’environnement nommée JAVA_OPTS avec la valeur -javaagent:/home/site/wwwroot/apm/appdynamics/javaagent.jar -Dappdynamics.agent.applicationName=<app-name> où <app-name> est votre nom App Service. Si vous avez déjà une variable d’environnement pour JAVA_OPTS, ajoutez l’option -javaagent:/... à la fin de la valeur actuelle.

    Créez une variable d’environnement nommée CATALINA_OPTS avec la valeur -javaagent:/home/site/wwwroot/apm/appdynamics/javaagent.jar -Dappdynamics.agent.applicationName=<app-name> où <app-name> est votre nom App Service. Si vous avez déjà une variable d’environnement pour CATALINA_OPTS, ajoutez l’option -javaagent:/... à la fin de la valeur actuelle.

Configurer Datadog

Les options de configuration sont différentes selon le site Datadog que votre organisation utilise. Consultez la documentation officielle Intégration Datadog pour Azure

Configurer Dynatrace

Dynatrace fournit un service Dynatrace Azure natif. Pour surveiller Azure App Services à l’aide de Dynatrace, consultez la documentation officielle Dynatrace pour Azure

Étapes suivantes

Visitez le centre Azure pour les développeurs Java pour trouver des guides de démarrage rapide Azure, des tutoriels et la documentation de référence Java.