Comprendere come i tipi di risorse monitorate, i tipi di metriche, le etichette e le serie temporali interagiscono in Cloud Monitoring ti aiuta a eseguire query e interpretare i dati di monitoraggio in modo accurato. Questi concetti vengono applicati quando recuperi i dati delle serie temporali con l'API Cloud Monitoring.
Se non hai familiarità con questi concetti, inizia con Metriche, serie temporali e risorse. Per gli schemi degli oggetti dell'API Monitoring, consulta Struttura delle serie temporali.
Qualche parola sulle etichette
Sia i tipi di risorse monitorate sia i tipi di metriche supportano le etichette, che consentono di classificare i dati durante l'analisi. Ad esempio:
- Un tipo di risorsa monitorata per una macchina virtuale potrebbe includere etichette per la posizione della macchina e l'ID progetto associato alla macchina. Quando vengono registrate le informazioni sulla risorsa monitorata, queste includono i valori delle etichette.
- Un tipo di metrica che conteggia le richieste API potrebbe avere etichette per registrare il nome del metodo richiamato e lo stato della richiesta.
L'utilizzo delle etichette è descritto in maggiore dettaglio in Etichette.
Tipi di risorse monitorate
Una risorsa monitorata è una risorsa da cui vengono acquisiti i dati delle metriche. Cloud Monitoring supporta circa 270 tipi di risorse monitorate.
I tipi di risorse monitorate includono nodi e attività generici, componenti dell'architettura in Google Kubernetes Engine e molti altri.Ogni tipo di risorsa monitorata è descritto formalmente in una struttura di dati chiamata descrittore di risorsa monitorata. Per saperne di più, consulta Descrittori delle risorse monitorate.
Ogni tipo di risorsa monitorata supportato ha una voce nell'elenco delle risorse monitorate. Le voci nell'elenco vengono create dai descrittori delle risorse monitorate. Questa sezione descrive le informazioni acquisite in un descrittore delle risorse monitorate e mostra come vengono presentate nell'elenco.
Un tipo di risorsa monitorata di esempio
L'immagine seguente mostra la voce nell'elenco per un bucket Cloud Storage:
Tutte le voci dell'elenco includono le seguenti informazioni:
- Tipo: l'intestazione della voce elenca il tipo di risorsa monitorata,
gcs_bucketnell'esempio. - Nome visualizzato: una breve descrizione della risorsa monitorata.
- Descrizione: una descrizione più lunga della risorsa monitorata.
- Etichette: un insieme di dimensioni per la classificazione dei dati. Per saperne di più, consulta Etichette.
Tipi di metriche
Un tipo di metrica descrive le misurazioni che possono essere raccolte da una risorsa monitorata. Un tipo di metrica include una descrizione di ciò che viene misurato e di come vengono interpretate le misurazioni.I tipi di metriche includono i conteggi delle chiamate API, le statistiche sull'utilizzo del disco, il consumo di spazio di archiviazione e molti altri.
Ogni tipo di metrica è descritto formalmente in una struttura di dati chiamata descrittore della metrica. Per saperne di più, consulta Descrittori delle metriche.
Ogni tipo di metrica integrata ha una voce nelle pagine Elenco delle metriche. Le voci di queste tabelle vengono create dai descrittori delle metriche. Questa sezione descrive le informazioni acquisite in un tipo di metrica e mostra come vengono presentate nel materiale di riferimento.
Un tipo di metrica di esempio
L'immagine seguente mostra una voce per un tipo di metrica di Cloud Storage:
I tipi di metriche vengono visualizzati in una tabella e l'intestazione della tabella spiega il layout delle informazioni. Questa sezione utilizza una voce come esempio, ma tutte le tabelle utilizzano lo stesso formato.
La voce della tabella Cloud Storage di esempio fornisce le seguenti informazioni su un tipo di metrica:
Tipo di metrica: un identificatore per il tipo di metrica,
storage.googleapis.com/api/request_countnell'esempio.Il prefisso
storage.googleapis.comfunge da spazio dei nomi per Cloud Storage. Tutti i tipi di metriche associati a un determinato tipo di risorsa monitorata utilizzano lo stesso spazio dei nomi.Gli spazi dei nomi sono omessi dalle voci nelle tabelle.
Tutti i tipi di metriche associati a Cloud Storage sono elencati nella tabella delle metriche di Cloud Storage.
Fase di lancio: un blocco colorato che indica la fase di lancio del tipo di metrica con un valore come Alpha, Beta o GA.
Nome visualizzato: una breve stringa che descrive il tipo di metrica, "Conteggio richieste" nell'esempio.
Kind, Type, Unit: questa riga fornisce informazioni per interpretare i valori dei dati. L'esempio mostra una metrica delta registrata come un numero intero a 64 bit senza unità (ovvero il valore
1).Kind: questo esempio è una metrica delta, che registra una variazione in un periodo di tempo. In altre parole, ogni punto dati registra il numero di chiamate API dalla scrittura del punto dati precedente. Per saperne di più sui tipi, consulta Tipi di valore e tipi di metrica.
Tipo: questo esempio registra i valori come numeri interi a 64 bit. Per saperne di più sui tipi, consulta Tipi di valori e tipi di metriche.
Unità: questa metrica non richiede un'unità esplicita perché rappresenta un conteggio; la cifra
1viene utilizzata per indicare che non è necessaria alcuna unità.
Risorse monitorate: le risorse monitorate per le quali è disponibile questo tipo di metrica. I valori qui sono gli stessi descritti in Tipi di risorse monitorate.
Descrizione: informazioni più dettagliate su cosa viene registrato e come. Utilizza il corsivo per distinguerlo dalle etichette.
Etichette: un insieme di dimensioni per la classificazione dei dati. Per saperne di più, consulta Etichette.
Quando accedi ai dati di monitoraggio tramite l'API Cloud Monitoring, includi un progetto Cloud de Confiance nella chiamata API. Puoi recuperare solo i dati visibili a quel progetto Cloud de Confiance . Ad esempio, se richiedi i dati del tuo progetto per il tipo di metrica storage.googleapis.com/api/request_count, vedrai i conteggi delle API solo per i bucket Cloud Storage nel tuo progetto.
Se il tuo progetto non utilizza bucket Cloud Storage, non vengono restituiti dati delle metriche.
Tipi di metriche integrate
I tipi di metriche integrate sono definiti dai servizi Cloud de Confiance by S3NS , tra cui Cloud Monitoring. Questi tipi di metriche descrivono le misurazioni standard per un'ampia gamma di infrastrutture comuni e sono disponibili per chiunque.
L'elenco delle metriche mostra l'intero insieme di tipi di metriche integrate.Etichette
Un'etichetta è una coppia chiave-valore che può essere utilizzata per fornire informazioni su un valore di dati.
Etichette delle metriche e delle risorse monitorate
Le definizioni dei tipi di metriche e di risorse monitorate includono etichette. Le etichette sono classificatori per i dati raccolti e aiutano a categorizzarli per un'analisi più approfondita. Ad esempio:
- Il tipo di metrica di Cloud Storage
storage.googleapis.com/api/request_countha due etichette,response_codeemethod. - Il tipo di risorsa monitorata di Cloud Storage
gcs_bucketha tre etichette:project_id,bucket_nameelocation. Le etichette identificano istanze specifiche del tipo di risorsa.
Pertanto, tutta la raccolta dei dati per le richieste API da un bucket Cloud Storage viene classificata in base al metodo chiamato, al codice di risposta per la chiamata e al nome, alla località e al progetto del bucket interessato. L'insieme di etichette varia in base al tipo di metrica o di risorsa monitorata; le etichette disponibili sono documentate nelle pagine Elenco delle metriche ed Elenco delle risorse monitorate.
Monitorando il codice di risposta, il nome del metodo e la località durante il conteggio delle chiamate API, puoi recuperare il numero di chiamate a un particolare metodo API, il numero di chiamate non riuscite a qualsiasi metodo o il numero di chiamate non riuscite a un metodo specifico in una località specifica.
Il numero di etichette e il numero di valori che ciascuna può assumere è definito cardinalità. La cardinalità è il numero di possibili serie temporali che potrebbero essere raccolte per una coppia di tipi di metrica e risorsa monitorata: esiste una serie temporale per ogni combinazione di valori delle relative etichette. Per saperne di più, consulta Cardinalità: serie temporali ed etichette.
Serie temporale: dati di una risorsa monitorata
Questa sezione illustra cosa sono i dati di monitoraggio e come sono organizzati nelle serie temporali. È qui che i componenti concettuali del modello di metrica diventano artefatti concreti.
Cloud Monitoring archivia misurazioni regolari nel tempo per coppie di tipi di metriche e risorse monitorate. Le misurazioni vengono raccolte in serie temporali, ognuna delle quali contiene i seguenti elementi:
Il nome del tipo di metrica a cui appartiene la serie temporale e una combinazione di valori per le etichette della metrica.
Una serie di coppie (timestamp, valore). Il valore è la misurazione, mentre il timestamp è l'ora in cui è stata eseguita la misurazione.
La risorsa monitorata che è l'origine dei dati delle serie temporali e una combinazione di valori per le etichette della risorsa.
Viene creata una serie temporale per ogni combinazione di etichette di metriche e risorse che genera dati.
Esempio stilizzato: il tipo di metrica storage.googleapis.com/api/request_count potrebbe avere molte serie temporali per i bucket Cloud Storage del tuo progetto. La tabella seguente mostra alcune possibili serie temporali.
Nella tabella, il valore bucket: xyz rappresenta il valore dell'etichetta bucket_name nel tipo di risorsa monitorata, mentre response_code e method sono etichette nel tipo di metrica. Esiste una serie temporale per ogni combinazione di valori nelle etichette delle risorse e delle metriche. La tabella ne mostra alcune:
| Etichetta della risorsa monitorata |
Etichette metriche | Dati delle metriche |
|---|---|---|
bucket: 1234 |
response_code: OK, |
{ |
bucket: 1234 |
response_code: OK, |
{ |
bucket: 1234 |
response_code: FAIL, |
{ |
bucket: 9876 |
response_code: OK, |
{ |
Cloud Monitoring non registra serie temporali "vuote". Nell'esempio dei bucket Cloud Storage, se non utilizzi un determinato bucket o non chiami mai un determinato metodo API, non vengono raccolti dati per quell'etichetta e nessuna serie temporale la menziona. Ciò significa che, se il tuo progetto non contiene dati per una determinata metrica, non vedrai mai il tipo di metrica.
I tipi di metriche non indicano i tipi di risorse monitorate presenti nelle serie temporali delle metriche. Per Cloud Storage esiste un solo tipo di risorsa monitorata: gcs_bucket. Alcuni tipi di metriche sono associati a più di una risorsa monitorata.
Cardinalità: serie temporali ed etichette
Ogni serie temporale è associata a una coppia specifica di tipi di metrica e risorsa monitorata. I tipi di metrica e di risorsa monitorata forniscono ciascuno un certo numero di etichette. In Cloud Monitoring, il numero di combinazioni uniche di valori per l'insieme di etichette è la cardinalità del tipo di metrica o del tipo di risorsa monitorata. Questi valori sono chiamati cardinalità delle metriche e cardinalità delle risorse e determinano il numero di serie temporali possibili, ovvero la cardinalità totale, che potrebbero essere generate.
Supponiamo che tu abbia un tipo di metrica che specifica due etichette,
color e zone. La cardinalità della metrica dipende dal numero di valori possibili di queste etichette:
- Se sono presenti solo tre colori possibili, "rosso", "verde" e "blu", l'etichetta
colorpuò avere fino a tre valori distinti. - Se esistono solo due zone possibili, "east" e "west", l'etichetta
zonepuò avere fino a due valori distinti.
La cardinalità di questa metrica è 6 (3 x 2). Se esistono 1000 valori possibili per l'etichetta color e se ogni colore può essere visualizzato in ogni zona, la cardinalità della metrica è 2000 (1000 x 2). Lo stesso calcolo si applica se si tratta di etichette su un tipo di risorsa monitorata anziché su un tipo di metrica.
Questo valore di cardinalità è un valore massimo, basato sul numero di combinazioni di possibili valori di etichetta. Il valore effettivo reale potrebbe essere significativamente inferiore quando non si verificano tutte le combinazioni di valori delle etichette. Ad esempio, se ogni colore appare in una sola zona, non in entrambe, il numero massimo di serie temporali che vedi nel sistema in esecuzione è 1000. Tuttavia, l'utilità della cardinalità effettiva dipende dai motivi per cui determinate combinazioni non vengono visualizzate e se potrebbero essere visualizzate in futuro.
Quando vengono scritti i dati delle serie temporali, questi vengono classificati in base ai tipi di metrica e di risorsa monitorata. Per qualsiasi coppia di tipi di metriche e risorse, la cardinalità totale è il prodotto della cardinalità delle metriche e della cardinalità delle risorse. Se hai una metrica con cardinalità pari a 1000 e una risorsa con cardinalità pari a 100 e se viene visualizzato ogni valore di etichetta, hai 100.000 serie temporali (1000 x 100).