Instale o agente Java do New Relic no ambiente flexível do GAE

Com o agente Java do APM, você pode monitor aplicativos que residem no ambiente flexível do Google App Engine (GAE). Adicionar o New Relic ao seu aplicativo flexível do GAE fornece insights sobre a integridade e o desempenho do seu aplicativo e estende o GAE com métricas que você pode visualizar em APM, monitoramento de browsere painel.

Este documento explica como adicionar New Relic ao seu aplicativo GAE flex configurando um tempo de execução personalizado e fornece um exemplo de implantação de um aplicativo Tomcat com Docker.

Crie um tempo de execução personalizado usando docker

Consulte a documentação do Google para criar tempos de execução personalizados. Há muitas maneiras de criar um tempo de execução personalizado que contenha o agente Java New Relic (por exemplo, usando o Tomcat). Em geral, para construir um tempo de execução personalizado:

1. Configure seu aplicativo e instale a dependência necessária relacionada ao GAE para tempos de execução personalizados. Inclua o agente Java New Relic no projeto.
2. Configure Maven ou Gradle conforme aplicável.
3. Configure o arquivoapp.yaml .
4. Configure o Dockerfile.
5. Construa a imagem do Docker.
6. implantar a imagem Docker no ambiente flexível GAE inicializado.
7. Recomendação: Desative as verificações de integridade do GAE.

Para obter mais informações sobre como implantar e configurar seu aplicativo Java no ambiente flexível do GAE, consulte:

• Documentação do Google App Engine para Java
• Tutoriais do Google App Engine para implantar um aplicativo Java

Exemplo flexível do GAE com Tomcat

Este exemplo descreve como adicionar o New Relic ao seu aplicativo GAE flex instalando o agente Java do New Relic, criando um tempo de execução personalizado e implantando um aplicativo WAR no Tomcat. Certifique-se de instalar o agente Java conforme necessário para seu servidor de aplicativos específico.

env: flex
runtime: custom

# base Tomcat image to build Docker image from
FROM tomcat:8.5.14-jre8

MAINTAINER Jane Doe <janedoe@mail.com>

# Tomcat directory to copy Java agent files to
ENV NEWRELIC_HOME /usr/local/tomcat/newrelic

# copy application war from target to Tomcat webapps
ADD target/*.war /usr/local/tomcat/webapps

# copy Java agent files from target to Tomcat NEWRELIC_HOME
ADD target/newrelic ${NEWRELIC_HOME}

# update Java agent yml with license_key and app_name and copy to image  
ADD newrelic.yml ${NEWRELIC_HOME}

# update catalina.sh with -javaagent:/path/to/newrelic.jar and copy to image 
ADD catalina.sh /usr/local/tomcat/bin/

$
docker build -f Dockerfile -t newrelic-tomcat .

Recomendação: desativar verificações de integridade

O Google App Engine envia solicitações periódicas de verificação de integridade para confirmar se uma instância foi implantada com êxito e para verificar se uma instância em execução mantém um status de integridade. Uma verificação de integridade é uma solicitação HTTP para o URL /_ah/health.

Se você criar um ambiente de execução personalizado, seu aplicativo deverá ser capaz de lidar com um grande número de solicitações de verificação de integridade. Caso contrário, os dados do seu aplicativo poderão não ser exibidos corretamente no APM. Para evitar adicionar sobrecarga adicional de instrumentação e distorcer as taxas de transferência para seu aplicativo, recomendamos que você desative a verificação de integridade.

Recomendação: configure seu app.yaml para desativar verificações de integridade adicionando:

health_check:
  enable_health_check: False

Obtenha o log de resolução de problemas do agente Java do GAE

Use estes recursos para solucionar problemas do seu aplicativo de ambiente flexível do GAE:

• Para se conectar à instância do GAE e iniciar um shell no contêiner Docker executando seu código, consulte Depurando uma instância.

• Para redirecionar o registro do agente Java do New Relic para o Stackdriver no Cloud Platform Console, altere o arquivo newrelic.ymlpara:

  log_file_name: STDOUT

  Copiar

• Para visualizar o log, use o log Viewer do Cloud Platform Console.