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 Cloud Monitoring et les règles d'alerte.

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 les buckets de journaux ni pour d'autres ressources Google Cloud, telles que les comptes ou les organisations Cloud Billing.

Avant de commencer

Pour utiliser des métriques basées sur les journaux, vous devez disposer d'un projet Cloud avec la facturation activée:

  1. Dans Google Cloud Console, accédez à la page de sélection du projet.

    Accéder au sélecteur de projet

  2. Pour commencer à créer un projet Google Cloud, cliquez sur Créer un projet.

  3. Attribuez un nom à votre projet. Notez l'ID de projet que vous avez généré.

  4. Modifiez les autres champs si nécessaire.

  5. Pour créer le projet, cliquez sur Créer.

Assurez-vous que la facturation est activée pour votre projet Cloud. Découvrez comment vérifier que la facturation est activée pour votre projet.

Pour vérifier que vous disposez des autorisations nécessaires pour utiliser les métriques basées sur les journaux pour le projet Cloud, consultez la section Guide de contrôle des accès: métriques basées sur les journaux.

Affichez 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. Elle contient les listes de 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 de 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 est divisée en deux volets de type métriques : les métriques système et les métriques définies par l'utilisateur.

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

  • L'option Afficher dans l'explorateur de métriques vous permet d'afficher les données d'une métrique basée sur les journaux système en ouvrant l'explorateur de métriques dans 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 Créer une alerte à partir de la métrique vous 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 plus d'informations sur la création de règles d'alerte pour vos métriques basées sur des journaux, consultez la section Créer une règle d'alerte.

Volet de 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 sur votre projet Cloud:

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

  • àFiltrer les métriques définies par l'utilisateur permet de filtrer la liste des métriques par recherche textuelle ou par métriqueNom ;Description etFiltrer (Installation de Python groupée).

  • Le tableau des métriques définies par l'utilisateur inclut 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 le montant de vos factures.

Vous pouvez cliquer sur les noms des colonnes pour trier les données par ordre croissant ou décroissant.

Le menu de chaque métrique du volet des métriques définies par l'utilisateur contient des fonctionnalités supplémentaires pour la gestion des métriques:

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

  • Afficher les détails de la métrique: indique le nom, le type, la description et le filtre{ de la métrique. /1}, Units et Labels, si définis.
  • Modifier la statistique: permet de modifier certains champs de la statistique
  • 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 statistique.
  • Afficher les journaux de la métrique: vous accédez à 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.

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

Les métriques système basées sur les journaux ne sont calculées qu'à partir des journaux inclus. 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 rétroactivement renseignée avec les données des entrées de journal déjà présentes dans Logging.

Logging accumule des informations pour 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 de 1 point de données par minute, ce qui rend les données disponibles pour 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 type compteur ou distribution. La plupart des métriques basées sur les journaux définies par le système sont des compteurs, mais certaines sont de 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é. Par exemple, vous pouvez effectuer les opérations suivantes:

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

    ... user USERNAME called OPERATION ...

    En extrayant USERNAME et OPERATION et en les utilisant comme valeurs pour deux étiquettes, vous pouvez ensuite demander "Combien de fois sally a-t-il appelé update ?", "Combien de personnes ont appelé l'opération read ?", "Combien de fois une opération george a-t-elle été appelée ?".

Pour en savoir plus, consultez la section Configurer 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 contiennent 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 visualisation, consultez la page Représentation graphique des métriques de distribution.

Pour plus d'informations sur la création de métriques basées sur les journaux de distribution, consultez la page Configurer les métriques de distribution.

Libellés

Les métriques basées sur les journaux peuvent comporter des libellés, qui permettent 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é.

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 pour les métriques définies par l'utilisateur. Pour en savoir plus, consultez la page 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 en savoir plus sur la création et la gestion de métriques définies par l'utilisateur à l'aide de Cloud Console, consultez les pages Configurer des métriques de compteur et Configurer des métriques de distribution. (Installation de Python groupée).

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 qui se sont produits au cours d'une période spécifique. Les métriques comportent des libellés qui enregistrent les décomptes par nom de journal et par niveau de gravité.

Pour obtenir la liste de ces métriques, consultez la section 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 en savoir plus, consultez Configurer des graphiques et des alertes.

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

  • Système: logging.googleapis.com/SYSTEM_METRIC_NAME
  • Défini par l'utilisateur: logging.googleapis.com/user/USER_METRIC_NAME

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

Tarifs

Les métriques basées sur les journaux définies par l'utilisateur sont une classe de 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 de métriques basées sur les journaux, consultez la page Résoudre les problèmes liés aux métriques basées sur les journaux.