Interface de la visionneuse de journaux (Aperçu)

Avant de commencer

Vous n'avez pas besoin d'un espace de travail pour utiliser Logging, sauf si vous envoyez des journaux d'Amazon Web Services (AWS) à Logging.

Si vous utilisez un espace de travail, Logging ne combine pas les journaux des projets Google Cloud surveillés. Vous devez sélectionner un projet Cloud spécifique pour afficher ses journaux.

Si vous utilisez un espace de travail et AWS, sélectionnez le projet de connecteur AWS pour afficher les journaux AWS.

Premiers pas

Pour accéder à la visionneuse de journaux (aperçu), procédez comme suit :

  1. Accédez au menu de navigation Google Cloud , puis sélectionnez Journaux > Visionneuse de journaux :
    Accéder à la visionneuse de journaux.
  2. Sélectionnez un projet Google Cloud.
  3. Dans le menu de l'outil de sélection des versions, passez de la version Classic (Classique) de la visionneuse de journaux à la version Preview the new log viewer (Aperçu de la nouvelle visionneuse de journaux).

Vous êtes maintenant dans la visionneuse de journaux (aperçu).

Interface de la visionneuse de journaux

L'interface de la visionneuse 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 la visionneuse de journaux

  1. Page de la visionneuse de journaux : permet de créer, d'analyser et d'affiner des requêtes.
  2. Sélecteur d'organisation et de projet : permet d'afficher les journaux au niveau de l'organisation ou du projet.
  3. Générateur de requêtes : permet de créer des requêtes à l'aide des menus déroulants ou du langage de création de requêtes. Il comporte également un onglet permettant d'afficher vos requêtes enregistrées.
  4. Explorateur de champs de journaux (bêta) : permet d'afficher les résultats basés sur l'agrégation pour les champs resource.type, resource.labels, logName et severity, et fournit une méthode plus efficace pour affiner une requête.
  5. Histogramme : permet de visualiser la fréquence des données de vos journaux.
  6. Résultats de la requête : cette option vous permet d'afficher les journaux récupérés à partir de votre requête.
  7. Entrées de journal : permet d'afficher les entrées de journal au format JSON structuré.
  8. Fuseau horaire : permet de modifier le fuseau horaire dans lequel les journaux sont affichés.
  9. Mise en page : permet d'activer et de désactiver les panneaux Histogramme et Explorateur de champs de journaux.
  10. Sélecteur de fuseau horaire : permet de restreindre les résultats par période. La période défaut est d'une heure.
  11. Exécuter la requête : permet d'exécuter vos requêtes après les avoir créées dans le volet du Générateur de requêtes.
  12. 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.
  13. Actions : vous permet d'effectuer certaines actions dans vos journaux, comme la création d'une métrique basée sur les journaux ou d'une destination de récepteur.
  14. 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.
  15. 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.
  16. Développer ou réduire les champs de journal imbriqués : permet de développer ou de réduire les champs imbriqués.
  17. Copier dans le Presse-papiers : permet de copier l'entrée de journal au format JSON.

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 :

  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.

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

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.

La visionneuse 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

  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.

Panneau Explorateur de champs de journaux

Le panneau Explorateur de champs de journaux offre une synthèse brève des données de journaux et permet d'affiner plus efficacement une requête. Il indique le nombre d'entrées de journal, triées par nombre décroissant, pour le champ de journal donné. Le nombre de champs du journal correspond à la période utilisée par le panneau Histogramme.

L'explorateur de champs de journaux est renseigné et mis à jour en fonction d'une requête exécutée. Lorsqu'une requête est vide, le panneau Explorateur de champs de journaux affiche le nombre d'entrées de journal par type de ressource et par niveau de gravité.

Utiliser le panneau Explorateur de champs de journaux

Vous pouvez ajouter des champs du panneau Explorateur de champs de journaux au générateur de requêtes pour limiter et affiner une requête. Pour ce faire, cliquez sur une valeur de champ dans le panneau Explorateur de champs de journaux. Cette opération ajoute le champ de journal au générateur de requêtes et exécute automatiquement la requête en l'ajoutant comme expression à la requête d'origine à l'aide de l'opérateur AND.

Lorsqu'une requête est exécutée, le nombre de champs de journal est chargé de manière incrémentale au fur et à mesure de l'analyse des entrées de journal. Une fois la requête terminée (soit une fois que la barre de progression bleue est remplie), le nombre total de champs de journal s'affiche.

Panneau d'histogramme

Le panneau d'histogramme vous permet de visualiser la répartition des journaux au fil du temps. Vous pouvez ainsi identifier plus facilement les tendances dans vos données de journaux et résoudre les problèmes.

Activer le panneau d'histogramme

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

La mise en page est ouverte et l'option

Pour désactiver le panneau d'histogramme, décochez la case Histogram.

Utiliser le panneau d'histogramme

Un histogramme est généré lorsque vous exécutez une requête. Il affiche la fréquence des entrées de journal correspondantes pour la période sélectionnée.

Analyser des journaux

Pour analyser vos données de journal, passez la souris sur une barre du panneau Histogram et sélectionnez Jump to time (Aller à l'heure) pour afficher une période plus courte. Cette requête exécute une nouvelle requête avec cette restriction de période.

Les histogrammes des journaux affichent une boîte de dialogue contextuelle pour aller à l'heure

Dépannage

Cette section fournit des instructions permettant de résoudre des problèmes courants liés à l'utilisation de la visionneuse de journaux (aperçu).

Sélectionner un projet ou une organisation Cloud

Pour sélectionner un projet Cloud n'importe où dans Google Cloud Console, y compris dans la visionneuse de journaux (aperçu), utilisez le sélecteur de projet et d'organisation :

Un projet est sélectionné dans le menu déroulant.

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

Pour obtenir un ID de projet ou d'organisation Cloud n'importe où dans Google Cloud Console, développez la liste des projets du sélecteur de projet et d'organisation, puis recherchez l'ID du projet 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 est-il sélectionné ? Si ce n'est pas le cas, sélectionnez le bon projet dans le sélecteur de projet et d'organisation.

  • Votre projet 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 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.

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 Stackdriver 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 à Stackdriver Logging, ou lors de leur réception et de leur affichage.

  • La visionneuse 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.

Obtenir de l'aide

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