Instalar o agente Java no ambiente flexível GAE

Esta página aborda a instalação do agente Java da New Relic em um ambiente flexível do Google App Engine (GAE) usando um tempo de execução personalizado do Docker.

Compatibilidade e requisitos

Suportado

• Java 8, 11, 17, 21, 24, 25 e 26 (Java 7 suportado apenas no agente v6.5.4 e anteriores)
• Ambiente flexível do Google App Engine com um tempo de execução personalizado do Docker
• Consulte a compatibilidade e os requisitos para ver os intervalos de versões de framework e biblioteca suportados

Não suportado

• Ambiente padrão GAE — requer um runtime personalizado; o ambiente padrão não oferece suporte a ele
• Modo nativo GAE — o agente Java requer um runtime personalizado
• Execução em conjunto com outros agentes APM — o agente Java não pode garantir o comportamento correto quando outro agente APM está ativo na mesma JVM

Você precisa

• Uma conta New Relic echave de licença
• Uma JVM com suporte a SSL SHA-2 (256 bits)
• Um projeto do Google Cloud Platform com um aplicativo do App Engine criado (consulte os procedimentos do Google App Engine para Java)
• A CLI do gcloud instalada e inicializada (consulte a documentação do SDK do Google Cloud)
• Maven ou Gradle com o plug-in do App Engine configurado

Instalar

Faça o download de newrelic-java.zip e descompacte-o em seu projeto: [#install-step-1]

$
curl -O https://download.newrelic.com/newrelic/java-agent/newrelic-agent/current/newrelic-java.zip
$
unzip newrelic-java.zip

Configure o seu app.yaml para um runtime personalizado:

runtime: custom
env: flex

Configure seu Dockerfile para adicionar o agente e passar o argumento -javaagent. O exemplo abaixo usa o Tomcat:

ADD ./newrelic/newrelic.jar /usr/local/tomcat/newrelic/newrelic.jar
ENV JAVA_OPTS="$JAVA_OPTS -javaagent:/usr/local/tomcat/newrelic/newrelic.jar"

Construa o seu projeto:

$
mvn clean install

Configurar

Edite newrelic/newrelic.yml e defina os dois valores obrigatórios:

1. Defina license_key como seu chave de licença.
2. Defina app_name como um nome significativo para seu aplicativo.

Para todas as outras opções de configuração, consulte a configuração do agente Java.

Verifique sua instalação

Implantar no GAE:

$
gcloud --project YOUR_PROJECT_NAME app deploy

Aguarde até que a implantação seja concluída. Envie pelo menos dois requests, depois aguarde 2–3 minutos e seu aplicativo aparecerá em APM & serviços.

Se nenhum dado aparecer após cinco minutos, consulte Nenhum dado aparece (Java).

Artigos relacionados

• Compatibilidade e requisitos do agente Java
• Configuração do agente Java
• Documentação do Google App Engine para Java