Utiliser l'explorateur de journaux

Ce document vous offre un aperçu de l'explorateur de journaux dans Google Cloud Console, que vous pouvez utiliser pour récupérer, afficher et analyser les données de journal.

Vous pouvez également lire des journaux à l'aide de l'API Logging et de Google Cloud CLI.

Premiers pas

Pour commencer à utiliser l'explorateur de journaux, procédez comme suit :

  • Assurez-vous de disposer du rôle de IAM approprié pour afficher les journaux. Pour en savoir plus sur les rôles et les autorisations IAM, consultez la page Contrôle des accès avec IAM.

  • Veuillez noter que si vous utilisez Amazon Web Services Elastic Compute Cloud (AWS EC2), vos entrées de journal se trouvent dans le projet de connecteur AWS qui associe votre compte AWS aux services Google Cloud.

  • Veuillez également noter que si vous ingérez des journaux cloud hybrides et sur site via BindPlane, ces journaux se trouvent sous le type de ressource generic_node.

  • Accédez à l'explorateur de journaux :

    Accéder à l'explorateur de journaux

    Sélectionnez le projet Cloud approprié.

Interface de l'explorateur de journaux

L'interface de l'explorateur de journaux vous permet de récupérer des journaux, d'analyser des données de journal, et d'affiner vos paramètres de requête.

Interface utilisateur de l'explorateur de journaux

L'explorateur de journaux contient les sections suivantes, détaillées sur cette page:

  1. Barre d'outils Action
  2. Volet Requête
  3. Barre d'outils Résultats
  4. Volet Champs de journal
  5. Histogramme
  6. Volet des résultats de la requête

Barre d'outils Action

Grâce aux fonctionnalités de la barre d'outils Action, vous pouvez:

  • Options : accédez à l'ancienne visionneuse de journaux, envoyez des commentaires et consultez le résumé des nouvelles fonctionnalités de l'explorateur de journaux.
  • Affiner le champ d'application: limitez la recherche aux journaux de votre projet Cloud actuel ou à une ou plusieurs vues de stockage. Pour en savoir plus sur la portée, consultez la section Affiner le champ d'application.
  • En savoir plus : consultez les liens vers la documentation et les sujets pertinents.
  • Partager le lien: créez une URL abrégée de la requête actuelle et copiez-la dans votre presse-papiers, ce qui facilite le partage d'une requête. La période absolue de l'URL copiée est représentée par la période actuelle de votre requête, par exemple 7:49:37 PM - 8:49:37 PM.

Affiner le champ d'application

Vous pouvez affiner le champ d'application des journaux affichés dans l'explorateur de journaux via l'option Affiner le champ d'application. Vous pouvez rechercher uniquement les journaux du projet Cloud en cours ou rechercher des journaux dans une ou plusieurs vues de stockage. Pour affiner le champ d'application de l'explorateur de journaux, procédez comme suit :

  1. Dans la barre d'outils Action, sélectionnez Affiner le champ d'application.

  2. Dans la boîte de dialogue Affiner le champ d'application, sélectionnez une option Recherche par.

    Boîte de dialogue Affiner le champ d'application

    • La Recherche par projet vous permet de rechercher des journaux générés par le projet Cloud actuel.

    • La Recherche par espace de stockage vous permet de rechercher des journaux en fonction d'une ou de plusieurs vues de stockage. Pour en savoir plus sur les vues de journaux, consultez la page Gérer les vues de journaux dans vos buckets de journaux.

  3. Si vous sélectionnez Portée par espace de stockage, sélectionnez un ou plusieurs buckets à afficher.

    La boîte de dialogue affiche les vues de stockage qui remplissent les conditions suivantes :

    • L'utilisateur a accès à la vue de stockage.
    • Les buckets de journaux appartiennent au projet Cloud sélectionné, ou le projet Cloud sélectionné a précédemment acheminé des journaux vers les buckets de stockage.
  4. Cliquez sur Appliquer.

Volet Requête

