Convenzioni di denominazione delle metriche

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

Nome della 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 indicatore, impostato sempre 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 diversi 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 contenuto in un nome della risorsa:

Possibili strutture Descrizione
SERVICE_NAME 1.googleapis.com/PATH 2 Metriche dei prodotti e dei servizi Google Cloud. Per un elenco completo di queste metriche, consulta le metriche di Google Cloud.
agent.googleapis.com/SERVICE_NAME 1/PATH 2 Metriche degli agenti di monitoraggio 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 le 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 li 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 da Cloud Logging. Puoi utilizzare metriche predefinite oppure 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 esempiocompute 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 vengono 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 (.) e trattini bassi (_) nella stringa.
    • Utilizza le barre (/) per separare gli elementi del percorso.
    • Devi iniziare ogni elemento del percorso con una lettera o un numero.
    • La lunghezza massima di una stringa di tipo metrica è di 200 caratteri.

  • Chiavi delle etichette

    • Utilizza lettere minuscole (a-z), cifre (0-9) e trattini bassi (_) in una chiave dell'etichetta.
    • Devi iniziare le chiavi delle etichette con una lettera.
    • La lunghezza massima di una chiave dell'etichetta è di 100 caratteri.
    • Ogni chiave deve essere univoca all'interno del tipo di metrica.
    • Non puoi avere più di 30 etichette per tipo di metrica.