Lister et créer des graphiques de métriques basées sur les journaux

Ce document explique comment lister et créer des graphiques à partir de 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 IAM (Identity and Access Management) inclut les autorisations requises pour créer et afficher des métriques basées sur les journaux, et 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.

  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 : les métriques système et les 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, par description et par filtre de métrique.

    • Le tableau des métriques définies par l'utilisateur comprend les colonnes Previous Month usage (Utilisation au cours du mois précédent) et Monthly-to-date usage (MTD) (Utilisation du 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 établir une estimation de vos factures.

    Le menu Plus de chaque métrique du volet des métriques définies par l'utilisateur contient des fonctionnalités supplémentaires de gestion des 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 du même menu.
    • Supprimer la métrique : permet de supprimer la métrique.
    • Afficher les journaux de la métrique: vous redirige vers l'explorateur de journaux, renseigne le filtre de la métrique dans le générateur de requêtes et 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 Alerte sur les métriques basées sur les journaux.

Créer un graphique de 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 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.

  2. Recherchez la métrique que vous souhaitez consulter, 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 du graphique est une 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 journal, puis sélectionnez l'entrée BigQuery. Le graphique affiche désormais une seule série temporelle, qui indique le nombre total d'octets de journal écrits par BigQuery. Si vous souhaitez afficher la métrique byte_count en fonction de la gravité de l'entrée de journal, définissez le deuxième menu de l'entrée Agrégation sur Gravité au lieu de Aucun. 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, puis sélectionnez Graphique de carte de densité.

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

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

Étape suivante