Configurar plataformas do APM para aplicativos Tomcat, JBoss ou Java SE no Serviço de Aplicativo do Azure
Este artigo mostra como conectar aplicativos Java implantados no Serviço de Aplicativo do Azure com as plataformas de monitoramento de desempenho de aplicativos (APM) Application Insights do Azure Monitor, NewRelic e AppDynamics.
O Serviço de Aplicativo do Azure executa aplicativos Web Java em um serviço totalmente gerenciado em três variantes:
- Java SE – pode executar um aplicativo implantado como um pacote JAR que contém um servidor inserido (como Spring Boot, Dropwizard, Quarkus ou um com um servidor Tomcat ou Jetty inserido).
- Tomcat – O servidor Tomcat interno pode executar um aplicativo implantado como um pacote WAR.
- JBoss EAP: Suporte apenas para aplicativos Linux nos níveis de preços Gratuito, Premium v3 e Isolado v2. O servidor JBoss EAP interno pode executar um aplicativo implantado como um pacote WAR ou EAR.
Observação
Para aplicativos Spring, é recomendável usar o Aplicativos Spring do Azure. No entanto, você ainda pode usar o Serviço de Aplicativo do Azure como um destino. Consulte Diretrizes de Destino da Carga de Trabalho Java para obter orientação.
Configurar o Application Insights
O Application Insights do Azure Monitor é um serviço de monitoramento de aplicativo nativo de nuvem que permite que os clientes observem falhas, gargalos e padrões de uso para melhorar o desempenho do aplicativo e reduzir o tempo médio de resolução (MTTR). Com alguns cliques ou comandos da CLI, você pode habilitar o monitoramento para os aplicativos Node.js ou Java, logs de coleta automática, métricas e rastreamentos distribuídos, eliminando a necessidade de incluir um SDK no aplicativo. Confira a documentação do Application Insights para obter mais informações sobre as configurações de aplicativo disponíveis para configurar o agente.
Para habilitar o Application Insights no portal do Azure, acesse o Application Insights no menu à esquerda e selecione Ativar o Application Insights. Por padrão, é usado um novo recurso do Application Insights com o mesmo nome que o aplicativo Web. Você pode optar por usar um recurso existente do Application Insights ou alterar o nome. Por fim, selecione Aplicar na parte inferior.
Configurar o New Relic
Observação
A documentação do New Relic mais recente lista o suporte ao JBoss EAP até 7.x. O JBoss EAP 8.x ainda não tem suporte.
Criar uma conta de NewRelic em NewRelic.com
Copie sua chave de licença, você precisará dela para configurar o agente mais tarde.
SSH em sua instância do Serviço de Aplicativo e crie um diretório /home/site/wwwroot/apm.
Carregue os arquivos do agente NewRelic Java descompactados em um diretório em /home/site/wwwroot/apm. Os arquivos do seu agente devem estar em /home/site/wwwroot/apm/newrelic.
Modifique o arquivo YAML em /home/site/wwwroot/apm/newrelic/newrelic.yml e substitua o valor de licença de espaço reservado pela sua chave de licença.
No portal do Azure, navegue até seu aplicativo no serviço de aplicativo e criar uma nova configuração de aplicativo.
Crie uma variável de ambiente chamada
JAVA_OPTS
com o valor-javaagent:/home/site/wwwroot/apm/newrelic/newrelic.jar
.Crie uma variável de ambiente chamada
CATALINA_OPTS
com o valor-javaagent:/home/site/wwwroot/apm/newrelic/newrelic.jar
.
Observação
Se você já tiver uma variável de ambiente para JAVA_OPTS
, acrescente a opção -javaagent:/...
ao final do valor atual.
Observação
Se você já tiver uma variável de ambiente para CATALINA_OPTS
, acrescente a opção -javaagent:/...
ao final do valor atual.
Configurar o AppDynamics
Criar uma conta do AppDynamics em AppDynamics.com
Faça download do agente Java no site da AppDynamics. O nome do arquivo é semelhante a AppServerAgent-x.x.x.xxxxx.zip
SSH em sua instância do Serviço de Aplicativo e crie um diretório /home/site/wwwroot/apm.
Carregue os arquivos do agente de Java descompactados em um diretório em /home/site/wwwroot/apm. Os arquivos do seu agente devem estar em /home/site/wwwroot/apm/appdynamics.
No portal do Azure, navegue até seu aplicativo no serviço de aplicativo e criar uma nova configuração de aplicativo.
Crie uma variável de ambiente chamada
JAVA_OPTS
com o valor-javaagent:/home/site/wwwroot/apm/appdynamics/javaagent.jar -Dappdynamics.agent.applicationName=<app-name>
em que<app-name>
é o nome do Serviço de Aplicativo. Se você já tiver uma variável de ambiente paraJAVA_OPTS
, acrescente a opção-javaagent:/...
ao final do valor atual.Crie uma variável de ambiente chamada
CATALINA_OPTS
com o valor-javaagent:/home/site/wwwroot/apm/appdynamics/javaagent.jar -Dappdynamics.agent.applicationName=<app-name>
em que<app-name>
é o nome do Serviço de Aplicativo. Se você já tiver uma variável de ambiente paraCATALINA_OPTS
, acrescente a opção-javaagent:/...
ao final do valor atual.
Configurar o Datadog
As opções de configuração serão diferentes dependendo do site do Datadog que sua organização estiver usando. Consulte a Documentação da Integração Datadog para Azure oficial
Configurar o Dynatrace
O Dynatrace fornece um Serviço Dynatrace Nativo do Azure. Para monitorar os Serviços de Aplicativos do Azure usando o Dynatrace, consulte a Documentação do Dynatrace para Azure oficial
Próximas etapas
Acesse a central para Desenvolvedores do Azure para Java para conferir inícios rápidos, tutoriais e documentação de referência do Java.