Façonnez l'avenir des opérations logicielles et faites entendre votre voix en répondant à l'enquête sur l'état du DevOps en 2021.

Présentation des métriques basées sur les journaux

Cette page présente les concepts liés aux métriques basées sur les journaux.

Les métriques basées sur les journaux sont basées sur le contenu des entrées de journal. Par exemple, les métriques peuvent enregistrer le nombre d'entrées de journal contenant des messages particuliers ou extraire des informations de latence signalées dans les entrées de journal. Vous pouvez utiliser des métriques basées sur les journaux dans les graphiques et les règles d'alerte de Cloud Monitoring.

Il existe deux types de métriques basées sur les journaux:

Les métriques basées sur les journaux ne s'appliquent qu'à un seul projet Google Cloud. Vous ne pouvez pas les créer pour des buckets de journaux ou pour d'autres ressources Google Cloud, telles que des comptes ou des organisations Cloud Billing.

Premiers pas

Pour vérifier que vous disposez des autorisations appropriées pour utiliser des métriques basées sur les journaux dans un projet Cloud, consultez la page Contrôle des accès de cette page.

Afficher les métriques basées sur les journaux

La page Métriques basées sur les journaux de Google Cloud Console vous permet de créer une métrique basée sur les journaux et de contenir toutes les métriques basées sur les journaux de votre projet Cloud.

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

  1. Accédez à la page Métriques basées sur les journaux dans Cloud Console:

    Accéder aux métriques basées sur les journaux

  2. Sélectionnez un projet Cloud existant. Les listes de métriques basées sur les journaux de votre projet Cloud s'affichent.

L'interface des métriques basées sur les journaux se compose de deux volets de type métrique : Métriques système et Métriques définies par l'utilisateur.

Chaque volet contient un tableau des métriques. La ligne de chaque métrique comporte un menu comportant les options suivantes:

  • L'option View in Metrics Explorer (Afficher dans l'explorateur de métriques) permet d'afficher les données d'une métrique basée sur les journaux système en ouvrant l'explorateur de métriques de Cloud Monitoring.

    Vous pouvez utiliser l'explorateur de métriques pour spécifier une métrique cible pour une règle d'alerte. Le graphique situé à côté de la région cible vous donne un aperçu visuel des données capturées par la métrique cible.

  • L'option Create alert from metric (Créer une alerte à partir de la métrique) permet de créer une règle d'alerte en fonction de la métrique basée sur les journaux.

    Cette option permet d'ouvrir la console Cloud Monitoring, dans laquelle vous pouvez créer, modifier et gérer des règles d'alerte. Pour en savoir plus sur la création de règles d'alerte pour vos métriques basées sur les journaux, consultez la section Créer une règle d'alerte.

Volet des 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 offre plusieurs fonctionnalités pour vous aider à gérer les métriques définies par l'utilisateur sur votre projet Cloud:

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

  • Le champ Filtrer les métriques définies par l'utilisateur permet de filtrer la liste des métriques par recherche textuelle ou en fonction du nom, de la description et de la Filtrer.

  • 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 au mois précédent). 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 faire une estimation de vos factures.

Vous pouvez cliquer sur les noms des colonnes pour trier les données par ordre croissant ou décroissant. Vous pouvez également sélectionner le nombre de lignes à afficher, en bas du tableau.

Le menu 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 du menu à développer dans le volet des métriques basées sur les journaux définies par l'utilisateur

  • Afficher les détails de la métrique: affiche les statistiquesNom ",Type ,Description ",Filtre ",Unités d'enseignement etÉtiquettes , le cas échéant.
  • Modifier la statistique: permet de modifier certains champs de la statistique.
  • Désactiver la statistique: permet d'empêcher le calcul de la statistique. Vous pouvez réactiver une métrique désactivée depuis le même menu.
  • Supprimer la métrique: permet de supprimer la métrique.
  • Afficher les journaux pour la métrique: cette option vous redirige vers l'explorateur de journaux et remplit le filtre de la métrique dans le Générateur de requêtes, et exécute la requête.

Présentation des types de métriques basés sur les journaux

Les métriques basées sur les journaux système sont calculées à partir des journaux inclus uniquement. Les métriques basées sur les journaux définies par l'utilisateur sont calculées à partir des journaux inclus et exclus.

Les données d'une métrique basée sur les journaux proviennent des entrées de journal reçues après la création d'une métrique. Une métrique n'est pas remplie de manière rétroactive avec les données des entrées de journal qui sont déjà présentes dans Logging.

Logging accumule des informations sur une métrique basée sur les journaux à chaque fois qu'il reçoit une entrée de journal correspondante. Logging écrit un nouveau point de données dans la série temporelle de la métrique (à un taux d'un point de données par minute), afin de mettre à disposition les données sur Cloud Monitoring.

Chaque point de données d'une série temporelle de métrique basée sur les journaux ne représente que les informations supplémentaires (le delta) reçues depuis le point de données précédent.

Les métriques basées sur les journaux définies par l'utilisateur peuvent être de types de métriques de compteur ou de distribution. La plupart des métriques basées sur les journaux définies par le système sont des compteurs, mais certaines sont du type booléen.

Les sections suivantes décrivent les caractéristiques des métriques de type compteur et de type distribution.

Métriques de compteur

