Écrire des journaux d'application

Lorsqu'une requête est envoyée à votre application exécutée dans App Engine, les détails de cette dernière et de sa réponse sont automatiquement enregistrés et peuvent être visualisés dans la visionneuse de journaux Stackdriver de la console Google Cloud Platform.

Les journaux des requêtes et des applications de votre application sont collectés par un agent de journalisation Stackdriver. Reportez-vous aux règles relatives aux quotas pour connaître la stratégie de conservation des journaux et la taille maximale des entrées de journal. Si vous souhaitez stocker vos journaux pendant une période plus longue, vous pouvez les exporter vers Cloud Storage. Vous pouvez également exporter vos journaux vers BigQuery et Pub/Sub afin de les traiter ultérieurement.

Pour obtenir une liste des journaux disponibles que vous pouvez utiliser, consultez la section relative aux journaux flexibles App Engine.

Écrire des journaux d'application

Lorsque votre application traite une requête, elle peut écrire ses propres messages de journalisation sur stdout et stderr. Ecrivez vos journaux d'application en utilisant stdout pour les résultats et stderr pour les erreurs. Ces fichiers sont automatiquement collectés et peuvent être consultés dans la visionneuse de journaux. Notez que cela ne permet pas d'obtenir des niveaux de journalisation que vous pouvez utiliser pour filtrer dans la visionneuse de journaux. Cependant, cette dernière propose des filtres portant sur d'autres éléments, tels que du texte, un horodatage, etc. Seules les entrées les plus récentes de la visionneuse de journaux sont conservées afin de limiter leur taille.

Afficher des journaux d'application

Vous pouvez afficher les journaux de vos applications à l'aide de la visionneuse de journaux :

  1. Accédez à la page Stackdriver > Logging de la console GCP :

    Accéder à la page de la visionneuse de journaux

  2. Sélectionnez un projet GCP en haut de la page.

  3. Dans les menus déroulants, sélectionnez Application GAE comme type de ressource pour afficher les journaux App Engine.

Vous pouvez utiliser les menus déroulants et d'autres composantes de la visionneuse de journaux pour filtrer les journaux ou effectuer des recherches dans ces derniers afin d'isoler les entrées qui vous intéressent. Consultez la section Interfaces de filtrage de la visionneuse de journaux pour plus de détails.

Filtrer les journaux d'application

Pour filtrer les entrées de journal par thème ou élément de texte dans la visionneuse de journaux, consultez la section Filtres de journaux de base.

Pour écrire des filtres de journaux avancés afin d'affiner la recherche d'entrées de journal, consultez la section Filtres de journaux avancés.

Pour afficher les journaux d'instances, de services ou de versions spécifiques, filtrez par l'ID de cette ressource dans la visionneuse de journaux. Pour rechercher les ID de service et de version, consultez le tableau de bord App Engine.

Dans la visionneuse de journaux, les entrées de journal corrélées par la même trace peuvent être affichées au format "parent-enfant".

Voici les instructions permettant de corréler les entrées de journal :

  1. Choisissez les journaux d'application à corréler avec vos journaux de request. Notez que pour que cette corrélation fonctionne, vous devez choisir des journaux d'application dont le type est différent du type de journal request.

  2. Dans le code de votre application, recherchez l'en-tête HTTP X-Cloud-Trace-Context des requêtes entrantes. Extrayez l'identifiant de trace de l'en-tête. Pour plus de détails, consultez la page Assistance de Stackdriver Trace.

  3. Définissez l'identifiant de trace dans le champ trace de l'objet LogEntry de vos entrées de journal d'application. Le format attendu est le suivant : projects/[PROJECT_ID]/traces/[TRACE_ID].

Une fois les entrées de journal corrélées, procédez comme suit pour les afficher :

  1. Ouvrez vos journaux App Engine dans la visionneuse de journaux. Pour plus d'informations, consultez la section Afficher les journaux d'application.

  2. Développez un journal request en cliquant sur le petit triangle noir situé à gauche de l'entrée lui correspondant. Vos journaux request et journaux d'application s'affichent de manière imbriquée.

En outre :

  • La gravité (severity) la plus élevée des entrées de journal "enfant" ne s'applique pas automatiquement à l'entrée de niveau supérieur. Si vous souhaitez que ce comportement s'applique, définissez manuellement la valeur severity la plus élevée pour l'entrée de niveau supérieur.
  • Définissez le champ httpRequest.requestUrl pour le journal de niveau supérieur.

Lire des journaux via une API

Il n'existe aucune API permettant de lire les journaux App Engine créés dans l'environnement flexible.

Cette page vous a-t-elle été utile ? Évaluez-la :

Envoyer des commentaires concernant…

Environnement flexible App Engine pour les documents Ruby