Utilisez les fonctionnalités du volet Requête pour effectuer les opérations suivantes:

  • Onglet Requête: créez et affinez des requêtes à l'aide des fonctionnalités suivantes:

  • Onglet Récents: affichez les requêtes que vous avez récemment exécutées. Pour en savoir plus, consultez la page Utiliser des requêtes récentes.

  • Onglet Enregistré: affichez vos requêtes enregistrées et celles que d'autres utilisateurs du projet Cloud ont partagées avec vous. Pour en savoir plus, consultez Enregistrer des requêtes et Partager des requêtes.

  • Onglet Suggestions: affichez les requêtes suggérées en fonction des ressources de votre projet Cloud. Pour en savoir plus, consultez Utiliser les requêtes suggérées.

  • Onglet Bibliothèque: affichez et exécutez des requêtes fournies par Google en fonction de vos cas d'utilisation. Pour en savoir plus, consultez la page Sélectionner des requêtes dans la bibliothèque.

  • Enregistrer: enregistrez les requêtes qui peuvent être affichées et exécutées à partir de l'onglet Enregistré.

  • Effacer la requête : effacez et réinitialisez les sélections que vous avez effectuées lors de la création d'une requête dans le volet Requête.

  • Diffuser les journaux : affichez les entrées de journal à mesure que Logging les ingère. Pour en savoir plus, consultez la page Diffuser les journaux.

  • Exécuter la requête : permet d'exécuter des requêtes après les avoir créées dans le volet Requête.

Si le champ de l'éditeur de requête ne s'affiche pas, activez Afficher la requête. Si vous ajoutez des termes de recherche dans la zone de texte, ils apparaissent également dans le champ de l'éditeur de requête et sont évalués en tant qu'expressions de requête.

Après avoir examiné votre requête, cliquez sur Run query (Exécuter la requête). Les journaux correspondant à votre requête sont répertoriés dans le volet Résultats de la requête. Les volets Histogramme et Champs de journal s'ajustent également en fonction de l'expression de requête.

Diffuser les journaux

Vous pouvez diffuser les journaux à l'aide de Logging, ou vous pouvez ajouter une requête pour ne diffuser que les journaux correspondant à la requête.

Pour diffuser des journaux en fonction d'une requête, ajoutez une requête dans le volet Query (Requête), puis sélectionnez Stream logs (Diffuser les journaux). À mesure que Logging ingère les données des journaux, seuls les journaux correspondant à la requête sont affichés dans le volet Query results (Résultats de la requête). Si aucune requête n'est fournie, Logging affiche les entrées de journal au fur et à mesure de leur ingestion.

Pour arrêter la diffusion, cliquez sur Arrêter la diffusion ou faites défiler la page jusqu'au volet Résultats de la requête.

Barre d'outils Résultats

Dans la barre d'outils Résultats, vous pouvez effectuer les opérations suivantes:

  • Afficher le volet des champs Journaux: affichez ou masquez rapidement ce volet dans la mise en page de l'explorateur de journaux.
  • Afficher le volet Histogramme : affichez ou masquez rapidement ce volet dans la mise en page de l'explorateur de journaux.
  • Créer une métrique : configurez une métrique basée sur les journaux basée sur votre expression de requête actuelle.
  • Créer une alerte: configurez une alerte basée sur les journaux basée sur votre expression de requête actuelle.
  • Heure actuelle: effectuez une actualisation forcée des résultats de votre requête pour inclure l'heure actuelle. Si le sélecteur de période utilise une plage personnalisée et que l'heure de fin est définie, il exécute la requête avec une période par défaut d'une heure. Sinon, il s'actualise avec la date ou la date de début actuelle, puis exécute la requête. Notez que l'expression de requête n'est pas modifiée lorsque vous utilisez cette fonctionnalité.
  • Autres actions: utilisez ces options supplémentaires pour gérer les alertes basées sur les journaux ou créer un récepteur.

Volet Champs du journal

Le volet Champs du journal offre une synthèse brève des données de journaux et permet d'affiner plus efficacement une requête. Il affiche les entrées de journal réparties en fonction de différentes dimensions correspondant aux champs qu'elles contiennent. Pour chaque champ, le volet Champs du journal affiche les valeurs et leur incidence dans l'ordre décroissant de fréquence. Le nombre de champs de journal correspond à la période du sélecteur de période.

Pour afficher ou masquer le volet Champs de journal, cliquez sur le bouton Champs de journal dans la barre d'outils Résultats.

Le volet Champs de journal est renseigné et mis à jour en fonction d'une requête exécutée dans le champ de l'éditeur de requête.

Si la requête est vide, le volet Champs du journal affiche le nombre d'entrées du journal par champs Type de ressource et Gravité.

Volet champs du journal.

Si vous avez sélectionné Recherche par espace de stockage, vous verrez également l'ID du projet et le nombre correspondant d'entrées du journal.

Si vous sélectionnez un type de ressource dans le volet Champs de journal, un ensemble de champs pertinents (sur la base des libellés de ressources) est utilisé pour remplir le volet. Cela vous permet d'examiner les données de journaux pour ce type de ressource spécifique. Vous pouvez les supprimer en cliquant sur Effacer à côté du champ Type de ressource.

Ajouter des champs au volet Champs du journal

