Conventions de dénomination des métriques

Ce document décrit les conventions d'attribution de noms que Cloud Monitoring applique aux métriques.

Nom de ressource de la métrique

Le nom de ressource d'un type de métrique se compose d'une chaîne avec trois sous-structures principales :

• L'identifiant d'un projet spécifique.
• Un repère, toujours défini sur metricDescriptors, indiquant que la chaîne représente un descripteur de la métrique.
• Le type de métrique.

Les noms de ressources pour les types de métriques suivent ce modèle :

projects/PROJECT_ID/metricDescriptors/METRIC_TYPE

La sous-chaîne METRIC_TYPE est un identifiant qui représente le type de métrique. Il existe différents formats, par exemple :

agent.googleapis.com/agent/api_request_count
compute.googleapis.com/firewall/dropped_bytes_count
istio.io/service/client/received_bytes_count
kubernetes.io/anthos/APIServiceOpenAPIAggregationControllerQueue1_adds

Dans le descripteur de la métrique, le champ name stocke le nom de ressource du type de métrique et le champ type stocke la sous-chaîne METRIC_TYPE.

Le tableau suivant montre comment analyser les sous-chaînes METRIC_TYPE contenues dans un nom de ressource :

Structures possibles	Description
SERVICE_NAME^1.googleapis.com/PATH^2	Métriques provenant des Google Cloud produits et services. Pour obtenir la liste complète de ces métriques, consultez la page Google Cloud Métriques.
agent.googleapis.com/SERVICE_NAME^1/PATH^2	Métriques des agents Monitoring et Logging s'exécutant sur des instances de VM dans Google Cloud ou AWS. Pour obtenir la liste complète de ces métriques, consultez la page Métriques d'agent.
kubernetes.io/anthos/PATH^2	Métriques de GKE Enterprise, un Google Cloud service qui vous permet d'exécuter des clusters Kubernetes sur site et dans le cloud. Pour obtenir la liste complète de ces métriques, consultez la page Métriques Anthos.
aws.googleapis.com/SERVICE_NAME^1/PATH^2	Métriques d'Amazon Web Services. Pour obtenir la liste complète de ces métriques, consultez la page Métriques AWS.
istio.io/PATH^2	Métriques de Istio pour Google Cloud. Pour obtenir la liste complète de ces métriques, consultez la page Métriques Istio.
kubernetes.io/PATH^2	Métriques de Google Kubernetes Engine. Pour obtenir la liste complète de ces métriques, consultez la page Métriques Kubernetes.
knative.dev/PATH^2	Métriques de Knative. Pour obtenir la liste complète de ces métriques, consultez la page Métriques Knative.
external.googleapis.com/EXT_SERVICE/PATH^2 external.googleapis.com/prometheus/PATH^2	Métriques personnalisées tierces, telles que Prometheus. Cet outil de surveillance Open Source est souvent utilisé avec Kubernetes. Pour en savoir plus sur ces métriques, consultez la page Métriques externes. Vous ne pouvez utiliser ces types de métriques que dans les projets qui les définissent.
custom.googleapis.com/PATH^2 external.googleapis.com/user/PATH^2	Métriques définies par l'utilisateur. Vous ne pouvez utiliser ces types de métriques que dans les projets où vous les définissez.
logging.googleapis.com/PATH^2	Métriques basées sur les journaux de Cloud Logging. Vous pouvez utiliser des métriques prédéfinies ou créer des métriques personnalisées. Les métriques personnalisées ne peuvent être utilisées que dans les projets où vous les définissez.

¹ SERVICE_NAME identifie un Google Cloud produit, tel que compute pour Compute Engine.
² PATH identifie la métrique dans le produit, par exemple instance/cpu/utilization.

Règles pour les types de métriques et les libellés

Cette liste contient les règles à suivre lorsque vous créez des types de métriques personnalisées. Les libellés associés à un type de métrique sont spécifiés en tant que paires clé/valeur de type LabelDescriptor. La clé agit comme nom du libellé.

• Types de métriques

  • Utilisez des lettres majuscules et minuscules (A-Z, a-z), des chiffres (0-9), des points (.), des traits de soulignement (_), des deux-points (:) et des traits d'union (-) dans la chaîne.
  • Utilisez des barres obliques (/) pour séparer les éléments de chemin d'accès.
  • Vous devez commencer chaque élément du chemin d'accès par une lettre ou un chiffre.
  • La longueur maximale d'une chaîne de type de métrique est de 200 caractères.

• Clés des étiquettes

  • Utilisez des lettres minuscules (a-z), des chiffres (0-9), des traits de soulignement (_) et des points (.) dans une clé d'étiquette.
  • Vous devez commencer les clés des libellés par une lettre.
  • La longueur maximale d'une clé d'étiquette est de 100 caractères.
  • Chaque clé doit être unique dans le type de métrique.
  • Vous ne pouvez pas définir plus de 30 libellés par type de métrique.