Instale New Relic agente de Java en el entorno flexible GAE

Con el agente de Java de APM, puede monitor aplicaciones que residen en el entorno flexible de Google App Engine (GAE). Agregar New Relic a su aplicación GAE flex le brinda información valiosa sobre el estado y el rendimiento de su aplicación y amplía GAE con métricas que puede ver en APM, monitoreo de browsery el panel.

Este documento explica cómo agregar New Relic a su aplicación GAE flex configurando un tiempo de ejecución personalizado y brinda un ejemplo de cómo implementar una aplicación Tomcat con docker.

Cree un tiempo de ejecución personalizado usando Docker

Consulte la documentación de Google para crear tiempos de ejecución personalizados. Hay muchas formas de crear un tiempo de ejecución personalizado que contenga el agente de Java New Relic (por ejemplo, usando Tomcat). En general, para crear un tiempo de ejecución personalizado:

1. Configure su aplicación e instale la dependencia necesaria relacionada con GAE para tiempos de ejecución personalizados. Incluya el agente de Java New Relic en el proyecto.

2. Configure Maven o Gradle según corresponda.

3. Configure el archivoapp.yaml .

4. Configure el Dockerfile.

5. Construya la imagen de Docker.

6. desplegar la imagen de Docker en el entorno flexible GAE inicializado.

7. Recommendation:

   Deshabilite las comprobaciones de estado de GAE.

Para obtener más información sobre cómo implementar y configurar su aplicación Java en el entorno flexible GAE, consulte:

• Documentación de Google App Engine para Java
• Tutoriales de Google App Engine para desplegar una aplicación Java

Ejemplo flexible de GAE con Tomcat

Este ejemplo describe cómo agregar New Relic a su aplicación GAE flex instalando el agente de Java New Relic, creando un tiempo de ejecución personalizado y implementando una aplicación WAR en Tomcat. Asegúrese de instalar el agente de Java según sea necesario para su servidor de aplicaciones 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 .

Recomendación: deshabilite los controles de salud

Google App Engine envía solicitudes periódicas de verificación de estado para confirmar que una instancia se ha implementado correctamente y para comprobar que una instancia en ejecución mantiene un estado saludable. Una verificación de estado es una solicitud HTTP a la URL /_ah/health.

Si crea un tiempo de ejecución personalizado, su aplicación debe poder manejar una gran cantidad de solicitudes de verificación de estado. De lo contrario, es posible que los datos de su aplicación no se muestren correctamente en APM. Para evitar agregar sobrecarga de instrumentación adicional y distorsionar el rendimiento de su aplicación, le recomendamos que deshabilite la verificación de estado.

Recommendation: Configure su app.yaml para deshabilitar las comprobaciones de estado agregando:

health_check:
  enable_health_check: False

Obtener agente de Java log de resolución de problemas de GAE

Utilice estos recursos para solucionar problemas de su aplicación de entorno flexible GAE:

• Para conectarse a la instancia GAE e iniciar un shell en el contenedor docker que ejecuta su código, consulte Depurar una instancia.

• Para redirigir el registro del agente de Java de New Relic a Stackdriver en la consola de la plataforma Cloud, cambie el archivo newrelic.ymla:

  log_file_name: STDOUT

  Copia

• Para ver el registro, utilice el Visor de log de la Consola de Cloud plataforma.