Installer l'agent Java New Relic dans l'environnement flexible GAE

Avec l'agent Java d'APM, vous pouvez monitorer les applications qui résident dans l'environnement flexible de Google App Engine (GAE) . L'ajout de New Relic à votre application GAE flex vous donne des informations détaillées sur la santé et les performances de votre application et étend GAE avec des métriques que vous pouvez afficher dans APM, monitoring de navigateurset le dashboard.

Ce document explique comment ajouter New Relic à votre application GAE flex en configurant un runtime personnalisé et donne un exemple de déploiement d'une application Tomcat avec Docker.

Créer un environnement d'exécution personnalisé à l'aide de Docker

Consultez la documentation de Google pour créer des environnements d'exécution personnalisés. Il existe de nombreuses façons de créer un environnement d'exécution personnalisé contenant l'agent Java New Relic (par exemple, à l'aide de Tomcat). En général, pour créer un environnement d’exécution personnalisé :

1. Configurez votre application et installez les dépendances liées à GAE nécessaires pour les runtimes personnalisés. Inclure l'agent Java New Relic dans le projet.
2. Configurez Maven ou Gradle selon le cas.
3. Configurez le fichierapp.yaml .
4. Configurer le Dockerfile.
5. Construisez l'image Docker.
6. déployer l'image Docker dans l'environnement flexible GAE initialisé.
7. Recommandation : désactiver les contrôles de santé GAE.

Pour plus d'informations sur le déploiement et la configuration de votre application Java dans l'environnement flexible GAE, consultez :

• Documentation de Google App Engine pour Java
• Tutoriels de Google App Engine pour déployer une application Java

Exemple de GAE flex avec Tomcat

Cet exemple décrit comment ajouter New Relic à votre application GAE flex en installant l'agent Java New Relic, en créant un environnement d'exécution personnalisé et en déployant un WAR d'application sur Tomcat. Assurez-vous d’installer l’agent Java selon les besoins de votre serveur d’applications spécifique.

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 .

Recommandation : désactiver les contrôles de santé

Google App Engine envoie requestsde contrôle de santé périodiques pour confirmer qu'une instance a été déployée avec succès et pour vérifier qu'une instance en cours d'exécution conserve un état sain. Un contrôle de santé est une requête HTTP vers l'URL /_ah/health.

Si vous créez un environnement d'exécution personnalisé, votre application doit être capable de gérer un grand nombre de requests de contrôle de l'état. Dans le cas contraire, les données de votre application risquent de ne pas s’afficher correctement dans APM. Pour éviter d'ajouter une surcharge d'instrumentation supplémentaire et de fausser le débit de votre application, nous vous recommandons de désactiver le contrôle d'intégrité.

Recommandation : configurez votre app.yaml pour désactiver les contrôles de santé en ajoutant :

health_check:
  enable_health_check: False

Récupérer le log de dépannage de agent Java auprès de GAE

Utilisez ces ressources pour dépanner votre application d'environnement flexible GAE :

• Pour vous connecter à l'instance GAE et démarrer un shell dans le conteneur Docker exécutant votre code, consultez Débogage d'une instance.

• Pour rediriger le log de l'agent Java de New Relic vers Stackdriver dans la console de la plateforme Cloud, modifiez le fichier newrelic.ymlen :

  log_file_name: STDOUT

  Copier

• Pour visualiser le log, utilisez le log Viewer de la Console de la plateforme Cloud.