Configurar plataformas 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 Azure Monitor Application Insights, NewRelic e AppDynamics Application Performance Monitoring (APM).

O Azure App Service executa aplicações web Java num serviço totalmente gerido em três variantes:

• Java Standard Edition (SE): Pode executar um aplicativo implantado como um pacote Java Archive (JAR) que contém um servidor incorporado (como Spring Boot, Quarkus, Dropwizard ou um aplicativo com um servidor Tomcat ou Jetty incorporado).
• Tomcat: O servidor Tomcat integrado pode executar um aplicativo implantado como um pacote WAR (Web Application Archive).
• JBoss Enterprise Application Platform (EAP): O servidor JBoss EAP integrado pode executar um aplicativo implantado como um pacote WAR ou Enterprise Archive (EAR). Suportado para aplicativos Linux em um conjunto de níveis de preços que inclui Free, Premium v3 e Isolated v2.gti

Configurar o Application Insights

Azure Monitor Application Insights é um serviço de monitorização de aplicações nativo da cloud que permite aos clientes observar falhas, gargalos e padrões de uso para melhorar o desempenho das aplicações e reduzir o tempo médio de resolução (MTTR). Com alguns cliques ou comandos CLI, pode ativar a monitorização para as suas aplicações Node.js ou Java, recolhendo automaticamente logs, métricas, e rastreamentos distribuídos, eliminando a necessidade de incluir um SDK na sua aplicação. Para obter mais informações sobre as configurações de aplicativo disponíveis para configurar o agente, consulte a documentação do Application Insights.

portal do Azure

Para habilitar o Application Insights no portal do Azure, vá para Application Insights no menu do lado esquerdo e selecione Ativar Application Insights. Por padrão, um novo recurso do Application Insights com o mesmo nome do seu aplicativo Web é usado. Pode optar por utilizar um recurso existente do Application Insights ou alterar o nome. Selecione Aplicar na parte inferior.

Azure CLI

Para ativar através do Azure CLI, é necessário criar um recurso do Application Insights e definir algumas configurações de aplicação no portal do Azure para conectar o Application Insights à sua aplicação web.

1. Ativar a extensão Application Insights

   az extension add -n application-insights
   

2. Crie um recurso do Application Insights usando o seguinte comando CLI. Substitua os espaços reservados pelo nome de recurso e grupo desejados.

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

   Anote os valores de connectionString e instrumentationKey, vai precisar destes valores na próxima etapa.

   Nota

   Para recuperar uma lista de outras localizações, execute az account list-locations.

3. Defina a chave de instrumentação, a string de conexão e a versão do agente de monitorização como definições da aplicação na aplicação web. Substitua <instrumentationKey> e <connectionString> com os valores do passo anterior.

   Aplicações 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"
   

   Mac OS

   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 Nova Relíquia

Aplicações Linux

Nota

A documentação mais recente da New Relic lista o suporte ao JBoss EAP até a versão 7.x. JBoss EAP 8.x ainda não é suportado.

1. Crie uma conta NewRelic no NewRelic.com

2. Descarregar o agente Java da NewRelic.

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

4. Faça SSH na sua instância do App Service e crie um novo diretório /home/site/wwwroot/apm.

5. Transfira os ficheiros do agente Java NewRelic descompactados para um diretório em /home/site/wwwroot/apm. Os ficheiros para o 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 de espaço reservado por sua própria chave de licença.

7. No portal do Azure, navegue para a sua aplicação no App Service e crie uma nova Configuração de Aplicação.

   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.

Mac OS

1. Crie uma conta NewRelic no NewRelic.com

2. Transfira o agente Java da NewRelic. Tem um nome de ficheiro semelhante a newrelic-java-x.x.x.zip.

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

4. Faça SSH na sua instância do App Service e crie um novo diretório /home/site/wwwroot/apm.

5. Transfira os ficheiros do agente Java NewRelic descompactados para um diretório em /home/site/wwwroot/apm. Os ficheiros para o 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 de espaço reservado por sua própria chave de licença.

7. No portal do Azure, navegue para a sua aplicação no App Service e crie uma nova Configuração de Aplicação.

   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.

Nota

Se já tiver uma variável de ambiente para JAVA_OPTS, acrescente a opção -javaagent:/... ao final do valor atual.

Nota

Se já tiver uma variável de ambiente para CATALINA_OPTS, acrescente a opção -javaagent:/... ao final do valor atual.

Configurar AppDynamics

Aplicações Linux

1. Crie uma conta do AppDynamics no AppDynamics.com

2. Faça o download do agente Java a partir do website da AppDynamics. O nome do ficheiro é semelhante a AppServerAgent-x.x.x.xxxxx.zip

3. Faça SSH na sua instância do App Service e crie um novo diretório /home/site/wwwroot/apm.

4. Carregue os ficheiros do agente Java num diretório em /home/site/wwwroot/apm. Os ficheiros para o seu agente devem estar em /home/site/wwwroot/apm/appdynamics.

5. No portal do Azure, navegue para a sua aplicação no App Service e crie uma nova Configuração de Aplicação.

   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> onde <app-name> é o nome do seu App Service. Se 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> onde <app-name> é o nome do seu App Service. Se já tiver uma variável de ambiente para CATALINA_OPTS, acrescente a opção -javaagent:/... ao final do valor atual.

Mac OS

1. Crie uma conta do AppDynamics no AppDynamics.com

2. Faça o download do agente Java a partir do website da AppDynamics. O nome do ficheiro é semelhante a AppServerAgent-x.x.x.xxxxx.zip

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

4. Carregue os ficheiros do agente Java num diretório em /home/site/wwwroot/apm. Os ficheiros para o seu agente devem estar em /home/site/wwwroot/apm/appdynamics.

5. No portal do Azure, navegue para a sua aplicação no App Service e crie uma nova Configuração de Aplicação.

   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> onde <app-name> é o nome do seu App Service. Se 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> onde <app-name> é o nome do seu App Service. Se já tiver uma variável de ambiente para CATALINA_OPTS, acrescente a opção -javaagent:/... ao final do valor atual.

Configurar Datadog

Aplicações Linux

As opções de configuração são diferentes dependendo de qual site Datadog sua organização está usando. Veja a documentação oficial Datadog Integration for Azure

Mac OS

As opções de configuração são diferentes dependendo de qual site Datadog sua organização está usando. Veja a documentação oficial Datadog Integration for Azure

Configurar o Dynatrace

Aplicações Linux

A Dynatrace oferece um Serviço Dynatrace Nativo para Azure. Para monitorizar os Serviços de Aplicações do Azure usando o Dynatrace, consulte a documentação oficial do Dynatrace para Azure

Mac OS

A Dynatrace oferece um Serviço Dynatrace Nativo para Azure. Para monitorizar os Serviços de Aplicações do Azure usando o Dynatrace, consulte a documentação oficial do Dynatrace para Azure

Próximos passos

Visite o centro Azure para Programadores Java para encontrar inícios rápidos do Azure, tutoriais e documentação de referência Java.

• Perguntas Frequentes sobre o App Service Linux
• Referência de variáveis de ambiente e configurações de aplicativo