Vous pouvez ajouter certaines paires clé/valeur LogEntry au volet Champs du journal à partir des entrées de journal renseignées dans le volet Résultats de la requête. Pour ajouter un champ au volet Champs du journal, procédez comme suit :

  1. Dans le volet Résultats de requête, développez une entrée de journal en cliquant sur le bouton d'expansion .

  2. Effectuez un clic gauche sur la valeur d'un champ. Dans le menu, sélectionnez Ajouter un champ au volet des champs du journal.

    Le champ personnalisé apparaît dans le volet Champs du journal sous la forme d'une liste de paires clé/valeur.

Pour supprimer un champ personnalisé du volet Champs du journal, cliquez sur Supprimer à côté du champ. Vous pouvez également supprimer un champ personnalisé de la liste en cliquant dessus avec le bouton droit dans le volet Résultats de la requête et en sélectionnant Supprimer des champs du journal.

Notez que les types de champs suivants ne peuvent pas être ajoutés au volet Champs du journal :

  • Champs liés au temps, par exemple, receiveTimestamp et protoPayload.startTime.
  • Champs à cardinalité élevée, par exemple, insertId et protoPayload.latency.
  • Champs comportant des index de tableau dans leur chemin, par exemple, protoPayload.authorizationInfo[0].resource.

Analyser les journaux à l'aide du volet Champs du journal

Pour affiner et affiner une requête, vous pouvez ajouter des paires champ/valeur du volet Champs de journal à l'expression dans le volet Requête. Pour ce faire, dans le volet Champs du journal, cliquez sur la valeur d'un champ. La paire champ/valeur est ajoutée à l'expression à l'aide de l'opérateur AND. La requête s'exécute ensuite.

Vous pouvez ajouter des paires champ/valeur imbriquées, ainsi que des paires champ/valeur de niveau supérieur, dans le volet Champs du journal. Par exemple, supposons que vous ayez ajouté jsonPayload.message au volet Champs de journal. Si vous sélectionnez une valeur jsonPayload.message spécifique, celle-ci remplit le champ de l'éditeur de requête.

Les volets Histogramme et Résultats de requête changent également pour refléter la requête actuelle.

Lorsqu'une requête est en cours d'exécution, les entrées du journal sont analysées et le nombre de champs du journal change. Une fois la requête terminée, le nombre total de tous les champs du journal s'affiche.

Histogramme

Le volet Histogramme vous permet de visualiser la distribution des journaux au fil du temps. L'histogramme est généré à nouveau lorsque vous exécutez une requête, ce qui facilite la visualisation des tendances dans vos données de journaux ainsi que la résolution des problèmes.

Pour afficher ou masquer le volet Histogramme, cliquez sur le bouton Histogramme dans la barre d'outils Résultats.

Fonctionnalités d'histogramme

Volet d'histogramme.

  1. Barres d'histogramme : chaque barre d'histogramme représente une période. Chaque barre contient une répartition en trois couleurs des niveaux de gravité des journaux enregistrés pendant la période correspondant à chaque barre. Les couleurs représentent les niveaux de gravité suivants :

    • Bleu (gravité faible) : Par défaut, Débogage, Informations et Avis.
    • Jaune : (gravité moyenne) : Avertissement.
    • Rouge (gravité élevée) : Erreur, Critique, Alerte et Alerte.

    Chaque barre d'histogramme comporte un menu avec des options permettant d'analyser vos journaux.

  2. Commandes temporelles : vous permettent d'ajuster la période des journaux affichés dans le volet Résultats de requête. Pour en savoir plus sur ces options, consultez la page Analyser les journaux à l'aide des commandes temporelles.

  3. Chronologie: affiche la période des journaux, représentée par des barres d'histogramme, qui sont actuellement affichées dans le volet Résultats de la requête. La chronologie vous aide à accéder aux journaux que vous consultez actuellement au sein de la période plus large concernée par votre requête.

Analyser les journaux à l'aide des commandes temporelles

Vous pouvez utiliser les commandes temporelles de l'histogramme pour vous aider à examiner et à analyser vos données de journaux.

Ajuster la période rapidement

L'histogramme fournit des commandes temporelles qui vous permettent d'ajuster rapidement les données affichées dans l'explorateur de journaux.

Chronologie du volet d'histogramme affichant les commandes temporelles rapides.

  • Poignées temporelles : faites glisser les poignées de la chronologie vers l'intérieur pour une vue affinée des données ou vers l'extérieur pour une vue élargie des données sur la chronologie de l'histogramme. Cliquez sur Exécuter.

  • Faites glisser la chronologie vers l'avant et l'arrière : cliquez sur la flèche avant pour faire glisser la chronologie vers une date ultérieure. Cliquez sur la flèche arrière pour faire glisser la chronologie vers un moment antérieur.

  • Zoom avant et arrière : cliquez sur l'icône de zoom arrière pour élargir l'affichage des données sur la chronologie. Cliquez sur l'icône de zoom avant pour affiner l'affichage des données sur la chronologie.

