Configuración de plataformas de APM para aplicaciones Tomcat, JBoss o Java SE en Azure App Service
En este artículo se muestra cómo conectar aplicaciones Java implementadas en Azure App Service con las plataformas de supervisión de aplicaciones (APM) Azure Monitor Application Insights, NewRelic y AppDynamics.
Azure App Service ejecuta aplicaciones web Java en un servicio totalmente administrado en tres variantes:
- Java SE: puede ejecutar una aplicación implementada como un paquete JAR que contenga un servidor incrustado (como Spring Boot, Dropwizard, Quarkus o uno con un servidor de Tomcat o Jetty incrustado).
- Tomcat: el servidor de Tomcat integrado puede ejecutar una aplicación implementada como un paquete WAR.
- JBoss EAP: admitido para aplicaciones Linux en los niveles de precios, Premium v3 y Aislado v2. El servidor JBoss EAP integrado puede ejecutar una aplicación implementada como un paquete WAR o EAR.
Configuración de Application Insights
Azure Monitor Application Insights es un servicio de supervisión de aplicaciones nativo de la nube que permite a los clientes observar errores, cuellos de botella y patrones de uso para mejorar el rendimiento de la aplicación y reducir el tiempo medio de resolución (MTTR). Con unos pocos clics o comandos de la CLI, puede habilitar la supervisión de las aplicaciones Node.js o Java y recopilar automáticamente registros, métricas y seguimientos distribuidos, lo que elimina la necesidad de incluir un SDK en la aplicación. Para obtener más información sobre la configuración de la aplicación disponible para configurar el agente, consulte la documentación de Application Insights.
Para habilitar Application Insights desde Azure Portal, vaya a Application Insights en el menú de la izquierda y seleccione Activar Application Insights. De forma predeterminada, se usa un nuevo recurso de Application Insights con el mismo nombre que la aplicación web. Puede optar por usar un recurso de Application Insights existente o cambiar el nombre. Seleccione Aplicar en la parte inferior.
Configuración de New Relic
Nota:
La documentación de New Relic más reciente enumera la compatibilidad con JBoss EAP hasta 7.x. JBoss EAP 8.x aún no se admite.
Cree una cuenta de NewRelic en NewRelic.com.
Copie la clave de licencia, ya que la necesitará más tarde para configurar el agente.
Conéctese mediante SSH a su instancia de App Service y cree un nuevo directorio /home/site/wwwroot/apm.
Cargue los archivos desempaquetados del agente de Java de NewRelic en un directorio de /home/site/wwwroot/apm. Los archivos del agente deben estar en /home/site/wwwroot/apm/newrelic.
Modifique el archivo YAML en /home/site/wwwroot/apm/newrelic/newrelic.yml y reemplace el marcador de posición de valor de la licencia por su propia clave de licencia.
En Azure Portal, vaya a la aplicación en App Service y cree una nueva configuración de la aplicación.
Cree una variable de entorno llamada
JAVA_OPTS
con el valor-javaagent:/home/site/wwwroot/apm/newrelic/newrelic.jar
.Cree una variable de entorno llamada
CATALINA_OPTS
con el valor-javaagent:/home/site/wwwroot/apm/newrelic/newrelic.jar
.
Nota:
Si ya tiene una variable de entorno para JAVA_OPTS
, anexe la opción -javaagent:/...
al final del valor actual.
Nota:
Si ya tiene una variable de entorno para CATALINA_OPTS
, anexe la opción -javaagent:/...
al final del valor actual.
Configuración de AppDynamics
Cree una cuenta de AppDynamics en AppDynamics.com.
Descargue el agente de Java desde el sitio web de AppDynamics. El nombre de archivo es similar a AppServerAgent-x.x.x.xxxxx.zip
Conéctese mediante SSH a su instancia de App Service y cree un nuevo directorio /home/site/wwwroot/apm.
Cargue los archivos del agente de Java en un directorio de /home/site/wwwroot/apm. Los archivos del agente deben estar en /home/site/wwwroot/apm/appdynamics.
En Azure Portal, vaya a la aplicación en App Service y cree una nueva configuración de la aplicación.
Cree una variable de entorno llamada
JAVA_OPTS
con el valor-javaagent:/home/site/wwwroot/apm/appdynamics/javaagent.jar -Dappdynamics.agent.applicationName=<app-name>
, donde<app-name>
es el nombre de su instancia de App Service. Si ya tiene una variable de entorno paraJAVA_OPTS
, anexe la opción-javaagent:/...
al final del valor actual.Cree una variable de entorno llamada
CATALINA_OPTS
con el valor-javaagent:/home/site/wwwroot/apm/appdynamics/javaagent.jar -Dappdynamics.agent.applicationName=<app-name>
, donde<app-name>
es el nombre de su instancia de App Service. Si ya tiene una variable de entorno paraCATALINA_OPTS
, anexe la opción-javaagent:/...
al final del valor actual.
Configuración de Datadog
Las opciones de configuración son diferentes en función del sitio de Datadog que use su organización. Consulte la documentación oficial sobre la integración de Datadog para Azure.
Configuración de Dynatrace
Dynatrace proporciona un servicio Azure Native Dynatrace. Para supervisar Azure App Services mediante Dynatrace, consulte la documentación oficial de Dynatrace para Azure.
Pasos siguientes
Visite el centro de Azure para desarrolladores de Java para encontrar guías de inicio rápido de Azure, tutoriales y documentación de referencia de Java.