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

Les métriques basées sur les journaux sont des métriques Stackdriver Monitoring basées sur le contenu des entrées de journal. Les métriques peuvent, par exemple, enregistrer le nombre d'entrées de journal contenant des messages particuliers ou extraire des données 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 Stackdriver Monitoring.

Les métriques (basées sur les journaux) système sont prédéfinies par Stackdriver Logging. Elles enregistrent le nombre d'événements de journalisation survenus au cours d'une période donnée.

Les métriques (basées sur les journaux) définies par l'utilisateur sont créées par un utilisateur sur un projet. Elles comptent le nombre d'entrées de journal correspondant à un filtre donné ou effectuent le suivi de valeurs particulières dans les entrées de journal correspondantes.

Stackdriver Logging accumule des informations sur les métriques basées sur les journaux à chaque réception d'une entrée de journal correspondante. Stackdriver Logging écrit régulièrement 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 Stackdriver Monitoring.

Les données relatives aux métriques basées sur les journaux proviennent des entrées de journal reçues après la création des métriques. Les métriques ne sont pas renseignées avec les données des entrées de journal qui sont déjà présentes dans Stackdriver Logging.

Premiers pas

  1. Accédez à la page Stackdriver Logging > Métriques basées sur les journaux dans la console GCP :

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

  2. Sélectionnez un projet GCP en haut de la page. La liste des métriques basées sur les journaux s'affiche dans votre projet GCP :

UI des métriques basées sur les journaux

Interface des métriques basées sur les journaux

L'interface des métriques basées sur les journaux se compose de deux zones, chacune dédiée à un type de métriques : les métriques système et les métriques définies par l'utilisateur.

Ces deux zones comportent un tableau récapitulatif des métriques. Chaque ligne du tableau comporte un menu à développer situé tout à droite et inclut les options suivantes :

UI des métriques basées sur les journaux

  • 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 Stackdriver 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. Notez que cette option n'est disponible que s'il s'agit d'une métrique de compteur.

    Cette option permet d'ouvrir la console Stackdriver Monitoring, dans laquelle vous pouvez créer, modifier et gérer des règles d'alerte. Pour en savoir plus, consultez la section Créer une règle d'alerte.

Interface des métriques définies par l'utilisateur

Dans l'interface des métriques basées sur les journaux, la zone User-defined metrics (Métriques définies par l'utilisateur) comporte plusieurs fonctionnalités supplémentaires pour vous aider à gérer les métriques définies par l'utilisateur sur un projet :

  • 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 lors de la création de la métrique.

  • Le champ Filter Metrics (Filtrer les métriques), situé au-dessus du tableau des 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 du filtre de la métrique :

UI des métriques basées sur les journaux

  • 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 Usage (MTD) (Utilisation (début du mois à ce jour)). Ces métriques d'utilisation sont utiles, par exemple, si vous voulez savoir quelles métriques ingèrent le plus de données ou si vous souhaitez estimer vos factures.

  • Vous pouvez modifier la métrique ou la supprimer en utilisant les menus à développer situés au bout des lignes du tableau.

Vous pouvez par ailleurs cliquer sur l'un des noms de colonne 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.

Pour plus d'informations sur la gestion des métriques définies par l'utilisateur à l'aide de la console GCP, consultez les pages Créer des métriques de compteur et Créer des métriques de distribution.

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

Il existe deux types de métriques Stackdriver Logging basées sur les journaux : compteur ou distribution. Toutes les métriques basées sur les journaux système sont de type compteur. Les métriques basées sur les journaux définies par l'utilisateur peuvent être de type compteur ou de type distribution.

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 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 de journaux avancé. Par exemple, vous pouvez effectuer les opérations suivantes :

  • Créer une métrique qui compte les entrées de journal contenant un certain message d'erreur
  • Compter le nombre de fois où chaque utilisateur appelle une opération, en recherchant des messages de journal tels que celui-ci :

    ... 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é l'opération 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 plus 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é : Sommei=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 Stackdriver Monitoring, à intervalles réguliers.

Pour plus d'informations, consultez la page Créer des métriques de distribution.

Libellés

Les métriques basées sur les journaux peuvent également comporter des libellés permettant à une seule métrique de contenir plusieurs séries temporelles. Les valeurs des libellés sont extraites des champs des entrées de journal correspondantes. Stackdriver Logging enregistre des séries temporelles distinctes pour chacune des valeurs de votre libellé.

Les métriques basées sur les journaux système présentent des libellés prédéfinis. Pour les métriques définies par l'utilisateur, vous pouvez définir vos propres libellés. Pour plus d'informations, consultez la page Libellés de métriques basées sur les journaux.

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

Stackdriver Logging fournit des métriques de compteur prédéfinies permettant de suivre le nombre et le volume des entrées de journal reçues. Les métriques comportent des libellés qui enregistrent les décomptes selon le nom de journal ou le niveau de sévérité. Le tableau suivant répertorie les métriques :

Nom et description de la métrique Type Valeur Libellés
logging.googleapis.com/log_entry_count

Nombre total d'entrées de journal reçues.

delta int64 log : nom du journal. Exemple : "appengine.googleapis.com/request_log".

severity : sévérité des entrées de journal. Exemple : "ERROR".

logging.googleapis.com/byte_count

Nombre total d'octets reçus dans les entrées de journal.

delta int64 log : nom du journal. Exemple : "appengine.googleapis.com/request_log".
logging.googleapis.com/excluded_log_entry_count

Nombre total d'entrées de journal qui ont été exclues.

