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 général, lorsque vous écrivez des entrées de journal dans 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 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 sont automatiquement Capturez 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 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, les entrées de journal doit 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 parent que vous 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 Ressource, sélectionnez 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 du journal de l'application sont imbriquées dans l'entrée de journal de la requête.

    Dans la capture d'écran précédente, l'entrée de journal parent 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 qui correspondent à la requête dans les entrées de journal parent ou enfant. 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 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 le chaîne "app log message" ou dont un enfant contient la chaîne sont dans la liste.

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

    Les entrées du journal de l'application sont imbriquées dans l'entrée de journal de la requête.

    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 que vous ne voyez aucune entrée de journal dans les résultats de la requête il n'existe aucune entrée parent et enfant corrélée correspondant à votre requête.

Étape suivante