Conventions de dénomination des métriques

Les noms de ressources, les préfixes de domaine et les clés d'étiquette standardisés dans Cloud Monitoring vous permettent d'identifier les sources de métriques et de définir des métriques personnalisées. Vous pouvez appliquer ces règles de mise en forme pour créer des types de métriques et des clés LabelDescriptor valides pour l'API Cloud Monitoring.

Nom de ressource de la métrique

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

  • Identifiant d'un projet spécifique.
  • Un repère, toujours défini sur metricDescriptors, pour indiquer que la chaîne représente un descripteur de la métrique.
  • 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 est disponible dans différents formats. 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 des produits et services Google Cloud . Pour obtenir la liste complète de ces métriques, consultez MétriquesGoogle Cloud .
agent.googleapis.com/SERVICE_NAME 1/PATH 2 Métriques des agents Monitoring et Logging exécutés sur des instances de VM dans Google Cloud ou AWS. Pour obtenir la liste complète de ces métriques, consultez Métriques de l'agent.
kubernetes.io/anthos/PATH 2 Métriques de GKE Enterprise, un service Google Cloudqui vous permet d'exécuter des clusters Kubernetes à la fois sur site et dans le cloud. Pour obtenir la liste complète de ces métriques, consultez 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 d'Istio pour Google Cloud. Pour obtenir la liste complète de ces métriques, consultez 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.

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

Règles pour les types et les étiquettes de métriques

Cette liste contient les règles à suivre lorsque vous créez des types de métriques personnalisées. Les étiquettes associées à un type de métrique sont spécifiées sous forme de 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 du 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.
    • Les clés d'étiquette doivent commencer par une lettre.
    • La longueur maximale d'une clé de libellé 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.