Corréler des 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. 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 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 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 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

  • Cloud Functions et Cloud Run

Pour en savoir plus sur l'instrumentation de votre application pour collecter des données de trace, consultez la page 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 est l'ID de votre projet Google Cloud et TRACE_ID est 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 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 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 du journal d'application corrélées à l'entrée de journal des requêtes sont imbriquées dans l'entrée de journal des 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 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 parents et enfants à 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 parente, 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 enfants 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 et 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 ayant un enfant contenant la chaîne sont répertoriées.

    Pour afficher les entrées de journal enfants imbriquées, développez l'entrée de journal parent, puis 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 enfants contenant la chaîne "app log message". 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, cela signifie qu'il n'existe aucune entrée parente et enfant corrélée correspondant à votre requête.

Étapes suivantes