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:

  • L'identificatore di 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 schema:

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 archivia il nome risorsa del tipo di metrica, mentre nel campo type la sottostringa METRIC_TYPE.

La seguente tabella mostra come analizzare le sottostringhe METRIC_TYPE contenute in un nome risorsa:

Strutture possibili Descrizione
SERVICE_NAME 1.googleapis.com/PATH 2 Metriche dei prodotti e dei servizi Google Cloud. Per un elenco completo di queste metriche, consulta Metriche di Google Cloud.
agent.googleapis.com/SERVICE_NAME 1/PATH 2 Metriche degli agenti Monitoring e Logging in esecuzione sulle istanze VM in Google Cloud o AWS. Per un elenco completo di queste metriche, consulta Metriche degli agenti.
kubernetes.io/anthos/PATH 2 Metriche di GKE Enterprise, un servizio Google Cloud che ti consente di eseguire cluster Kubernetes sia on-prem che nel cloud. Per un elenco completo di queste metriche, consulta Metriche 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 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 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, come 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 (.) 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.

  • Etichetta le chiavi

    • Utilizza lettere minuscole (a-z), numeri (0-9) e trattini bassi (_) 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.
    • Non puoi avere più di 30 etichette per tipo di metrica.