Configurar plataformas APM para aplicativos Tomcat, JBoss ou Java SE no Serviço de Aplicativo do Azure

Este artigo mostra como ligar aplicações Java implementadas no Azure App Service com as plataformas Azure Monitor Application Insights, New Relic e AppDynamics Application Performance Monitoring (APM).

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

  • Java Standard Edition (SE). O Java SE pode executar uma aplicação implementada como um pacote Java archive (JAR) que contenha um servidor embutido, como Spring Boot, Quarkus, Dropwizard, ou uma aplicação com um servidor Tomcat ou Jetty embutido.
  • Tomcat. O servidor Tomcat incorporado pode executar uma aplicação implementada como um pacote de arquivo de aplicações web (WAR).
  • JBoss Enterprise Application Platform (EAP): O servidor JBoss EAP integrado pode executar um aplicativo implantado como um pacote WAR ou Enterprise Archive (EAR). Esta opção é suportada para aplicações Linux num conjunto de preços que incluem Free, Premium v3 e Isolated v2.

Nota

O JBoss EAP no App Service agora suporta a cobrança de Bring Your Own License (BYOL). O BYOL permite que os clientes que já têm subscrições Red Hat apliquem essas licenças diretamente às suas implementações JBoss EAP no Azure App Service. Para mais informações, consulte o Suporte BYOL para JBoss EAP no App Service.

Configurar o Application Insights

O Azure Monitor Application Insights é um serviço nativo de monitorização de aplicações na cloud. Permite-lhe observar falhas, gargalos e padrões de utilização para melhorar o desempenho da aplicação e reduzir o tempo médio até à resolução (MTTR). Pode ativar a monitorização das suas aplicações Node.js ou Java, recolhendo automaticamente logs, métricas e rastreios distribuídos. O Application Insights elimina 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.

Para ativar o Application Insights a partir do portal do Azure, no menu à esquerda, selecione Monitorização>Application Insights. Selecione Ativar Application Insights.

Por padrão, é utilizado um novo recurso de Application Insights com o mesmo nome da sua aplicação web. Pode optar por usar um recurso existente do Application Insights ou alterar o nome. Selecione Aplicar na parte inferior.

Configurar Nova Relíquia

Para configurar a Nova Relíquia:

Nota

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

  1. Crie uma nova conta Relic no NewRelic.com.

  2. Descarregue o agente Java do New Relic.

  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. Carregue os ficheiros do agente Java do New Relic 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. Modifica o ficheiro YAML em /home/site/wwwroot/apm/newrelic/newrelic.yml. Substitui o valor provisório da licença pela chave da tua 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

Para configurar o AppDynamics:

  1. Crie uma conta AppDynamics no AppDynamics.com.

  2. Faça o download do agente Java a partir do website da AppDynamics. O nome do ficheiro é semelhante ao 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.

Configurar Datadog

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

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

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