Cette page présente les concepts liés aux métriques basées sur les journaux.
Les métriques basées sur les journaux peuvent vous aider à observer des tendances et des modèles à grande échelle d'entrées de journal. Ces métriques sont issues des entrées de journal proviennent de votre projet Google Cloud ou sont acheminées un projet Google Cloud par un récepteur dans un autre projet. Par exemple, vous pouvez utiliser une métrique basée sur les journaux compter le nombre d'entrées de journal contenant un message particulier pour extraire les informations de latence enregistrées dans les entrées de journal. Vous pouvez afficher les métriques basées sur les journaux dans les graphiques Cloud Monitoring et les alertes peuvent surveiller ces métriques.
Si vous envisagez de créer une règle d'alerte pour surveiller une métrique basée sur les journaux, assurez-vous de bien comprendre les limites de cette approche. En particulier, avis Résoudre le problème: il manque des données de journaux dans les métriques.
Sources des métriques basées sur les journaux
Vous pouvez utiliser les métriques définies par Cloud Logging pour collecter des données d'utilisation générale et vous pouvez définir votre propre métrique basée sur les journaux propres à votre application ou à votre entreprise.
Les métriques basées sur les journaux peuvent s'appliquer dans un seul projet Google Cloud ou dans un journal bucket. Vous ne pouvez pas créer basées sur les journaux pour d'autres ressources Google Cloud comme des comptes de facturation Cloud ou des organisations.
Pour en savoir plus sur les différences entre les métriques basées sur les journaux basées sur un projet, et des métriques basées sur les journaux basées sur les buckets, consultez Métriques basées sur les journaux à l'échelle du bucket.
Métriques définies par le système
Logging fournit un ensemble de métriques pour les valeurs d'utilisation, le nombre d'entrées de journal stockées dans des buckets de journaux de votre projet ; le nombre d'octets exportés. Pour obtenir la liste complète des métriques définies par le système, consultez Métriques Google Cloud: journalisation.
Métriques définies par l'utilisateur
Vous pouvez créer des métriques basées sur les journaux définies par l'utilisateur suivre d'autres métriques importantes pour votre projet. Par exemple, vous pouvez créer une métrique basée sur les journaux pour compter le nombre d'entrées de journal correspondant à un filtre donné.
Par défaut, les métriques basées sur les journaux définies par l'utilisateur sont calculées à partir de tous les journaux reçues par l'API Logging pour le projet Google Cloud, quels que soient les filtres d'inclusion ou filtres d'exclusion pouvant s'appliquer projet Google Cloud.
Vous pouvez aussi créer des métriques basées sur les journaux définies par l'utilisateur pour un bucket de journaux spécifique dans un projet Google Cloud. À l'échelle du bucket les métriques basées sur les journaux sont calculées à partir de tous les journaux destinés au bucket. quelle que soit leur origine. Pour en savoir plus, consultez Métriques basées sur les journaux sur les buckets de journaux.
Types de données pour les métriques basées sur les journaux
Les métriques basées sur les journaux peuvent extraire des données des journaux pour créer des métriques types suivants:
- Compteur: ces métriques comptent le nombre d'entrées de journal correspondant à le filtre spécifié au cours d'une période donnée. Utilisez des compteurs pour conserver le nombre d'occurrences d'une valeur ou d'une chaîne dans vos journaux.
- Distribution: ces métriques comptent aussi les valeurs, mais elles collectent le les décomptes dans des plages de valeurs (buckets d'histogramme). Utilisez les distributions lorsque vous vous voulez extraire des valeurs telles que les latences.
- Booléen: ces métriques capturent si une entrée de journal correspond ou non à un filtre.
Les métriques basées sur les journaux définies par l'utilisateur peuvent être de type compteur ou de type distribution. La plupart des métriques basées sur les journaux définies par le système sont des compteurs, mais certaines le type booléen. Les caractéristiques des compteurs et des distributions sont décrits plus en détail dans les sections suivantes.
Les données d'une métrique basée sur les journaux définie par l'utilisateur proviennent uniquement des entrées de journal reçues après la création de la métrique. Une métrique n'est pas rétroactive contenant des données provenant d'entrées de journal déjà présentes dans Logging.
Les métriques basées sur les journaux système ne sont calculées qu'à partir des journaux inclus. Définies par l'utilisateur Les métriques basées sur les journaux sont calculées à partir des journaux inclus et exclus.
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 dans 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 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 :
- Compter 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 journaux 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é l'opérationupdate
?, "Combien de personnes ont appelé l'opérationread
?", "Combien de fois l'utilisateurgeorge
a-t-il appelé une opération ?", etc.
Pour en savoir plus, consultez la page Configurer les 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 la façon dont elles sont visualisées, consultez Représentation graphique des métriques de distribution
Pour en savoir plus sur la création de métriques de distribution basées sur les journaux, consultez Configurez les métriques de distribution.
Types de ressources
Nous vous recommandons de spécifier un seul type de ressource pour vos métriques basées sur les journaux. Cette spécification garantit que les données de séries temporelles générées pour votre la métrique basée sur les journaux correspond au modèle de données attendu par Cloud Monitoring. Il simplifie également le processus de création de graphiques et de règles d'alerte, il n'y a pas d'ambiguïté quant à la façon dont les données des séries temporelles sont représentées graphiquement ou surveillées.
Prenons l'exemple d'une métrique basée sur les journaux avec le filtre suivant:
severity>="ERROR"
resource.type="gce_instance"
Cloud Monitoring reconnaît que ces données sont destinées à une Compute Engine de VM Compute Engine. Par conséquent, lorsque vous créez un graphique pour une instance de VM, la métrique basée sur les journaux est répertoriée en tant qu'option dans les menus. Lorsque vous créer un graphique pour un autre type de ressource, la métrique basée sur les journaux n'est pas proposée.
Si vous créez une métrique basée sur les journaux sans spécifier de type de ressource, alors Monitoring répertorie votre métrique basée sur les journaux comme option pour plusieurs types de ressources, même si vous ne comptez pas les entrées de ces ressources.
Étiquettes
Les métriques basées sur les journaux peuvent comporter des libellés permettant la collecte de 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.
Toutes les métriques basées sur les journaux fournissent un libellé log
par défaut.
Ce libellé contient la valeur de la partie LOG_ID de
Champ logName
dans l'entrée de journal, par exemple
cloudresourcemanager.googleapis.com%2Factivity
Les métriques basées sur les journaux système sont prédéfinies des étiquettes qui ne peuvent pas être modifiées. Toutefois, vous pouvez personnaliser les libellés définies par l'utilisateur. Par exemple, vous pouvez utiliser des étiquettes dans la métrique basée sur les journaux pour enregistrer le dossier organisation d'où provient une entrée de journal, même si elle est définie à l'échelle du bucket Vous ne pouvez pas créer de métriques basées sur les journaux pour des dossiers ou des organisations. Pour plus consultez la section Libellés de métriques basées sur les journaux.
Graphiques et règles d'alerte dans 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 plus consultez Répertorier et représenter les métriques basées sur les journaux sous forme de graphiques et Alerte sur les métriques basées sur les journaux.
Dans Cloud Monitoring, les métriques basées sur les journaux utilisent les modèles de dénomination suivants :
- Système :
logging.googleapis.com/SYSTEM_METRIC_NAME
- Définies par l'utilisateur :
logging.googleapis.com/user/USER_METRIC_NAME
Notez que les métriques basées sur les journaux définies par l'utilisateur incluent la chaîne user
.
Visibilité sur les champs d'application des métriques Monitoring
Les métriques basées sur les journaux sont ingérées par Cloud Monitoring. La visibilité des données de métriques à un projet Google Cloud est déterminé par un champ d'application des métriques. Un champ d'application des métriques est une liste de projets surveillés par le projet qui héberge le champ d'application des métriques, le projet d'hébergement s'appelle projet dédié à la surveillance.
Par défaut, chaque projet héberge un champ d'application de métriques qui ne comprend que lui-même, de sorte qu'un projet est un projet effectuant une surveillance à lui-même. Par conséquent, vos métriques, y compris celles basées sur les journaux, ne sont visibles que par vos projet Google Cloud.
Vous pouvez également créer un champ d'application de métriques multiprojets pour de surveillance. Avec un champ d'application des métriques multiprojets, projet effectuant une surveillance peuvent voir les métriques de tous les projets dans le champ d'application des métriques. Ce qui est visible par les projets individuels dans un le champ d'application des métriques multiprojets est déterminé par le champ d'application des métriques hébergés par chacun de ces projets. Le fait que deux projets le champ d'application des métriques multiprojets ne signifie pas que chaque projet a accès les données de métrique ou de configuration de l'autre projet.
Un même projet peut également apparaître dans plusieurs champs d'application des métriques. Les métriques d'un tel projet sont visibles les projets effectuant une surveillance de chacun de ces champs d'application des métriques.
Les métriques, y compris celles basées sur les journaux, sont définies dans un projet spécifique. Lorsque ce projet apparaît dans plusieurs champs d'application des métriques, les métriques sont visibles pour les projets autres que celui dans lequel elles sont définis. Pour en savoir plus sur la manière dont les champs d'application des métriques et les métriques basées sur les journaux à l'échelle du bucket les métriques interagissent, consultez la section Projets et champs d'application des métriques.
Pour plus d'informations sur les champs d'application des métriques, y compris les champs d'application de métriques multiprojets et les projets de champ d'application, consultez les pages suivantes :
Tarifs
Toutes les métriques basées sur les journaux définies par l'utilisateur sont une classe les métriques personnalisées Cloud Monitoring sont payantes. Pour obtenir des informations sur les tarifs, consultez la page Tarifs de Cloud Logging: métriques basées sur les journaux.
Quota
Pour en savoir plus sur les quotas et les limites associés aux basées sur les journaux, consultez la page Quotas et limites.
Dépannage
Si vous rencontrez des problèmes lors de l'utilisation des 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.