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 des informations générales 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 savoir comment représenter ces métriques sous forme graphique, consultez la page 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 jauge, 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 depuis son dernier enregistrement. Par exemple, les métriques mesurant le nombre de requêtes sont des métriques delta. Chaque valeur enregistre le nombre de requêtes reçues depuis l'enregistrement du dernier point de données.

  • 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 CUMULATIVE4
BOOL Oui Non Non
INT64 Oui Oui1 Oui
DOUBLE Oui Oui1 Oui
STRING Oui1 Non Non
DISTRIBUTION Oui2 Oui1, 3 Oui

1 Cette combinaison n'est pas autorisée dans les métriques personnalisées, custom.googleapis.com.
2 Cette combinaison n'est pas autorisée pour les métriques basées sur les journaux. Pour plus d'informations, consultez la page Configurer les métriques basées sur les journaux de type distribution.
3 Il s'agit de la seule combinaison autorisée pour les métriques basées sur les journaux.logging.googleapis.com/user , avec un type de valeurDISTRIBUTION ; Pour plus d'informations, consultez le champ metricDescriptor dans la documentation de référence de l'API Logging.LogMetric .
4 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".