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 risorsa per un tipo di metrica è costituito da una con tre sottostrutture principali:

  • Un identificatore per un progetto specifico.
  • Un indicatore, che è 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 la 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 archivia la 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 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, una piattaforma Google Cloud che ti consente di eseguire cluster Kubernetes sia on-prem sia in 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 di 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 di monitoraggio open source è spesso usato 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 definisci che li rappresentano.
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 ai progetti in cui li definisci.

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

Regole per tipi di metriche ed etichette

Questo elenco contiene le regole da seguire quando crei tipi di metrica personalizzata. 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.
    • Ogni elemento del percorso deve iniziare con una lettera o una cifra.
    • La lunghezza massima di una stringa di tipo metrica è 200 caratteri.
  • Assegna etichette alle chiavi

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