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

Cet article explique comment connecter des applications Java déployées sur Azure App Service à des plateformes de surveillance des performances des applications Azure Monitor, New Relic et AppDynamics.

Azure App Service exécute des applications web Java en trois types sur un service entièrement managé :

  • Java Standard Edition (SE). Java SE peut exécuter une application déployée en tant que package d’archive Java (JAR) qui contient un serveur incorporé, tel que Spring Boot, Bézierus, Dropwizard ou une application 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 (Web Application Archive).
  • JBoss Enterprise Application Platform (EAP) : le serveur JBoss EAP intégré peut exécuter une application déployée en tant que package WAR ou enterprise archive (EAR). Cette option est prise en charge pour les applications Linux dans un ensemble de niveaux tarifaires incluant Free, Premium v3 et Isolé v2.

Remarque

JBoss EAP sur App Service prend désormais en charge la facturation BYOL (Bring Your Own License). BYOL permet aux clients disposant d’abonnements Red Hat existants d’appliquer ces licences directement à leurs déploiements JBoss EAP sur Azure App Service. Pour plus d’informations, consultez le soutien BYOL pour JBoss EAP sur App Service.

Configurer Application Insights

Azure Monitor Application Insights est un service de supervision des applications natives cloud. Il vous permet d’observer des défaillances, des goulots d’étranglement et des modèles d’utilisation pour améliorer les performances de l’application et réduire le temps moyen de résolution (MTTR). Vous pouvez activer la surveillance de vos applications Node.js ou Java, en collectant automatiquement les journaux, les métriques et les traces distribuées. Application Insights élimine 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, dans le menu de gauche, sélectionnez Surveillance>d’Application Insights. 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

Pour 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 New Relic à NewRelic.com.

  2. Téléchargez l’agent Java à partir 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 New Relic 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 sur /home/site/wwwroot/apm/newrelic/newrelic.yml. Remplacez la valeur de l'espace réservé par votre 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

Pour configurer AppDynamics :

  1. Créez un compte AppDynamics à 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><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><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 de Dynatrace pour Azure.

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.