Corréler les entrées de journal

Ce document explique comment regrouper et afficher les entrées de journal dans un format "parent-enfant" à l'aide de l'explorateur de journaux. En règle générale, lorsque vous écrivez des entrées de journal dans Cloud Logging, chaque entrée de journal s'affiche séparément et sans corrélation. Toutefois, vous pouvez regrouper ou corréler vos entrées de journal à l'aide du champ trace de l'objet LogEntry.

Lorsque vous associez des entrées de journal, vous pouvez afficher une entrée de journal parente avec plusieurs entrées de journal enfants dans l'explorateur de journaux.

Configurer des entrées de journal corrélées

Pour configurer des entrées de journal corrélées, vous pouvez renseigner manuellement le champ trace ou instrumenter votre application pour envoyer des traces à Cloud Trace à l'aide des bibliothèques clientes Google. Les configurations suivantes capturent automatiquement vos données de trace:

  • Environnement standard App Engine

  • Fonctions Cloud Run et Cloud Run

Pour en savoir plus sur l'instrumentation de votre application afin de collecter des données de trace, consultez la section Présentation de l'instrumentation pour Cloud Trace.

Pour que l'explorateur de journaux puisse corréler une collection d'entrées de journal, celles-ci doivent répondre aux exigences suivantes:

  • Le champ trace de l'objet LogEntry est défini sur une chaîne au format suivant:

       projects/PROJECT_ID/traces/TRACE_ID

    où PROJECT_ID correspond à l'ID de votre projet Google Cloud et TRACE_ID à l'identifiant de trace.

  • Les champs trace des entrées de journal sont identiques.

  • Chaque entrée de journal appartient à un journal unique. Autrement dit, la valeur des champs logName doit être différente.

Afficher les entrées de journal corrélées dans l'Explorateur de journaux

Pour afficher les entrées de journal enfants corrélées à une entrée de journal parente que vous consultez dans l'explorateur de journaux, développez l'entrée de journal.

Par exemple, pour afficher les entrées de journal de requêtes App Engine et d'application, procédez comme suit :

  1. Dans la console Google Cloud, accédez à la page Explorateur de journaux.

    Accéder à l'explorateur de journaux

    Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Logging.

  2. Dans le menu déroulant Resource (Ressource), sélectionnez GAE Application (Application GAE).

  3. Dans le menu déroulant Nom du journal, sélectionnez request_log.

  4. Dans le volet Résultats de la requête, cliquez sur Développer pour développer une entrée de journal.

    Les entrées de journal d'application mises en corrélation avec l'entrée de journal de requêtes sont imbriquées dans l'entrée de journal de requêtes:

    Les entrées de journal d'application sont imbriquées dans l'entrée de journal de requêtes.

    Dans la capture d'écran précédente, l'entrée de journal parente comporte 10 entrées de journal enfants. Vous pouvez développer ces entrées de journal enfants pour en afficher les détails.

Rechercher des entrées de journal corrélées

La recherche corrélée vous permet de rechercher à la fois les entrées de journal parent et enfant à l'aide d'une requête. Le résultat de la recherche est une liste d'entrées de journal parentes correspondant à la requête dans les entrées de journal parentes ou enfants. Par exemple, pour rechercher la chaîne "message de journal de l'application" dans les entrées de journal enfant et parent, procédez comme suit:

  1. Dans la console Google Cloud, accédez à la page Explorateur de journaux.

    Accéder à l'explorateur de journaux

    Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Logging.

  2. Saisissez "app log message dans le champ de recherche, puis cliquez sur Exécuter la requête. Les entrées de journal enfant contenant "message de journal d'application" sont listées dans le volet Résultats de la requête.

  3. Dans le volet Résultats de la requête, cliquez sur Corréler par, puis sélectionnez un journal parent. Pour afficher les journaux de requêtes App Engine, sélectionnez request_log, puis cliquez sur Appliquer.

  4. Dans le volet Résultats de la requête, toutes les entrées de journal parent contenant la chaîne "app log message" ou ayant un enfant contenant la chaîne sont listées.

    Pour afficher les entrées de journal enfants imbriquées, développez l'entrée de journal parente en cliquant sur  Développer.

    Les entrées de journal d'application sont imbriquées dans l'entrée de journal de requêtes.

    Dans la capture d'écran précédente, l'entrée de journal parent comporte 10 entrées de journal enfant contenant la chaîne "message de journal de l'application". Vous pouvez développer ces entrées de journal enfant pour en afficher les détails.

    Si vous avez sélectionné un journal parent et qu'aucune entrée de journal ne s'affiche dans le volet Résultats de la requête, cela signifie qu'aucune entrée parente et enfant corrélée ne correspond à votre requête.

Étape suivante