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

Ce document explique comment répertorier des métriques basées sur les journaux et les représenter sous forme graphique à 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.

Répertorier 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 lors de la création de 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 par Nom, Description et Filtre de la métrique.

    • Le tableau des métriques définies par l'utilisateur comprend les colonnes Utilisation au cours du 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 les métriques qui ingèrent le plus de données ou pour estimer 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 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 du même menu.
    • Supprimer la métrique : permet de supprimer la métrique.
    • Afficher les journaux pour la métrique: vous permet d'accéder à l'explorateur de journaux, de renseigner le filtre de la métrique dans le générateur de requêtes et d'exécuter la requête.
    • Afficher dans l'explorateur de métriques: permet de représenter la métrique dans un 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 Envoyer une alerte sur les métriques basées sur les journaux.

Représenter les métriques basées sur les journaux dans des graphiques

Pour créer un graphique pour 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 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 portant le nom 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 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 journal, puis sélectionnez l'entrée BigQuery. Le graphique affiche maintenant 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, modifiez le deuxième menu de l'entrée Aggregation (Agrégation) de None (Aucun) à Severity (Gravité). 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 basées sur la distribution, développez Graphique en courbes et sélectionnez Carte de densité.

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

  4. Facultatif: Pour enregistrer le graphique afin de vous y référer ultérieurement, cliquez sur Save chart (Enregistrer le graphique) dans la barre d'outils, puis remplissez les champs de la boîte de dialogue. Vous pouvez enregistrer le graphique dans un tableau de bord existant ou en créer un.

Étapes suivantes