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 2external.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 2external.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.
- Utilizza lettere maiuscole e minuscole (
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.
- Utilizza lettere minuscole (