delta int64
logging.googleapis.com/excluded_byte_count

Nombre total d'octets reçus dans les entrées de journal qui ont été exclues.

delta int64
logging.googleapis.com/exports/log_entry_count

Nombre total d'entrées de journaux exportées à l'aide de récepteurs.

delta int64
logging.googleapis.com/exports/byte_count

Nombre total d'octets dans les entrées de journal exportées à l'aide de récepteurs.

delta int64
logging.googleapis.com/exports/error_count

Nombre total d'entrées de journal non exportées en raison d'erreurs de configuration.

delta int64
logging.googleapis.com/logs_based_metrics_error_count

Nombre d'entrées de journal tardives.1

delta int64 log : nom du journal. Exemple : "appengine.googleapis.com/request_log".

1 Les entrées de journal tardives ne sont pas incluses dans les métriques log_entry_count et byte_count.

Pour obtenir une liste complète des métriques basées sur les journaux système, consultez la section relative à la journalisation des métriques.

Stackdriver Monitoring

Les métriques basées sur les journaux, tant les métriques système que les métriques définies par l'utilisateur, peuvent être utilisées dans Stackdriver Monitoring pour créer des graphiques et des règles d'alerte. Le nom des métriques basées sur les journaux définies par l'utilisateur porte le préfixe user/, tandis que le nom des métriques basées sur les journaux système n'a aucun préfixe.

Si vous utilisez l'API Stackdriver Monitoring, les noms des métriques basées sur les journaux sont les suivants :

logging.googleapis.com/user/[USER_METRIC_NAME]
logging.googleapis.com/[SYSTEM_METRIC_NAME]

Pour plus d'informations, consultez la page Créer des graphiques et des alertes.

Dépannage

La métrique ne contient pas de données de journal

L'absence de données dans les métriques basées sur les journaux peut s'expliquer par les raisons suivantes :

  • Les nouvelles entrées de journal ne correspondent peut-être pas au filtre de journaux de la métrique. Une métrique basée sur les journaux récupère les données des entrées de journal correspondantes reçues après la création de la métrique. Stackdriver Logging ne remplit pas la métrique à partir des entrées de journal précédentes.

  • Les nouvelles entrées de journal ne contiennent peut-être pas le champ correct, ou les données ne sont peut-être pas au format attendu pour l'extraction par votre métrique de distribution. Vérifiez que les noms des champs et les expressions régulières sont corrects.

  • Les décomptes de votre métrique sont peut-être retardés. Même si des entrées de journal devant être comptabilisées s'affichent dans la visionneuse de journaux, la mise à jour des métriques basées sur les journaux dans Stackdriver Monitoring peut prendre jusqu'à une minute.

  • Les entrées de journal affichées peuvent être comptabilisées en retard ou ne pas être comptabilisées du tout, car elles sont horodatées trop loin dans le passé ou le futur. Si une entrée de journal est reçue plus de 10 minutes avant ou après, elle ne sera pas comptabilisée dans la métrique basée sur les journaux.

    Le nombre d'entrées tardives est enregistré pour chaque journal dans la métrique basée sur les journaux système, logging.googleapis.com/logs_based_metrics_error_count.

    Exemple : Une entrée de journal correspondant à une métrique basée sur les journaux arrive en retard. Son timestamp est 14h30, et son receivedTimestamp 14h45. Cette entrée ne sera pas comptabilisée dans la métrique basée sur les journaux.

La métrique comporte trop de séries temporelles

Il se peut qu'un libellé défini par l'utilisateur dans une métrique basée sur les journaux possède un grand nombre de valeurs uniques. Le nombre de séries temporelles d'une métrique dépend du nombre de combinaisons différentes des valeurs du libellé. Une cardinalité très élevée des valeurs du libellé risque de limiter la métrique et d'empêcher l'écriture de certains points de données dans la métrique. La métrique peut également mettre du temps à se charger dans les graphiques en raison du grand nombre de séries temporelles qu'elle doit traiter. De plus, les appels d'API exécutés afin d'interroger les données des séries temporelles peuvent entraîner des frais. Consultez la page des tarifs de Stackdriver Monitoring pour en savoir plus.

Pour éviter de créer des métriques avec une cardinalité élevée :

  • Vérifiez que les champs du libellé et les expressions régulières d'extracteur correspondent à des valeurs ayant une cardinalité limitée.

  • Évitez d'extraire des messages textuels longs qui risquent de changer sans limites en tant que valeurs de libellé.

  • Évitez d'extraire des valeurs numériques ayant une cardinalité illimitée.

  • N'extrayez que les valeurs de libellés ayant une cardinalité connue (par exemple, les codes d'état avec un ensemble de valeurs connues).

Le nom de la métrique n'est pas valide

Lorsque vous créez une métrique de compteur ou de distribution, choisissez un nom unique parmi les métriques basées sur les journaux de votre projet.

Les chaînes de nom de métrique ne doivent pas dépasser 100 caractères et ne peuvent contenir que les caractères suivants :

  • A-Z
  • a-z
  • 0-9
  • Caractères spéciaux _-.,+!*',()%\/

    La barre oblique / représente une arborescence d'éléments et ne peut donc pas être le premier caractère du nom.

La valeur des libellés est tronquée

La valeur des libellés définis par l'utilisateur ne doit pas dépasser 1 024 octets.

Cette page vous a-t-elle été utile ? Évaluez-la :

Envoyer des commentaires concernant…

Stackdriver Logging
Besoin d'aide ? Consultez notre page d'assistance.