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 Standard Edition (SE): pode executar um aplicativo implantado como um pacote JAR (Arquivo Java) que contém um servidor inserido (como Spring Boot, Quarkus, Dropwizard ou um aplicativo com um servidor Tomcat ou Jetty inserido).
• Tomcat: O servidor Tomcat interno pode executar um aplicativo implantado como um pacote WAR (Arquivo de Aplicativo Web).
• JBoss Enterprise Application Platform (EAP): o servidor JBoss EAP integrado pode executar um aplicativo implantado como um pacote WAR ou Arquivo Empresarial (EAR). Com suporte para aplicativos Linux em um conjunto de tipos de preços que inclui Gratuito, Premium v3 e Isolado v2.gti

Observação

O JBoss EAP no Serviço de Aplicativo agora dá suporte à cobrança "Traga sua própria licença" (BYOL), o que permite que os clientes com assinaturas existentes do Red Hat apliquem essas licenças diretamente às implantações do JBoss EAP no Serviço de Aplicativo do Azure. Saiba mais.

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.

Portal do Azure

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.

CLI do Azure

Para habilitar por meio da CLI do Azure, é necessário criar um recurso do Application Insights e definir algumas configurações de aplicativo no portal do Azure para conectar o Application Insights ao aplicativo Web.

1. Habilite a extensão do Applications Insights

   az extension add -n application-insights
   

2. Crie um recurso do Application Insights usando o seguinte comando da CLI. Substitua os marcadores de posição pelo nome e grupo do recurso desejado.

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

   Observe os valores para connectionString e instrumentationKey, você precisará desses valores na próxima etapa.

   Observação

   Para recuperar uma lista de outros locais, execute az account list-locations.

3. Defina a chave de instrumentação, a cadeia de conexão e a versão do agente de monitoramento como configurações do aplicativo no aplicativo Web. Substitua <instrumentationKey> e <connectionString> pelos valores das etapas anteriores.

   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"
   

Configurar o New Relic

Para configurar o New Relic:

Linux

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.

1. Criar uma conta de NewRelic em NewRelic.com

2. Baixe o agente Java do NewRelic.

3. Copie sua chave de licença, você precisará dela para configurar o agente mais tarde.

4. SSH em sua instância do Serviço de Aplicativo e crie um diretório /home/site/wwwroot/apm.

5. 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.

6. Modifique o arquivo YAML em /home/site/wwwroot/apm/newrelic/newrelic.yml e substitua o valor da licença no espaço reservado pela sua chave de licença.

7. No portal do Azure, navegue até seu aplicativo no App Service e crie 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.

Windows

1. Criar uma conta de NewRelic em NewRelic.com

2. Faça download do agente Java do NewRelic. Ele tem um nome de arquivo semelhante a newrelic-java-x.x.x.zip.

3. Copie sua chave de licença, você precisará dela para configurar o agente mais tarde.

4. SSH em sua instância do Serviço de Aplicativo e crie um diretório /home/site/wwwroot/apm.

5. 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.

6. Modifique o arquivo YAML em /home/site/wwwroot/apm/newrelic/newrelic.yml e substitua o valor da licença no espaço reservado pela sua chave de licença.

7. No portal do Azure, navegue até seu aplicativo no App Service e crie 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

Para configurar o AppDynamics:

Linux

1. Criar uma conta do AppDynamics em AppDynamics.com

2. Faça download do agente Java no site da AppDynamics. O nome do arquivo é semelhante a AppServerAgent-x.x.x.xxxxx.zip

3. SSH em sua instância do Serviço de Aplicativo e crie um diretório /home/site/wwwroot/apm.

4. Carregue os arquivos do agente de Java em um diretório em /home/site/wwwroot/apm. Os arquivos do seu agente devem estar em /home/site/wwwroot/apm/appdynamics.

5. No portal do Azure, navegue até seu aplicativo no App Service e crie 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 para JAVA_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 para CATALINA_OPTS, acrescente a opção -javaagent:/... ao final do valor atual.

Windows

1. Criar uma conta do AppDynamics em AppDynamics.com

2. Faça download do agente Java no site da AppDynamics. O nome do arquivo é semelhante a AppServerAgent-x.x.x.xxxxx.zip

3. Use o console do Kudu para criar um novo diretório /home/site/wwwroot/apm.

4. Carregue os arquivos do agente de Java em um diretório em /home/site/wwwroot/apm. Os arquivos do seu agente devem estar em /home/site/wwwroot/apm/appdynamics.

5. No portal do Azure, navegue até seu aplicativo no App Service e crie 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 para JAVA_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 para CATALINA_OPTS, acrescente a opção -javaagent:/... ao final do valor atual.

Configurar o Datadog

Linux

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

Windows

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 Dynatrace

Linux

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

Windows

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

Conteúdo relacionado

Acesse o centro Azure para Desenvolvedores Java para conferir introduções rápidas, tutoriais e documentação de referência do Java.

• Perguntas frequentes sobre o Serviço de Aplicativo no Linux
• Referência de variáveis de ambiente e configurações de aplicativo