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

Avec l'agent Ruby 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 à l'aide de solutions telles que APMet monitoring de navigateurs.

Ce document explique comment ajouter New Relic à 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é

La méthode d'exécution personnalisée inclut un exemple de déploiement d'une application Sinatra. Si vous avez besoin d'une bibliothèque ou d'en-têtes spécifiques, New Relic recommande d'utiliser la méthode d'exécution personnalisée.

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.

Pour déployer avec la prise en charge native de Sinatra ou Rails :

1. Suivez les procédures standard de New Relic pour installer le gem, y compris votre clé de licence.
2. Installez le fichier de configuration de l'agent Ruby.

Une fois le gem et le fichier configuration installés, l'agent Ruby 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 New Relic à votre application GAE flex en créant un environnement d'exécution personnalisé pour Docker. L'exemple utilise une application Sinatra pour Ruby.

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

• Documentation de Google App Engine pour Ruby
• Tutoriels de Google App Engine pour Ruby

env: flex
runtime: custom
entrypoint: bundle exec ruby app.rb

FROM gcr.io/google-appengine/ruby:latest

$
docker build -f Dockerfile -t custom_ruby_app_container:latest .

Recommandation : Gérer 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.

New Relic vous recommande d'autoriser les contrôles de santé pour les applications Ruby afin que Google puisse vérifier que votre service est opérationnel et correctement équilibré. Toutefois, si des contrôles de santé excessifs entraînent une congestion du suivi des transactions, vous pouvez configurer l'agent Ruby pour ignorer les requests de contrôle de santé.

• Pour effectuer handle contrôles de santé, ajoutez un itinéraire pour _ah/health dans votre application.
• Pour ignore requests de vérification de l'état, définissez le paramètre de configuration rules.ignore_url_regexes dans la configuration de l'agent Ruby de l'application pour inclure '_ah/health'.

Obtenez les logs de dépannage de l'agent New Relic 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 Ruby New Relic vers Stackdriver dans la console de la plateforme Cloud, modifiez le fichier configuration newrelic.js comme suit :

  log_file_name: STDOUT

  Copier

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