Les modifications apportées à la chronologie sont limitées à l'heure actuelle ("maintenant") et à la période écoulée depuis 30 jours.

Défilement ou zoom vers un temps T

En plus des commandes temporelles ci-dessus, l'histogramme fournit les fonctionnalités de Défilement vers un temps T et de Zoom vers un temps T pour vous permettre de contrôler plus finement l'histogramme et les données affichées dans les autres volets de l'explorateur de journaux.

Chronologie du volet d'histogramme affichant le défilement et le zoom vers un temps T des commandes temporelles.

Il est possible qu'une barre d'histogramme spécifique vous intéresse du fait de sa taille relative ou de ses niveaux de gravité. Vous pouvez sélectionner cette barre d'histogramme pour ajuster les données de journaux affichées dans l'explorateur de journaux.

Vous pouvez utiliser la fonctionnalité de défilement vers le temps pour parcourir vos données de journaux sans modifier les valeurs dans les volets Histogramme et Champs de journal. Lorsque vous sélectionnez la fonctionnalité Défilement vers un temps T, voici ce qui se produit :

  • Les données de journal affichées dans le volet Résultats de requête sont adaptées sur la base de la période capturée par la barre d'histogramme sélectionnée.

    La requête n'est pas exécutée, mais une actualisation partielle des données peut se produire pour vous assurer que les journaux apparaissant dans le volet Résultats de la requête correspondent à la période de la barre d'histogramme sélectionnée.

  • L'URL de la console est mise à jour pour contenir le timestamp du journal le plus récent capturé par la période temporelle correspondant à la barre d'histogramme sélectionnée.

Pour sélectionner la fonctionnalité Défilement vers un temps T, procédez comme suit :

  1. Pointez sur une barre dans la chronologie de l'histogramme. Un volet contenant des informations récapitulatives sur les données des journaux pour la période spécifiée s'affiche.

  2. Dans le volet, sélectionnez Défilement vers un temps T.

    Sinon, cliquez sur une barre d'histogramme au lieu de passer la souris dessus, ce qui équivaut à sélectionner Défilement vers un temps T.

La fonctionnalité Zoom vers un temps T est semblable à Défilement vers un temps T, mais elle exécute une requête sur vos données de journaux en fonction de la période capturée par une barre d'histogramme sélectionnée. Lorsque vous sélectionnez la fonctionnalité Zoom vers un temps T, voici ce qui se produit :

  • Les données des journaux affichées dans le volet Résultats de requête sont actualisées et restreintes sur la base de la période correspondant à la barre d'histogramme sélectionnée.
  • L'URL de la console est mise à jour pour contenir le timestamp du journal le plus récent capturé par la période temporelle correspondant à la barre d'histogramme sélectionnée.
  • L'histogramme change pour n'afficher que les journaux dont la valeur timestamp est comprise dans la période correspondant à la barre d'histogramme sélectionnée.
  • Les données du volet Champs du journal s'ajustent en fonction de la période capturée par la barre d'histogramme sélectionnée.

Pour sélectionner la fonctionnalité Zoom vers un temps T, procédez comme suit :

  1. Passez la souris sur une barre de la chronologie du volet Histogramme. Un volet contenant des informations récapitulatives sur les données des journaux pour la période spécifiée s'affiche.

  2. Dans le volet, sélectionnez Zoom vers un temps T.

Query results

À l'aide du volet Résultats de la requête, vous pouvez explorer les entrées de journal correspondant à vos expressions de requête et à la période que vous avez sélectionnée à l'aide des contrôles temporels de l'histogramme ou du sélecteur de période:

Volet des résultats de requête

