Convenzioni di denominazione delle metriche

Questo documento descrive le convenzioni di denominazione applicate da Cloud Monitoring per le metriche.

Nome risorsa 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 marcatore, 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 tabella seguente 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 ti consente di eseguire cluster Kubernetes sia on-premise 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 ulteriori informazioni 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 li definisci.
logging.googleapis.com/PATH^2	Metriche basate su log di Cloud Logging. Puoi utilizzare metriche predefinite o crearne di personalizzate. Le metriche personalizzate possono essere utilizzate solo nei progetti in cui le definisci.

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

Regole per i tipi e le etichette delle metriche

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.
  • Devi iniziare ogni elemento del percorso con una lettera o una cifra.
  • La lunghezza massima di una stringa di tipo metrica è 200 caratteri.

• Chiavi delle etichette

  • 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 è 100 caratteri.
  • Ogni chiave deve essere univoca all'interno del tipo di metrica.
  • Puoi avere un massimo di 30 etichette per tipo di metrica.