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 les métriques de compteur et Configurer les 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 les 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 la console Google Cloud, accédez à la page Métriques basées sur les journaux:

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

    Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Logging (Journalisation).

  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 comporte 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 la liste des métriques par recherche textuelle ou par nom, description et filtre de la métrique.

    • Le tableau des métriques définies par l'utilisateur comprend des colonnes Utilisation pour le mois précédent et Utilisation depuis le début du mois. 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 "Métriques définies par l'utilisateur" contient des fonctionnalités supplémentaires permettant de 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: cette option vous permet d'accéder à l'explorateur de journaux, d'insérer le filtre de métrique dans le générateur de requêtes, puis d'exécuter 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.

Graphique des métriques basées sur les journaux

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

  1. Dans la console Google Cloud, accédez à la page Métriques basées sur les journaux:

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

    Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Logging (Journalisation).

  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é pour vous. 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ée 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 Aggregation (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 désormais une seule série temporelle, qui indique le total des octets de journaux écrits par BigQuery. Si vous souhaitez afficher la métrique byte_count en fonction de la gravité de l'entrée de journal, remplacez la valeur None (Aucune) par Gravité dans le deuxième menu de l'entrée Agrégation. Le graphique suivant montre 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 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 complétez la boîte de dialogue. Vous pouvez enregistrer le graphique dans un tableau de bord existant ou en créer un.

Étapes suivantes