Utilisez les fonctionnalités du volet Résultats de la requête pour effectuer les opérations suivantes:

  • Résultats de la requête : affichez les entrées de journal récupérées à partir de votre requête au format JSON structuré. Pour développer les résultats de la requête, cliquez sur Saisir les résultats de la requête en plein écran .
  • Time zone (Fuseau horaire) : modifiez le fuseau horaire dans lequel les journaux sont affichés.
  • Télécharger des journaux : téléchargez des journaux à partir des résultats de votre requête.
  • Masquer les journaux similaires : masquez de grandes quantités de journaux similaires dans les résultats de votre requête.
  • Données de trace: affichez les détails de la trace et affinez votre requête en fonction de la trace. Pour en savoir plus, consultez la section Afficher les données de trace.
  • Masquer le résumé du journal : masque la ligne de résumé du journal dans les résultats de la requête.
  • Développer ou réduire les champs de journal imbriqués : développez ou réduisez les champs imbriqués.
  • Copier dans le presse-papiers : copiez l'entrée de journal au format JSON.
  • Copier le lien vers une entrée de journal : partagez un lien vers une entrée de journal. Pour en savoir plus, consultez la section Copier un lien vers une entrée de journal.
  • Bouton Edit (Modifier) dans l'en-tête de colonne Summary (Résumé) : ajoutez la valeur d'un champ de journal aux lignes de résumé de vos entrées de journal. Vous pouvez également masquer complètement les champs récapitulatifs par défaut pour afficher vos entrées en texte brut. Pour en savoir plus, consultez Ajouter et gérer des champs de résumé.
  • Épingler une entrée de journal: épinglez une entrée de journal dans les volets Query results (Résultats de la requête) et Histogram (Histogramme). Pour en savoir plus, consultez la section Épingler des journaux.
  • Défilement du curseur : faites défiler les journaux dans Query results (Résultats de la requête). L'URL s'ajuste pour inclure cursorTimestamp, qui indique le timestamp du journal le plus récent affiché dans le volet Query results (Résultats de la requête).

Dans le volet des résultats de la requête, vous pouvez cliquer sur les valeurs d'un champ pour effectuer les opérations suivantes:

  • Afficher les entrées correspondantes : interrogez les entrées de journal correspondantes.
  • Masquer les entrées correspondantes: recherchez les entrées de journal qui ne correspondent pas à l'expression sélectionnée.
  • Ajouter un champ à la ligne de résumé: ajouter le champ en tant que ligne de résumé aux entrées de journal.

Ajouter et gérer des champs de résumé

Vous pouvez utiliser des champs de résumé pour identifier plus rapidement des tendances dans vos journaux.

Supposons que vous examiniez les entrées de journal dans les résultats de requête et que vous souhaitiez les parcourir rapidement selon un certain champ LogEntry. Ou peut-être souhaitez-vous regrouper vos entrées de journal selon une certaine paire champ/valeur ? Vous pouvez ajouter des champs de résumé à vos résultats, qui apparaissent sous forme de chips au début de chaque ligne d'entrée de journal. Par exemple, l'image suivante montre des résultats de requête avec le champ récapitulatif resource.type ajouté à chaque ligne d'entrée de journal:

L'explorateur de journaux affiche les journaux précédés d'un texte vert indiquant les types de ressources.

L'explorateur de journaux propose des champs de résumé par défaut, qui dépendent de vos résultats de requête actuels, et des champs de résumé personnalisés, qui vous permettent de cibler n'importe quel champ dans LogEntry.

Vous pouvez gérer les champs récapitulatifs personnalisés et par défaut à partir d'un menu d'édition dans les résultats de votre requête. Vous pouvez également ajouter des champs de résumé personnalisés directement à partir d'une entrée de journal développée.

Ajouter un champ de résumé personnalisé à partir d'une entrée de journal

Pour ajouter un champ de résumé personnalisé directement à partir d'une entrée de journal, procédez comme suit:

  1. Développez une entrée de journal en cliquant sur le bouton Développer .

  2. Cliquez sur la valeur d'un champ, puis sélectionnez Ajouter un champ à la ligne de résumé.

Le champ récapitulatif apparaît désormais sous forme de chip avant les entrées de journal contenant ce champ.

Pour supprimer un champ de résumé personnalisé, cliquez sur son chip dans la ligne d'entrée de journal et sélectionnez Supprimer le champ de la ligne de résumé. Pour mieux gérer vos champs de résumé personnalisés, consultez les instructions de la section suivante.

Gérer les champs de résumé à l'aide du menu d'édition

