Installer l'agent Python dans l'environnement flexible GAE

Avec l'agent Python, vous pouvez monitorer les applications qui résident dans l'environnement flexible de Google App Engine (GAE) . L'ajout de agent données à 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 l'UI New Relic.

Ce document explique comment ajouter des données d'agent à votre application GAE flex en utilisant l'une de ces méthodes :

• « mode natif » de Google App Engine installation avec un environnement d'exécution GAE standard
• Docker installation à l'aide d'un environnement d'exécution personnalisé

déployer en utilisant le support natif de GAE

Lorsque vous utilisez l'installation en « mode natif » de Google App Engine, vous fournissez le code de votre application et un fichier app.yaml . Google App Engine s'affiche ensuite sur une image Docker standard prédéfinie.

Par exemple, pour déployer avec la prise en charge native d'une application Flask/Django :

1. Suivez les procédures standard pour installer l'agent Python, y compris votre clé de licence.
2. Définissez NEW_RELIC_CONFIG_FILE comme variable d’environnement pointant vers newrelic.ini.

Une fois agent l'configuration et le fichier installés, l'agent Python peut monitorer automatiquement les applications qui résident dans l'environnement flexible GAE. Attendez que le déploiement soit terminé, puis affichez les données de votre application GAE Flex dans la page Résumé APM.

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. Cet exemple décrit comment ajouter des données d'agent à votre application GAE flex en créant un environnement d'exécution personnalisé pour Docker.

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

• Nos exemples GAE flex sur Github pour Python
• Documentation de Google App Engine pour Python
• Tutoriels de Google App Engine pour déployer une application Python

env: flex
runtime: custom

# [START dockerfile]
FROM gcr.io/google_appengine/python

# Install the fortunes binary from the debian repositories.
RUN apt-get update && apt-get install -y fortunes

# Optional: Change the -p argument to use a particular version of Python.
RUN virtualenv /env -p python3.9

# Set virtualenv environment variables. This is equivalent to running
# source /env/bin/activate.
ENV VIRTUAL_ENV /env
ENV PATH /env/bin:$PATH

ADD requirements.txt /app/
RUN pip install -r requirements.txt
ADD . /app/

CMD NEW_RELIC_CONFIG_FILE=newrelic.ini newrelic-admin run-program gunicorn -b :$PORT main:app
# [END dockerfile]

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.

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

health_check:
  enable_health_check: False

Obtenir le log de dépannage agent 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 Python agent le log vers Stackdriver dans la console de la plateforme Cloud, ajoutez l'instruction suivante à la newrelic.ini configuration:

  log_file = stderr

  Copier

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