Conventions de nommage

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

  • Un identifiant pour un projet spécifique
  • Un repère indiquant 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 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/antho/APIServiceOpenAPIAggregationControllerQueue1_adds

Dans le descripteur de 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]1.googleapis.com/[PATH]2 Métriques de Google Cloud
agent.googleapis.com/[SERVICE]1/[PATH]2 Métriques de l'agent Monitoring
aws.googleapis.com/[SERVICE]1/[PATH]2 Métriques d'Amazon Web Services
istio.io/[PATH]2 Métriques d'Istio
kubernetes.io/anthos/[PATH]2 Métriques d'Anthos
logging.googleapis.com/[PATH]2 Métriques basées sur les journaux de Cloud Logging
custom.googleapis.com/[PATH]2 Métriques personnalisées définies par l'utilisateur
external.googleapis.com/[EXT_SERVICE]/[PATH]2
external.googleapis.com/prometheus/[PATH]2
Métriques tierces personnalisées 3
Exemple : Métriques Prometheus

1 [SERVICE] identifie un produit Google Cloud, tel que compute pour Compute Engine.
2 [PATH] identifie la métrique au sein du produit, par exemple instance/cpu/utilization.
3 Google Cloud accepte également plusieurs ensembles de types de métriques tiers connus. Certains d'entre eux, comme Istio et Kubernetes (disponible sous les métriques Anthos), sont traités comme d'autres types de métriques intégrées. D'autres, tels que Knative et Velostrata.com, sont traités comme des types de métriques personnalisées définis par l'utilisateur.

Cloud Monitoring définit les types de métriques dans les trois premières lignes de la table. Voici les types de métriques qui apparaissent dans la liste des métriques. Vous pouvez utiliser ces types de métriques et les types de métriques Anthos dans n'importe quel projet Google Cloud.

Les trois dernières lignes répertorient les types de métriques personnalisés et tiers. Vous ne pouvez utiliser ces types de métriques que dans les projets dans lesquels vous les définissez ou les importez. Pour plus d'informations sur les métriques personnalisées, consultez la page Utiliser des métriques personnalisées.

Attribuer un nom aux types de métriques et aux libellés

Si vous créez des types de métriques personnalisées, vous devez respecter les règles suivantes pour nommer ces types de métriques et de libellés. Lors de la définition d'un type de métrique, les libellés sont spécifiés en tant que paires clé/valeur de type LabelDescriptor. La clé agit comme nom du libellé.

  • Types de métriques
    • Vous pouvez utiliser des lettres majuscules et minuscules (A-Z, a-z), des chiffres (0-9) et des traits de soulignement (_) dans la chaîne.
    • Vous ne pouvez utiliser des points (.) uniquement dans la partie "domaine" de la chaîne, par exemple, custom.googleapis.com.
    • Vous pouvez utiliser des barres obliques (/) pour séparer les éléments de chemin d'accès.
    • Vous pouvez 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 de libellés
    • Vous pouvez utiliser des lettres minuscules (a-z), des chiffres (0-9), des traits de soulignement (_) et des tirets (-) dans une clé de libellé.
    • Vous pouvez commencer des clés de libellé avec 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 avoir plus de 10 libellés par type de métrique.