Utiliser l'explorateur de journaux

Ce guide vous explique comment rechercher et afficher des journaux avec l'explorateur de journaux dans Google Cloud Console.

Vous pouvez également lire les journaux à l'aide de l'API Logging et du SDK Cloud.

Commencer

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

  • Assurez-vous de disposer du rôle Identity and Access Management 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.

  • Notez 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 à Google Cloud. Google Cloud.

  • Notez que si vous ingérez des journaux cloud sur site et hybrides via BindPlane, vous pouvez les trouver 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 volets suivants, qui sont détaillés dans les sections suivantes:

  1. Barre d'action
  2. Générateur de requêtes
  3. Champs de journal
  4. Histogramme
  5. Résultats de la requête

Barre d'action

Volet de la barre d'action

Le volet Action présente les fonctionnalités suivantes :

  1. Options : permet d'accéder à l'ancienne visionneuse de journaux, d'envoyer des commentaires et d'afficher un résumé des nouvelles fonctionnalités de Logging.
  2. Affiner le champ d'application: vous permet de limiter votre recherche aux journaux de votre projet Cloud actuel ou à une ou plusieurs vues de stockage. Pour en savoir plus sur la limitation, consultez la page Affiner le champ d'application.
  3. Partager le lien : permet de créer une URL abrégée de la requête actuelle et de la copier dans votre presse-papiers, ce qui facilite le partage d'une requête. Deux options sont disponibles : Copier avec une période absolue et Copier avec une période relative. Si vous sélectionnez Copier avec une période absolue, l'URL copié comporte l'intervalle de temps absolu correspondant représenté par l'intervalle de temps actuel ; par exemple, 7:49:37 PM - 8:49:37 PM. Si vous sélectionnez Copier avec une période relative, l'URL copié comporte l'intervalle de temps relatif actuel sélectionné ; par exemple, 1 hour.
  4. Sélecteur de fuseau horaire : permet de restreindre les résultats par période. La période défaut est d'une heure.
  5. Mise en page : permet d'activer et de désactiver les volets Histogramme et Explorateur de champs de journaux.
  6. Apprendre : permet d'afficher les liens vers la documentation pertinente.

Notez que si l'une de vos requêtes comporte un horodatage, le sélecteur de période est désactivé et que la requête utilise l'expression d'horodatage comme restriction temporelle. Si une requête n'utilise pas d'expression d'horodatage, la requête utilise le sélecteur de période comme restriction de plage.

Affiner le champ d'application

Vous pouvez affiner le champ d'application des journaux affichés dans l'explorateur de journaux à l'aide de l'option Affiner le champ d'application. Vous ne pouvez rechercher que 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 le volet Barre d'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 sur vos buckets de journaux.

  3. Si vous sélectionnez Recherche 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.

Générateur de requêtes

Générateur de requêtes

Dans le volet Générateur de requêtes, vous pouvez effectuer les opérations suivantes :

  1. Champ du générateur de requêtes : permet de créer des requêtes à l'aide du langage de requête Logging.
  2. Menus déroulants du générateur de requêtes Permet d'ajouter des expressions de requête en fonction deRessource ;Nom du journal etGravité (Installation de Python groupée). Pour en savoir plus, consultez les menus déroulants du générateur de requêtes.
  3. Récentes: permet de visualiser vos requêtes récentes. Pour en savoir plus, consultez la page Requêtes récentes.
  4. Enregistré: permet de visualiser les requêtes enregistrées et les requêtes que d'autres utilisateurs du projet Cloud ont partagées avec vous. Pour en savoir plus, consultez les pages Requêtes enregistrées et Requêtes partagées.
  5. Suggestion: vous permet d'afficher les suggestions de requêtes en fonction des ressources de votre projet Cloud. Pour en savoir plus, consultez la section Requêtes suggérées.
  6. Enregistrer : permet d'enregistrer des requêtes pouvant être visualisées et exécutées à partir de l'onglet Enregistrements.
  7. Diffuser des journaux: permet d'afficher les entrées de journal à mesure que Logging les ingère. Pour en savoir plus, consultez la section Diffuser les journaux.
  8. Exécuter : permet d'exécuter vos requêtes après les avoir créées dans le champ du générateur de requêtes.

Diffuser les journaux