Pour gérer les champs de résumé personnalisés et par défaut à l'aide du menu d'édition:

  1. Cliquez sur Modifier pour ouvrir le menu d'édition:

    Le volet des résultats de la requête affiche le bouton permettant de modifier les champs de résumé.

  2. Dans la boîte de dialogue Gérer les champs de résumé, procédez comme suit:

    1. Activez ou désactivez l'option Champs de résumé par défaut à l'aide du bouton bascule .

      Si vous désactivez les champs de résumé par défaut et que vous n'ajoutez aucun champ de résumé personnalisé, vos entrées de journal s'affichent au format texte brut.

    2. Ajoutez des noms de champs personnalisés dans Champs de résumé personnalisés.

      La sélection des champs de résumé offre les fonctionnalités suivantes :

      • Saisie semi-automatique à l'aide des journaux actuellement affichés dans les résultats de votre requête
      • Correction du champ pour les caractères juridiques entre guillemets

      Par exemple, si vous saisissez jsonPayload.id-field, il est remplacé par jsonPayload."id-field".

      Vous pouvez également cibler n'importe quel champ LogEntry, qu'il soit suggéré à l'aide de la fonction de saisie semi-automatique.

      Pour supprimer un champ de résumé personnalisé, cliquez sur le X dans son chip.

    3. Activez ou désactivez la troncature de vos champs de résumé personnalisés. Utilisez le bouton bascule en tronquant le champ de résumé pour raccourcir l'affichage des valeurs du champ de résumé. Choisissez ensuite le nombre de caractères à afficher avant que le champ soit tronqué, et indiquez si le début ou la fin du champ est affiché.

  3. Cliquez sur Appliquer.

    Les champs de résumé sont désormais mis à jour dans les résultats de votre requête.

Masquer les entrées de journal similaires

Vous pouvez masquer les journaux pour supprimer rapidement de grandes quantités d'entrées de journal similaires des résultats de votre requête.

Lorsque vous exécutez une requête, les résultats sont analysés pour détecter les tendances telles qu'elles sont affichées dans le volet Résultats de la requête. Les entrées de journal sont ensuite automatiquement regroupées en fonction du contenu du champ de journal similaire. Si un schéma significatif est détecté, une bannière s'affiche dans le volet Query results (Résultats de la requête) pour indiquer le pourcentage de résultats similaires qui peuvent être masqués:

Masquer la bannière des journaux similaires

Pour masquer les journaux similaires, cliquez sur Masquer les entrées similaires. Cela ajoute une clause à la requête et actualise les résultats.

Pour afficher les entrées de journal à masquer, cliquez sur Preview (Aperçu). Une fenêtre distincte s'ouvre, décrivant le modèle trouvé et affiche des exemples des entrées qui seront masquées.

Lorsque vous masquez des journaux similaires, aucune information n'est enregistrée en dehors de la session de l'explorateur de journaux. Chaque requête génère alors une nouvelle analyse qui ne prend en compte que les journaux affichés. Différentes requêtes analysent différentes parties des entrées de journal en fonction des types de journaux renvoyés.

Épingler des entrées de journal

Vous pouvez épingler une entrée de journal pour mettre en surbrillance une entrée de journal qui vous intéresse.

Pour épingler une entrée de journal, procédez comme suit:

  1. Pointez sur l'entrée de journal que vous souhaitez épingler.
  2. Cliquez sur l'icône en forme de punaise .

Lorsque vous épinglez une entrée de journal, son arrière-plan est assombri et une icône en forme de punaise s'affiche.

Si vous épinglez une entrée de journal et exécutez à nouveau votre requête, elle apparaît en haut ou en bas du volet Résultats de la requête, selon la façon dont vous avez configuré les données de journal. Une icône en forme d'épingle apparaît également dans le volet Histogramme en fonction de l'entrée de journal épinglée timestamp:

L'explorateur de journaux affiche une entrée de journal épinglée dans les volets "Résultats de la requête" et "Histogramme".

Pour annuler l'épinglage de l'entrée de journal, cliquez à nouveau sur l'icône en forme de punaise.

Afficher une entrée de journal épinglée dans des contextes de ressources

Si vous épinglez une entrée de journal et que vous l'affichez dans différents contextes de ressources, la requête est réexécutée avec les mêmes informations de ressources que l'entrée de journal épinglée.

Pour afficher l'entrée de journal épinglée dans différents contextes de ressources, procédez comme suit:

  1. Cliquez sur la flèche vers le bas à côté du journal épinglé pour développer le menu des éléments épinglés.

  2. Dans le menu du repère, vous pouvez choisir d'afficher l'entrée de journal dans les contextes de ressources suivants:

    • Identique resource.type : réexécute la requête avec le même resource.type que le journal épinglé.

    • Identique resource.labels : réexécute la requête avec le même resource.labels que le journal épinglé.

    • Identique trace : réexécute la requête avec la même trace que le journal épinglé.

    • Tout afficher : efface la requête et la réexécute.

Afficher une entrée de journal épinglée dans le volet Histogramme

Vous pouvez utiliser le volet Histogramme pour mettre en surbrillance, faire défiler et examiner plus en détail une entrée de journal épinglée.

