Types de valeurs et genres de métriques

Dans la discussion sur le modèle de métrique, la section Types de métriques fournit une discussion générale sur les attributs qui décrivent un type de métrique. Cette section présente plus en détail deux de ces attributs :

Type de valeur
Genre de métrique

Type de valeur

Le type de valeur est le type de données des mesures. Chaque série temporelle enregistre le type de valeur (type ValueType) pour ses points de données.

Pour les mesures composées d'une seule valeur à la fois, comme les valeurs booléennes et les données numériques, le type de valeur indique comment les données sont stockées :
- BOOL, une valeur booléenne
- INT64, un entier de 64 bits
- DOUBLE, un nombre à virgule flottante à double précision
- STRING, une chaîne
Pour les mesures de distribution, la valeur n'est pas une valeur unique, mais un groupe de valeurs. Le type de valeur pour les mesures de distribution est DISTRIBUTION.

Une distribution contient des statistiques qui résument un groupe de valeurs. Les valeurs d'une distribution incluent la moyenne, le nombre, le maximum et d'autres statistiques, calculés pour un groupe de valeurs. Une distribution peut également inclure un histogramme qui représente la manière dont les valeurs sont réparties sur un ensemble de plages.

Les métriques de latence capturent généralement les données sous forme de distribution. Pour en savoir plus sur les distributions, consultez la page de référence sur Distribution. Pour en savoir plus sur la représentation de ces métriques sous forme graphique, consultez Métriques de distribution.

Type de métrique

Chaque série temporelle inclut le genre de métrique (type MetricKind) pour ses points de données. Le genre de données de métrique indique comment interpréter les valeurs les unes par rapport aux autres. Les métriques Cloud Monitoring sont de trois genres :

Les métriques de gauge, dans lesquelles la valeur mesure un instant spécifique dans le temps. Par exemple, les métriques mesurant l'utilisation du processeur sont des métriques de jauge. Chaque point enregistre l'utilisation du processeur au moment de la mesure. La température actuelle est un autre exemple de métrique de jauge.
Les métriques delta, dans lesquelles la valeur mesure la modification dans un intervalle de temps. Pour les lectures, l'intervalle de temps est semi-ouvert, il exclut l'heure de début, mais inclut l'heure de fin: (startTime, endTime]. Par exemple, les métriques qui mesurent le nombre de requêtes sont des métriques delta. Chaque valeur enregistre le nombre de requêtes reçues après l'heure de début, jusqu'à l'heure de fin incluse.

Remarque :Toutes les métriques qui comptent des éléments distincts sur un intervalle de temps sont des métriques delta. Il est raisonnable de s'attendre à ce que ces valeurs soient des entiers, mais pour des raisons historiques d'implémentation, elles sont signalées sous forme de nombres à virgule flottante.
Les métriques cumulatives, dans lesquelles la valeur augmente constamment au fil du temps. Par exemple, une métrique des "octets envoyés" peut être cumulative. Chaque valeur enregistre le nombre total d'octets envoyés par un service à ce stade.

Combinaisons acceptées

Toutes les combinaisons de genre de métrique et de type de valeur ne sont pas pertinentes. Par exemple, vous ne voyez jamais de métrique delta avec des données booléennes. Certaines combinaisons sont pertinentes.

Le tableau suivant répertorie les genres de métriques et les types de valeurs acceptés :

Type de valeur	JAUGE	DELTA	CUMULATIVE⁴
BOOL	oui	Non	0
INT64	oui	Oui¹	oui
DOUBLE	oui	Oui¹	Oui
STRING	Oui¹	0	0
DISTRIBUTION	Oui²	Oui^{1, 3}	Oui

¹ Cette combinaison n'est pas autorisée dans les métriques personnalisées, custom.googleapis.com.
² Cette combinaison n'est pas autorisée pour les métriques basées sur les journaux. Pour en savoir plus, consultez la section Configurer des métriques basées sur les journaux de type distribution.
³ Il s'agit de la seule combinaison autorisée pour les métriques basées sur les journaux, logging.googleapis.com/user, avec le type de valeur DISTRIBUTION. Pour en savoir plus, consultez le champ metricDescriptor dans la documentation de référence de l'API Logging sur LogMetric.
⁴ Les métriques cumulatives ne peuvent pas être utilisées directement pour la création de graphiques ou d'alertes dans Monitoring, mais elles peuvent être agrégées en métriques non cumulatives pouvant être utilisées de ces manières. Pour en savoir plus, consultez la section Genres, types et conversions.

En outre, si vous créez vos propres métriques, vous ne devez utiliser que des combinaisons valides de types de valeurs et de genres de métriques.

Émuler des métriques personnalisées à valeur de chaîne

Les valeurs de chaîne dans les métriques personnalisées ne sont pas acceptées, mais vous pouvez répliquer la fonctionnalité de métrique à valeur de chaîne des manières suivantes:

Créez une métrique GAUGE à l'aide d'une valeur INT64 en tant qu'énumération mappée avec une valeur de chaîne. Traduisez en externe l'énumération en valeur de chaîne lorsque vous interrogez la métrique.
Créez une métrique GAUGE avec une valeur BOOL et un libellé dont la valeur est l'une des chaînes que vous souhaitez surveiller. Utilisez la valeur booléenne pour indiquer si la valeur est la valeur active.

Par exemple, supposons que vous souhaitiez créer une métrique à valeur de chaîne appelée "status" avec les options possibles "OK", "OFFLINE" ou "PENDING". Vous pouvez créer une métrique GAUGE avec un libellé appelé status_value. Chaque mise à jour écrit trois séries temporelles, une pour chaque status_value (OK, OFFLINE ou PENDING), avec une valeur de 1 pour "true" ou 0 pour "false".