Corréler des entrées de journal

Ce document explique comment regrouper et afficher les entrées de journal au format "parent-enfant" à l'aide de l'explorateur de journaux. Généralement, lorsque vous écrivez des entrées de journal dans Cloud Logging, chaque entrée de journal apparaît séparément et non corrélée. Toutefois, vous pouvez regrouper ou corréler vos entrées de journal à l'aide du champ trace de l'objet LogEntry.

Lorsque vous mettez en corrélation 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 les entrées de journal corrélées, vous pouvez renseigner manuellement le champ trace ou vous pouvez 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

  • Cloud Functions 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 mette en corrélation 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ée de journal de requêtes App Engine et d'application, procédez comme suit:

  1. Dans le panneau de navigation de la console Google Cloud, sélectionnez Logging, puis Explorateur de journaux :

    Accéder à l'explorateur de journaux

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

  3. Dans le menu déroulant Log Name (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 corrélées à l'entrée de journal de requête sont imbriquées dans l'entrée de journal de requêtes:

    Les entrées de journal de l'application sont imbriquées dans l'entrée de journal des 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 afficher leurs détails.

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

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

  1. Dans le panneau de navigation de la console Google Cloud, sélectionnez Logging, puis Explorateur de journaux :

    Accéder à l'explorateur de journaux

  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 répertorié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 parentes contenant la chaîne "app log message" ou dont l'enfant contient la chaîne sont répertoriées.

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

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

    Dans la capture d'écran précédente, l'entrée de journal parente comporte 10 entrées de journal enfants contenant la chaîne "App log message" (Message de journal d'application). Vous pouvez développer ces entrées de journal enfants pour afficher leurs 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, aucune entrée parente et enfant corrélée ne correspond à votre requête.

Étapes suivantes