Dans le volet Histogramme, cliquez sur l'icône en forme de punaise , puis sélectionnez l'une des options de menu suivantes:

  • Faites défiler la page jusqu'à l'entrée de journal : placez l'entrée de journal dans le volet Résultats de la requête actuel et affichez l'entrée de journal épinglée dans le contexte des journaux à proximité.
  • Zoomer sur l'entrée de journal : restreignez la période affichée dans le volet Histogramme et affinez votre requête pour isoler les journaux situés à proximité du journal épinglé.

Afficher les données de trace

Lorsqu'une entrée de journal contient à la fois le champ trace et celui lié à la latence, les icônes de latence et de trace apparaissent.

Affichage d'une entrée de journal contenant des données de trace.

Lorsqu'une entrée de journal ne contient que le champ trace, seule l'icône de trace s'affiche.

Affichage des entrées de journal contenant uniquement le champ de trace et comportant l'icône de trace.

Pour afficher les données de trace associées à l'entrée de journal, cliquez sur l'icône de trace. Vous pouvez :

  • Afficher les détails des traces : affiche le délai parent et les traces enfantes, ainsi que les détails de la trace. Pour afficher plus de détails sur la trace, accédez à Cloud Trace en cliquant sur Afficher dans Trace. Pour en savoir plus sur le contenu du panneau de détails, consultez la section Afficher les détails des traces.
  • Afficher tous les journaux de cette trace : affine et exécute la requête en ajoutant le champ trace défini sur l'identifiant de la trace associée à l'entrée de journal.

  • Afficher uniquement les requêtes tracées : permet d'affiner et d'exécuter la requête en ajoutant le champ traceSampled défini sur True. Pour en savoir plus sur l'échantillonnage, consultez la section Taux d'échantillonnage.

Afficher les données Monitoring

Pour certains journaux, tels que les journaux GKE et Compute Engine, vous pouvez cliquer sur le type de ressource de la ligne de résumé du journal pour afficher un menu avec les options suivantes :

  • Afficher les détails de la surveillance : ouvre un panneau de détails pour une ressource GKE. Pour en savoir plus sur le panneau de détails, consultez la section Afficher les détails des ressources.
  • Afficher dans Monitoring : s'ouvre sur une page Monitoring de la ressource.
  • Afficher dans GKE ou Afficher dans Compute Engine : ouvre la page Détails de la ressource dans l'interface utilisateur GKE ou Compute Engine.

Affichage du menu de l'explorateur de journaux pour les ressources GKE.

Pour partager un lien vers un journal, développez une entrée de journal, puis sélectionnez Copy link (Copier le lien). Le lien est copié dans le presse-papiers. Vous pouvez envoyer le lien aux utilisateurs ayant accès au projet Cloud. Lorsqu'un utilisateur colle le lien dans un navigateur ou le sélectionne, Logging épingle l'entrée de journal dans le volet Résultats de la requête.

Copie du lien pour partager l'entrée de journal avec d'autres utilisateurs.

Télécharger les journaux

Vous pouvez télécharger les journaux au format CSV ou JSON. Vous devez disposer de l'un des rôles Identity and Access Management suivants pour télécharger les journaux :

  • Administrateur Logging (roles/logging.admin)
  • Accesseur de vues de journaux (roles/logging.viewAccessor)

Pour télécharger des journaux, procédez comme suit :

  1. Cliquez sur Télécharger dans le volet Résultats de la requête.

  2. Dans la boîte de dialogue Télécharger les journaux, sélectionnez le format CSV ou JSON.

  3. Sélectionnez ce que vous souhaitez faire des données de journal. Vous pouvez :

    • Téléchargez les données sur votre ordinateur.
    • Téléchargez les données dans Drive.
    • Affichez les données dans un nouvel onglet.

    Lorsque vous enregistrez un fichier CSV et que vous sélectionnez "Drive", vous pouvez ouvrir le fichier dans Sheets.

Exemples de requêtes

Pour obtenir des suggestions de requêtes, classées par produit Google Cloud et par cas d'utilisation, consultez la page Exemples de requêtes avec l'explorateur de journaux. Par exemple, vous pouvez exécuter des requêtes liées à Kubernetes pour rechercher les journaux Google Kubernetes Engine.

Afficher les journaux Compute Engine

Pour certains types de ressources Compute Engine, tels que gce_instance et gce_network, le nom de la ressource avec l'ID de ressource apparaît comme un sous-texte à plusieurs endroits de l'explorateur de journaux. Par exemple, pour le type de ressource gce_instance, le nom de la VM apparaît à côté de l'ID de la VM. Les noms de ressources vous aident à identifier l'ID de ressource correct, sur lequel vous pouvez créer des requêtes.

