Lister et représenter des métriques basées sur les journaux

Ce document explique comment répertorier et représenter des métriques basées sur les journaux à l'aide de la console Google Cloud. Pour en savoir plus sur la création de métriques basées sur les journaux, consultez les pages Configurer des métriques de compteur et Configurer des métriques de distribution.

Avant de commencer

Assurez-vous que votre rôle Identity and Access Management inclut les autorisations requises pour créer et afficher des métriques basées sur les journaux, ainsi que pour créer des règles d'alerte. Pour en savoir plus, consultez la section Autorisations pour les métriques basées sur les journaux.

Lister les métriques basées sur les journaux

Pour afficher la liste des métriques basées sur les journaux de votre projet Google Cloud, procédez comme suit :

  1. Dans le panneau de navigation de la console Google Cloud, sélectionnez Logging, puis Métriques basées sur les journaux :

    Accéder à la page Métriques basées sur les journaux

  2. Sélectionnez un projet Google Cloud existant. L'interface des métriques basées sur les journaux affiche deux listes de types de métriques : Métriques système et Métriques définies par l'utilisateur.

    Le volet Métriques définies par l'utilisateur de l'interface des métriques basées sur les journaux présente plusieurs fonctionnalités pour vous aider à gérer les métriques définies par l'utilisateur dans votre projet Google Cloud:

    • Le tableau des métriques définies par l'utilisateur comprend les colonnes Name (Nom), Description, Type et Filter (Filtre). Ces champs sont spécifiés lorsque vous créez la métrique.

    • Le volet Filtrer les métriques définies par l'utilisateur vous permet de filtrer votre liste de métriques par recherche textuelle ou selon le nom, la description et le filtre de la métrique.

    • Le tableau des métriques définies par l'utilisateur comprend les colonnes Utilisation du mois précédent et Utilisation mensuelle (début du mois à ce jour). Ces données d'utilisation sont utiles, par exemple, si vous souhaitez déterminer quelles métriques ingèrent le plus de données ou pour estimer vos factures.

    Le menu Plus pour chaque métrique du volet des métriques définies par l'utilisateur contient des fonctionnalités supplémentaires pour gérer vos métriques:

    Options de menu à développer du volet des métriques basées sur les journaux définies par l'utilisateur

    • Afficher les détails de la métrique : indique le nom, le type, la description, le filtre, les unités et les libellés, le cas échéant.
    • Modifier la métrique : permet de modifier certains champs de la métrique.
    • Désactiver la métrique : permet d'arrêter le calcul de la métrique. Vous pouvez réactiver une métrique désactivée à partir de ce même menu.
    • Supprimer la métrique : permet de supprimer la métrique.
    • Afficher les journaux pour la métrique: accédez à l'explorateur de journaux, renseigne le filtre de métrique dans le générateur de requêtes, puis exécute la requête.
    • Afficher dans l'explorateur de métriques: permet de représenter la métrique sous forme de graphique.
    • Créer une alerte à partir de la métrique: permet de configurer des notifications lorsqu'une métrique basée sur les journaux correspond aux critères que vous spécifiez. Pour en savoir plus, consultez la section Alerte sur les métriques basées sur les journaux.

Graphiques sur les métriques basées sur les journaux

Pour créer un graphique d'une métrique basée sur les journaux, procédez comme suit:

  1. Dans le panneau de navigation de la console Google Cloud, sélectionnez Logging, puis Métriques basées sur les journaux :

    Accéder à la page Métriques basées sur les journaux

  2. Recherchez la métrique que vous souhaitez afficher, puis sélectionnez Afficher dans l'explorateur de métriques dans le menu Plus de la métrique .

    L'explorateur de métriques s'ouvre et est préconfiguré. Toutefois, vous pouvez modifier certains paramètres du graphique.

    Par exemple, la capture d'écran suivante montre un graphique de la métrique système nommé byte_count pour un projet Google Cloud particulier:

    Explorateur de métriques affichant la métrique système nommée byte_count.

    L'entrée Agrégation indique que chaque série temporelle sur le graphique correspond à la somme des octets écrits dans un journal spécifique. Dans l'exemple précédent, le projet contient plusieurs journaux. Le graphique affiche donc plusieurs séries temporelles.

    Pour afficher les données d'un journal spécifique, ajoutez un filtre. Par exemple, pour afficher la métrique byte_count pour les entrées de journal écrites par BigQuery, cliquez sur Ajouter un filtre, sélectionnez log, puis sélectionnez l'entrée BigQuery. Le graphique affiche à présent une seule série temporelle, qui indique le nombre total d'octets de journaux écrits par BigQuery. Si vous souhaitez afficher la métrique byte_count selon la gravité de l'entrée de journal, remplacez None par Gravité dans le deuxième menu de l'entrée Agrégation. Le graphique suivant présente la métrique byte_count affichée par niveau de gravité pour les journaux écrits par BigQuery:

    Explorateur de métriques affichant la métrique byte_count par niveau de gravité pour les instances BigQuery

  3. Pour les métriques basées sur les journaux à valeur de distribution, développez Graphique en courbes et sélectionnez Graphique de carte de densité.

    Pour en savoir plus sur les métriques de valeur de distribution, consultez Métriques de distribution et Centiles et métriques de valeur de distribution.

  4. Facultatif: Pour enregistrer le graphique pour le consulter ultérieurement, cliquez sur Enregistrer le graphique dans la barre d'outils, puis terminez la boîte de dialogue. Vous pouvez enregistrer le graphique dans un tableau de bord existant ou en créer un.

Étapes suivantes