Les métriques de compteur comptent le nombre d'entrées de journal correspondant à un filtre donné. Vous pouvez par exemple effectuer les opérations suivantes:

  • Comptez les entrées de journal contenant un certain message d'erreur.
  • Comptabiliser le nombre de fois qu'un utilisateur appelle une opération, en recherchant des messages de journal correspondant à ce modèle:

    ... user [USERNAME] called  [OPERATION] ...
    

    En extrayant [USERNAME] et OPERATION, et en les utilisant comme valeurs pour deux libellés, vous pouvez ensuite demander : "Combien de fois l'utilisateur sally a-t-il appelé la 101}UPDATE ?", "Combien de personnes ont appelé l'opération READ ?", "Combien de fois l'utilisateur george a-t-il appelé une opération ?", etc.

Pour obtenir davantage d'informations, consultez la page Créer des métriques de compteur.

Métriques de distribution

Les métriques de distribution accumulent des données numériques à partir des entrées de journal correspondant à un filtre. Les métriques comportent une série temporelle d'objets de distribution, chacun contenant les éléments suivants:

  • Un décompte du nombre de valeurs dans la distribution.
  • La moyenne des valeurs.
  • La somme des écarts au carré : Sumi=1..n(xi–moyenne)2
  • Un ensemble de buckets d'histogramme avec le nombre de valeurs dans chaque bucket. Vous pouvez utiliser la disposition de bucket par défaut ou choisir la vôtre.

Les métriques de distribution sont généralement utilisées pour suivre les latences. À la réception de chaque entrée de journal, une valeur de latence est extraite d'un emplacement quelconque de l'entrée de journal et ajoutée à la distribution. La distribution accumulée est écrite dans Cloud Monitoring, à intervalles réguliers.

Pour en savoir plus sur les distributions, y compris leur format dans une série temporelle et leur mode de visualisation, consultez la page Représenter les métriques de distribution.

Pour plus d'informations sur la création de métriques basées sur les journaux de distribution, consultez la section Créer des métriques de distribution.

Libellés

Les métriques basées sur les journaux peuvent comporter des libellés, ce qui permet de collecter plusieurs séries temporelles pour la métrique. Les valeurs des libellés sont extraites des champs des entrées de journal correspondantes. Logging enregistre des séries temporelles distinctes pour chaque combinaison de valeurs de libellés.

Les métriques basées sur les journaux système présentent des libellés prédéfinis. Vous pouvez définir les libellés des métriques définies par l'utilisateur. Pour obtenir davantage d'informations, consultez la section Libellés de métriques basées sur les journaux.

Métriques basées sur les journaux définies par l'utilisateur

Les métriques basées sur les journaux définies par l'utilisateur sont créées par un utilisateur sur un projet Google Cloud. Ces métriques comptent le nombre d'entrées de journal correspondant à un filtre donné ou enregistrent des valeurs particulières dans les entrées de journal correspondantes.

Pour plus d'informations sur la création et la gestion de métriques définies par l'utilisateur à l'aide de Cloud Console, consultez les pages Créer des métriques de compteur et Créer des métriques de distribution. s'affiche en haut de l'écran.

Métriques basées sur les journaux système

Logging fournit un ensemble de métriques incluant des compteurs. Les métriques de compteur enregistrent le nombre d'événements de journalisation survenus au cours d'une période donnée. Les métriques comportent des libellés qui enregistrent les décomptes par nom de journal et niveau de gravité.

Pour obtenir la liste de ces métriques, consultez la page Métriques Google Cloud: journalisation.

Cloud Monitoring

Les métriques basées sur les journaux, tant les métriques système que celles définies par l'utilisateur, peuvent être utilisées dans Cloud Monitoring pour créer des graphiques et des règles d'alerte. Pour obtenir plus d'informations, consultez la page Créer des graphiques et des alertes.

Dans Cloud Monitoring, les métriques basées sur les journaux utilisent les modèles de dénomination suivants:

  • Système: logging.googleapis.com/<var>SYSTEM_METRIC_NAME</var>
  • Définies par l'utilisateur: logging.googleapis.com/user/<var>...</var>

Notez que les métriques définies par l'utilisateur incluent la chaîne user.

Contrôle des accès

Pour afficher les métriques basées sur les journaux de votre projet Cloud, vérifiez que vous disposez du rôle et des autorisations appropriés.

Les rôles et autorisations de gestion de l'authentification et des accès régissent l'accès aux données Google Cloud. Voici un récapitulatif des rôles et autorisations dont un membre d'un projet Google Cloud peut avoir le plus souvent besoin pour accéder aux métriques basées sur les journaux :

  • Rédacteur de configuration des journaux/Logging (roles/logging.configWriter), pour pouvoir répertorier, créer, obtenir, mettre à jour et supprimer des métriques basées sur les journaux.

  • Lecteur de journaux/Logging (roles/logging.viewer), pour pouvoir afficher les métriques existantes. Vous pouvez également ajouter les autorisations logging.logMetrics.get et logging.logMetrics.list à un rôle personnalisé.

  • Lecteur Monitoring (roles/monitoring.viewer) vous permet de lire la série temporelle que contient la métrique basée sur les journaux. Vous pouvez également ajouter l'autorisation monitoring.timeSeries.list à un rôle personnalisé.

  • Administrateur Logging (roles/logging.admin )Éditeur de projet (roles/editor ) et Propriétaire de projet (roles/owner ) sont des rôles généraux qui contiennent l'autorisation de créer des métriques basées sur les journaux (logging.logMetrics.create ).

Pour plus d'informations sur les autorisations et les rôles, consultez le Guide du contrôle des accès.

Tarifs

Les métriques basées sur les journaux définies par l'utilisateur font partie des métriques personnalisées Cloud Monitoring et sont payantes.

Pour en savoir plus sur la tarification, consultez la section Tarifs de Cloud Logging: métriques basées sur les journaux.

Dépannage

Si vous rencontrez des problèmes lors de l'utilisation des métriques basées sur les journaux, consultez la page Dépannage.