Vous pouvez diffuser vos journaux en même temps que Logging les ingère, ou 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 au champ de l'outil de création de requêtes, puis sélectionnez Diffuser les journaux. Lorsque Logging ingère les données des journaux, seuls les journaux correspondant à la requête sont affichés dans le volet Query result (Résultat de la requête). Si aucune requête n'est fournie, Logging affiche chaque journal tel qu'il est ingéré.

Ajouter une requête avant de choisir de diffuser les journaux

Pour arrêter la diffusion, sélectionnez Arrêter la diffusion ou faites défiler la page vers le bas dans le volet Résultats de la requête.

Volet Champs du journal

Le volet Champs de journaux offre un résumé général des données des journaux et permet d'affiner plus efficacement une requête. Il affiche les entrées de journal réparties par différentes dimensions correspondant aux champs de ces entrées. Pour chaque champ, le volet Champs de journaux affiche les valeurs et leur interaction par ordre de fréquence décroissant. Le nombre de champs de journal correspond à la période dans le sélecteur de période.

Activez le volet Champs du journal

Pour activer le volet Champs du journal, sélectionnez Mise en page, puis cochez la case Champs du journal. Le volet Champs du journal s'affiche.

Volet des champs du journal sélectionné

Pour désactiver le volet Champs du journal, décochez la case Champs du journal.

Fonctionnalités du volet Champs du journal

Le volet Champs du journal est renseigné et mis à jour en fonction d'une requête exécutée dans le générateur de requêtes.

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 journaux, un ensemble de champs pertinents, basés sur les libellés de ressources, remplit le volet. (Installation de Python groupée). Cela vous permet d'examiner les données des 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 Query results (Résultats de la requête), développez une entrée de journal en cliquant sur le bouton de développement .

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

    Menu avec une option pour ajouter un champ.

    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 à partir du volet Champs de journal à l'expression Générateur de requêtes. Pour ce faire, dans le volet Champs de journal, cliquez sur la valeur d'un champ. Cela permet d'ajouter la paire champ/valeur à 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 du journal. Si vous sélectionnez une valeur jsonPayload.message particulière, elle renseigne le volet Générateur de requêtes :

Champs du journal et volets du générateur de requêtes avec champ personnalisé ajouté.

Les volets Histogramme et Résultats de la 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 régénéré lorsque vous exécutez une requête, ce qui facilite la visualisation des tendances dans vos données de journaux et la résolution des problèmes.

Activer le volet Histogramme

Pour activer le volet d'histogramme, sélectionnez Page Layout (Mise en page), puis cochez la case Histogram (Histogramme). Le volet Histogram s'affiche.

La mise en page est ouverte et l'option "Histogramme" est sélectionnée

Pour désactiver le volet d'histogramme, décochez la case Histogramme.

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 contient un menu comportant 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 la requête. Pour en savoir plus sur ces options, consultez la page Analyser les journaux à l'aide des commandes temporelles.

  3. Timeline d'histogramme: indique la période des journaux, représentées par des barres d'histogrammes, actuellement affichées dans le volet Résultats de la requête. La chronologie permet de vous orienter vers les journaux que vous êtes en train de consulter au cours de la période de la requête.

Analyser des journaux à l'aide de commandes temporelles

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

Conseil: Lorsque vous ajustez les commandes temporelles de l'histogramme, les données des journaux dans les volets Résultats de la requête et Champs de journal s'ajustent en fonction de la période capturée par la Chronologie de l'histogramme. L'ajustement des commandes temporelles de l'histogramme ne modifie pas l'expression de requête dans le volet Générateur de requêtes.