Les noms de ressources Compute Engine peuvent s'afficher aux emplacements suivants:

  • Menus des filtres du volet Requête : les types de ressources Compute Engine affichent les noms de ressources avec les ID de ressource correspondants en tant que sous-texte.
  • Champs de journal: les types de ressources Compute Engine affichent le nom de la ressource plutôt que l'ID de ressource dans les dimensions du champ.
  • Résultats de la requête : pour les journaux d'instance de VM Compute Engine, le champ resource.labels affiche les métadonnées avec le nom de ressource correspondant.
  • Champs de résumé : pour les journaux d'instance de VM Compute Engine, le chip affiche le nom de la ressource au lieu de son ID.

Dépannage

Cette section fournit des instructions permettant de résoudre des problèmes courants liés à l'utilisation de l'explorateur de journaux.

Si vous rencontrez des problèmes lors de l'affichage des journaux dans les destinations de récepteurs, consultez la page Résoudre les problèmes de routage et de récepteurs.

Obtenir l'ID d'un projet ou d'une organisation Cloud

Pour obtenir un ID de projet ou d'organisation Cloud depuis n'importe quel emplacement dans Google Cloud Console, développez la liste des projets Cloud à partir du sélecteur de projet Cloud et d'organisation, puis recherchez l'ID du projet Cloud dans la colonne ID:

L'ID du projet s'affiche

Impossible d'afficher les entrées de journal

Si aucune entrée de journal ne s'affiche, vérifiez les points suivants :

  • Le bon projet Cloud est-il sélectionné ? Si ce n'est pas le cas, sélectionnez le bon projet Cloud sur le sélecteur de projet et d'organisation Cloud.

  • Votre projet Cloud utilise-t-il des ressources qui génèrent des journaux et y a-t-il de l'activité sur ces ressources ? Même si le projet Cloud est nouveau, des journaux d'audit devraient être présents et confirmer la création du projet. Vérifiez que vous utilisez une ressource générant des journaux en accédant à la section Mapper des services sur des types de ressources de la page Liste de ressources surveillées.

  • La période définie est-elle trop restrictive ? Vérifiez que la période définie dans votre requête est correcte.

  • Affichez vos requêtes d'exclusion actives pour vous assurer que les journaux que vous recherchez ne sont pas accidentellement exclus.

  • Le champ d'application approprié est-il utilisé pour afficher les journaux ? Pour savoir comment ajuster la portée de votre recherche, consultez Affiner la portée.

Ma requête est correcte, mais les entrées de journal ne s'affichent toujours pas

  • Vous ne pouvez pas afficher les entrées de journal antérieures à la durée de conservation de Logging. Reportez-vous à la section Durée de conservation des journaux pour la période de conservation des journaux en vigueur.

  • Pendant les périodes de charges importantes, des retards peuvent être observés lors de l'envoi de journaux à Logging, ou lors de leur réception et de leur affichage.

  • L'explorateur de journaux n'affiche pas les entrées de journal présentant des horodatages futurs tant que cette date n'est pas passée. Cette situation inhabituelle est probablement causée par un décalage au niveau de l'application envoyant les journaux.

  • Le champ d'application de la requête était trop large et celle-ci ne pouvait pas être exécutée dans un délai raisonnable. Le message affiché peut par exemple être "délai expiré avant la fin de l'opération". Essayez de rendre votre requête plus spécifique ou de réduire la période.

La requête renvoie une erreur

Si vous envoyez une requête sur une ressource sans spécifier de bucket, Cloud Logging utilise l'historique des récepteurs du projet Google Cloud pour déterminer où les entrées ont été écrites pour cette ressource. Si Cloud Logging identifie plus de 200 buckets dans lesquels des entrées peuvent avoir été écrites, la requête échoue et affiche le message Error: Invalid query.

Pour résoudre ce problème, affinez le champ d'application de votre requête sur un sous-ensemble de l'espace de stockage. Pour en savoir plus, consultez la section Affiner le champ d'application.

La période des résultats de requête ne correspond pas à la requête

Les données de journaux affichées dans les volets Résultats de requête et Champs du journal s'adaptent en fonction de la période capturée par la chronologie de l'histogramme. Vous pouvez ajuster la chronologie de l'histogramme à l'aide des commandes temporelles de l'histogramme ou du sélecteur de période. L'ajustement de ces commandes temporelles ne modifie pas l'expression de la requête dans le volet Requête.

Lorsque vous rédigez une requête avec un horodatage, le sélecteur de période est désactivé et la requête utilise l'expression d'horodatage comme restriction de période. Si une requête n'utilise pas d'expression d'horodatage, la requête utilise le sélecteur de période comme restriction.

Obtenir de l'aide

Pour en savoir plus sur l'assistance, consultez la page d'assistance de la suite d'opérations Google Cloud.