Convenzioni di denominazione delle metriche

I nomi delle risorse, i prefissi dei domini e le chiavi delle etichette standardizzati in Cloud Monitoring ti consentono di identificare le origini delle metriche e di definire metriche personalizzate. Puoi applicare queste regole di formattazione per creare tipi di metriche e chiavi LabelDescriptor validi per l'API Cloud Monitoring.

Nome della risorsa della metrica

Il nome della risorsa per un tipo di metrica è costituito da una stringa con tre sottostrutture principali:

  • Un identificatore per un progetto specifico.
  • Un indicatore, sempre impostato su metricDescriptors, per indicare che la stringa rappresenta un descrittore della metrica.
  • Il tipo di metrica.

I nomi delle risorse per i tipi di metriche seguono questo pattern:

projects/PROJECT_ID/metricDescriptors/METRIC_TYPE

La sottostringa METRIC_TYPE è un identificatore che rappresenta il tipo di metrica. È disponibile in vari formati. Ad esempio:

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

Nel descrittore della metrica, il campo name memorizza il nome della risorsa del tipo di metrica e il campo type memorizza la sottostringa METRIC_TYPE.

La seguente tabella mostra come analizzare le sottostringhe METRIC_TYPE contenute nel nome di una risorsa:

Possibili strutture Descrizione
SERVICE_NAME 1.googleapis.com/PATH 2 Metriche di prodotti e servizi Google Cloud . Per un elenco completo di queste metriche, consulta metriche diGoogle Cloud .
agent.googleapis.com/SERVICE_NAME 1/PATH 2 Metriche degli agenti Monitoring e Logging in esecuzione su istanze VM in Google Cloud o AWS. Per un elenco completo di queste metriche, consulta Metriche dell'agente.
kubernetes.io/anthos/PATH 2 Metriche di GKE Enterprise, un servizio Google Cloud che consente di eseguire cluster Kubernetes sia on-prem sia nel cloud. Per un elenco completo di queste metriche, consulta Metriche di Anthos.
aws.googleapis.com/SERVICE_NAME 1/PATH 2 Metriche di Amazon Web Services. Per un elenco completo di queste metriche, consulta Metriche AWS.
istio.io/PATH 2 Metriche di Istio per Google Cloud. Per un elenco completo di queste metriche, consulta Metriche Istio.
kubernetes.io/PATH 2 Metriche di Google Kubernetes Engine. Per un elenco completo di queste metriche, consulta Metriche Kubernetes.
knative.dev/PATH 2 Metriche di Knative. Per un elenco completo di queste metriche, consulta Metriche Knative.
external.googleapis.com/EXT_SERVICE/PATH 2
external.googleapis.com/prometheus/PATH 2		 Metriche personalizzate di terze parti, come Prometheus. Questo strumento di monitoraggio open source viene spesso utilizzato con Kubernetes. Per saperne di più su queste metriche, consulta Metriche esterne. Puoi utilizzare questi tipi di metriche solo nei progetti che le definiscono.
custom.googleapis.com/PATH 2
external.googleapis.com/user/PATH 2		 Metriche definite dall'utente. Puoi utilizzare questi tipi di metriche solo nei progetti in cui le definisci.
logging.googleapis.com/PATH 2 Metriche basate su log di Cloud Logging. Puoi utilizzare le metriche predefinite o creare metriche personalizzate. Le metriche personalizzate possono essere utilizzate solo nei progetti in cui le definisci.

1 SERVICE_NAME identifica un prodotto Google Cloud , ad esempio compute per Compute Engine.
2 PATH identifica la metrica all'interno del prodotto, ad esempio instance/cpu/utilization.

Regole per tipi di metriche ed etichette

Questo elenco contiene le regole da seguire quando crei tipi di metrica personalizzata. Le etichette associate a un tipo di metrica sono specificate come coppie chiave-valore di tipo LabelDescriptor. La chiave funge da nome dell'etichetta.

  • Tipi di metriche

    • Utilizza lettere maiuscole e minuscole (A-Z, a-z), cifre (0-9), punti (.), trattini bassi (_), due punti (:) e trattini (-) nella stringa.
    • Utilizza le barre (/) per separare gli elementi del percorso.
    • Ogni elemento del percorso deve iniziare con una lettera o un numero.
    • La lunghezza massima di una stringa di tipo di metrica è di 200 caratteri.

  • Chiavi di etichetta

    • Utilizza lettere minuscole (a-z), cifre (0-9), trattini bassi (_) e punti (.) in una chiave di etichetta.
    • Le chiavi di etichetta devono iniziare con una lettera.
    • La lunghezza massima di una chiave di etichetta è di 100 caratteri.
    • Ogni chiave deve essere univoca all'interno del tipo di metrica.
    • Puoi avere un massimo di 30 etichette per tipo di metrica.