Ajuster rapidement l'heure

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 Run (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 de la chronologie sont limitées à la date actuelle ("aujourd'hui") et à 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.

Une barre d'histogramme particulière peut vous intéresser en fonction de sa taille ou de son niveau de gravité relatifs. Vous pouvez sélectionner cette barre d'histogramme pour ajuster les données des journaux affichées dans l'explorateur de journaux.

La fonctionnalité Défilement vers un temps T vous permet de parcourir les données de vos journaux sans modifier les valeurs des volets Histogramme et Champs du journal. Lorsque vous sélectionnez la fonctionnalité Défilement vers un temps T, voici ce qui se produit :

  • Les données des journaux affichées dans le volet Résultats de la requête s'ajustent en fonction 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 plage de dates de la barre d'histogramme sélectionnée.

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

  1. Passez la souris sur une barre de la timeline Histogramme. Un volet contenant des informations récapitulatives sur les données des journaux pour la période indiqué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 la requête sont actualisées et réduites en fonction de la restriction temporelle 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 plage de dates de 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 associée à 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 timeline Histogramme. Un volet contenant des informations récapitulatives sur les données des journaux pour la période indiquée s'affiche.

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

Résultats de la requête

Volet des résultats de la requête

Le volet Query results (Résultats de la requête) vous permet d'explorer les entrées de journal correspondant aux expressions de requête et à la période sélectionnée à l'aide des commandes temporelles de l'histogramme ou du sélecteur de période.

  1. Résultats de la requête : cette option vous permet d'afficher les journaux récupérés à partir de votre requête.
  2. Entrées de journal : permet d'afficher les entrées de journal au format JSON structuré.
  3. Développer et réduire les résultats de la requête : permet de développer le volet des résultats de la requête pour afficher plus d'entrées de journal.
  4. Fuseau horaire : permet de modifier le fuseau horaire dans lequel les journaux sont affichés.
  5. Données de trace: permettent d'afficher les détails de la trace et d'affiner votre requête en fonction de la trace. Pour en savoir plus, consultez Afficher les données de trace.
  6. Masquer le récapitulatif des journaux : vous permet de masquer la ligne de résumé des journaux à partir des résultats de la requête.
  7. Développer ou réduire les champs de journal imbriqués : permet de développer ou de réduire les champs imbriqués.
  8. Copier dans le Presse-papiers : permet de copier l'entrée de journal au format JSON.
  9. Copier le lien dans une entrée de journal : permet de partager un lien vers une entrée de journal. Pour en savoir plus, consultez la section Copier un lien vers une entrée de journal.
  10. Heure actuelle : permet d'effectuer une actualisation forcée 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, la requête est exécutée avec une période par défaut d'une heure. Sinon, le sélecteur effectue l'actualisation à la date de début ou pendant la durée actuelle, puis exécute la requête. Notez que l'expression de requête n'est pas modifiée lorsque vous utilisez cette fonctionnalité.
  11. Actions: vous permet de configurer une métrique basée sur les journaux, de créer une destination de récepteur ou de télécharger vos journaux. Pour en savoir plus sur le téléchargement de journaux, consultez la page Télécharger des journaux.
  12. Configurer : permet d'ajouter la valeur d'un champ de journal à la ligne de résumé au début ou à la fin de l'entrée de journal. Vous pouvez également choisir d'afficher les journaux les plus récents en premier ou en dernier. Pour en savoir plus sur l'ajout d'un champ de résumé, consultez la section Ajouter des champs de résumé.
  13. Épingler une entrée de journal: vous permet d'épingler une entrée de journal aux volets Résultats de la requête et Histogramme. Pour en savoir plus, consultez la section Épingler des journaux.
  14. Défilement du curseur : lorsque vous faites défiler les journaux Résultats de la requête, l'URL s'adapte pour inclure cursorTimestamp, qui indique le timestamp du dernier journal affiché dans le volet Résultats de la requête actuel.

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 :

Options après la sélection de la valeur du champ

  1. Afficher les entrées correspondantes : permet de rechercher des entrées de journal correspondantes.
  2. Masquer les entrées correspondantes : permet de rechercher des entrées de journal qui ne correspondent pas à l'expression sélectionnée.
  3. Ajouter un champ à la ligne de résumé : permet d'ajouter le champ en tant que ligne de résumé aux entrées de journal.

Ajouter des champs de résumé

Les champs de résumé vous permettent de détecter plus rapidement certains formats dans vos journaux. Par exemple, l'image suivante montre la valeur du champ de résumé resource.labels.pod_name ajouté avant les journaux contenant cette valeur.

L'explorateur de journaux affiche les journaux précédés d'un texte vert affichant les noms des pods.

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

Pour ajouter un champ de résumé à une entrée de journal, procédez comme suit :

  1. Développez une entrée de journal en cliquant sur le bouton d'expansion .

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

    Le champ de résumé apparaît désormais devant les entrées de journal contenant ce champ.

Ajouter un champ de résumé à l'aide du bouton Configure (Configurer)

Pour ajouter un champ de résumé à l'aide du bouton Configure, procédez comme suit :

  1. Cliquez sur Configure, puis sélectionnez Manage Summary Fields (Gérer les champs de résumé).

    L'option "Manage Summary Fields" (Gérer les champs de résumé) est sélectionnée dans le menu déroulant "Configure" (Configurer)

  2. Ajoutez des champs.

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

    • Saisie semi-automatique à l'aide des journaux actuellement affichés
    • 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".

  3. Cliquez sur Truncate summary fields (Tronquer les champs de résumé) pour réduire l'affichage des champs de résumé. Choisissez ensuite le nombre de caractères à afficher avant que le champ ne soit tronqué et si vous souhaitez que ce soit le début ou la fin du champ qui s'affiche.

  4. Cliquez sur Appliquer.

    Le champ de résumé apparaît désormais devant les entrées de journal contenant ce champ.

Épingler des entrées de journal

Vous pouvez sélectionner une entrée de journal qui vous intéresse en épinglant une entrée de journal.

Pour épingler une entrée de journal, passez la souris sur l'entrée de journal que vous souhaitez épingler, puis sélectionnez l'icône . Lorsque vous épinglez une entrée de journal, son arrière-plan est sombre 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, celle-ci s'affiche en haut ou en bas du volet Résultats de la requête, selon la configuration de vos données de journaux. Une icône en forme d'épingle s'affiche également dans le volet Histogramme en fonction du timestamp de l'entrée de journal épinglée.

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

Pour retirer l'entrée de journal, sélectionnez l'icône en forme de punaise, puis cliquez sur Retirer l'entrée de journal.

Afficher une entrée de journal épinglée dans son contexte de ressource

Pour afficher l'entrée de journal épinglée dans son contexte de ressource, sélectionnez l'icône en forme de punaise , puis cliquez sur Épingler et afficher les entrées de journal des ressources.

Option "Épingler et afficher les entrées de journal des ressources" sélectionnée.

Logging renseigne le champ resource.type du générateur de requêtes à partir de l'entrée de journal épinglée, puis exécute la requête. Vous pouvez maintenant afficher l'entrée de journal épinglée avec son type de ressource.

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, sélectionnez l'icône en forme de punaise , puis choisissez l'une des options de menu suivantes :

  • Faire défiler jusqu'à l'entrée de journal : cette option affiche l'entrée de journal dans le volet Résultats de la requête actuel et vous permet d'afficher l'entrée de journal épinglée dans le contexte de journaux à proximité.
  • Zoomer sur l'entrée de journal : cette option permet de limiter la période affichée dans le volet Histogramme et d'affiner votre requête pour isoler les journaux à proximité du journal épinglé.

Période de l'histogramme limitée.

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 : ouvre la page Détails de la ressource dans l'interface utilisateur de GKE ou de Compute Engine.

Affichage du menu "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 maintenant envoyer le lien aux utilisateurs qui ont 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. Sélectionnez Actions, puis Download Logs (Télécharger les journaux).

    Téléchargement des journaux à l'aide du bouton "Actions".

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

  3. Sélectionnez l'action à effectuer avec les données du 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

La page Exemples de requêtes utilisant l'explorateur de journaux fournit des suggestions de requêtes pour vous permettre de trouver des journaux susceptibles de vous intéresser. Par exemple, vous pouvez exécuter des requêtes liées à Kubernetes pour trouver les journaux Google Kubernetes Engine.

Dépannage

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

Obtenir l'ID du projet Cloud ou de l'organisation

Pour obtenir un ID de projet ou d'organisation Cloud n'importe où dans Google Cloud Console, développez la liste des projets Cloud du sélecteur de projet et d'organisation Cloud, 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 dans le sélecteur de projet Cloud et d'organisation.

  • 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 actuelles pour vous assurer que les journaux que vous recherchez ne sont pas exclus accidentellement.

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 est trop long et ne peut pas s'exécuter dans un délai raisonnable. Cela peut s'afficher comme "délai expiré avant la fin de l'opération". Essayez d'affiner votre requête 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 l'emplacement dans lequel des entrées ont été écrites pour cette ressource. Si Cloud Logging identifie plus de 200 buckets dans lesquels des entrées ont pu être écrites, la requête échoue avec le message Error: Invalid query.

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

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

Les données de journaux affichées dans les volets Résultats de la requête et Champs de journal s'ajustent 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. Le réglage de ces commandes temporelles ne modifie pas l'expression de requête dans le volet Générateur de requêtes.

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.