Questo documento descrive come configurare un grafico in una dashboard personalizzata per mostrare i dati delle serie temporali raccolti dal progetto. I grafici possono visualizzare solo dati numerici delle serie temporali. Per informazioni sulla configurazione dello stile di un grafico, consulta Impostare le opzioni di visualizzazione del grafico.
Seleziona i dati da visualizzare
Per configurare le serie temporali da visualizzare in un grafico, puoi elaborare una query selezionando le opzioni dai menu oppure puoi scrivere una query. Quando scrivi una query, selezioni il linguaggio di query e poi utilizzi un editor di query o un'interfaccia basata su testo:
Le query Monitoring Query Language (MQL) specificano le serie temporali e come queste vengono raggruppate e allineate. L'interfaccia MQL supporta un editor di codice con suggerimenti e controllo della sintassi.
In genere non è possibile convertire le query MQL in moduli che possono essere utilizzati dalle altre interfacce. Le query non salvate vengono scartato quando passi alla o dalla scheda MQL.
Le query Prometheus Query Language (PromQL) specificano le serie temporali e come vengono raggruppate e allineate queste serie temporali. L'interfaccia PromQL supporta un editor con suggerimenti.
In genere non è possibile convertire le query PromQL in moduli che possono essere utilizzati dalle altre interfacce. Le query non salvate vengono viene ignorata quando passi alla o dalla scheda PromQL.
Query di filtro del monitoraggio specificare le serie temporali, ma non includere istruzioni di raggruppamento o allineamento.
È possibile specificare qualsiasi serie temporale che Monitoring può tracciare mediante un filtro di Monitoring. Ad esempio, per tracciare un grafico di processi in esecuzione su una VM, devi utilizzare Filtro di monitoraggio che specifica una funzione.
Non è sempre possibile convertire un filtro di monitoraggio nel formato richiesto da altre interfacce. Pertanto, la query potrebbe essere ignorata se passi a un'interfaccia diversa.
In genere, le query specificano un tipo di metrica, un tipo di risorsa e i filtri:
Un tipo di metrica identifica le misurazioni da raccogliere da una risorsa. Include una descrizione di ciò che viene misurato e come le misurazioni vengono interpretate. A volte un tipo di metrica viene chiamato metrica. Un esempio di metrica è "Utilizzo della CPU". Per informazioni concettuali, consulta Tipi di metriche.
Un tipo di risorsa specifica da quale risorsa vengono acquisiti i dati delle metriche. Il tipo di risorsa viene a volte chiamato tipo di risorsa monitorata o semplicemente risorsa. Un esempio di è un'"istanza di macchina virtuale (VM) Compute Engine". Per informazioni concettuali, vedi Risorse monitorate.
Le query MQL e PromQL includono il raggruppamento e l'allineamento istruzioni. Tuttavia, quando scrivi un filtro di Monitoring o utilizzi per selezionare le serie temporali da rappresentare graficamente, configuri il raggruppamento e impostazioni di allineamento utilizzando i menu.
Creare query utilizzando i menu
La creazione di query utilizzando i menu è la configurazione predefinita. In genere, se selezioni una metrica e un filtro e poi passi a un'interfaccia diversa, le selezioni vengono conservate e riformattate per l'interfaccia in questione. Vale a dire che una query creata da menu può essere convertita in una query MQL.
Puoi tornare dalle altre interfacce all'interfaccia basata su menu selezionando tune Builder. Tuttavia, la query viene ignorata. Questo significa che una query MQL non può essere convertita in una query basato su menu.
Per creare una query utilizzando i menu:
-
Nella console Google Cloud, vai alla pagina Dashboard:
Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.
Esegui una di queste operazioni:
- Per creare una nuova dashboard, seleziona Crea dashboard.
- Per aggiornare una dashboard esistente, individuala nell'elenco delle dashboard e selezionane il nome.
Fai clic su add Aggiungi widget nella barra degli strumenti.
Nella finestra di dialogo Aggiungi widget, seleziona leaderboard Metrica.
Nella barra degli strumenti del riquadro delle query, procedi nel seguente modo:
Nell'elemento Metrica, espandi il menu Seleziona una metrica.
Il menu Seleziona una metrica contiene funzionalità che ti aiutano a trovare i tipi di metriche disponibili:
Per trovare un tipo di metrica specifico, utilizza la filter_list Barra dei filtri. Ad esempio, se inserisci
util
, limiti il menu a mostra le voci che includonoutil
. Le voci vengono mostrate una volta superate "contiene" senza distinzione tra maiuscole e minuscole test.Per visualizzare tutti i tipi di metriche, anche quelle senza dati, fai clic su
Attiva. Per impostazione predefinita, i menu mostrano solo i tipi di metriche con dati.
Effettua una selezione dal menu Risorse, il menu Categorie di metriche, il menu Metriche e infine fai clic su Applica.
Ad esempio, per tracciare un grafico sull'utilizzo della CPU da parte di un macchina virtuale, puoi selezionare Istanza VM, Istanza, Utilizzo CPU e fai clic su Applica.
Il menu Risorse elenca la risorsa da cui provengono i dati. raccolte. Quando una metrica non è scritta su una risorsa, Seleziona Non specificato.
Dopo aver completato il passaggio precedente, il grafico mostra le serie temporali disponibili:
Il grafico precedente contiene più dati di quelli visualizzabili. i grafici sono con un massimo di 50 righe visualizzabili. Il grafico segnala che ci sono troppi dati da visualizzare. Per ridurre la quantità di dati, utilizza i campi nell'elemento Ordina e limita. Per ulteriori informazioni, vedi Mostra i valori anomali.
Puoi anche utilizzare le opzioni di filtro e aggregazione per ridurre la quantità di dati visualizzati nel grafico. Queste tecniche rendono i grafici più utili per la diagnostica e l'analisi e aumentano il rendimento e la reattività dell'interfaccia utente stessa.
(Facoltativo) Aggiungi filtri per limitare le serie temporali visualizzate. Il prossimo vengono descritte le opzioni di filtro.
(Facoltativo) Configura la modalità di raggruppamento e allineamento delle serie temporali. Per maggiori informazioni informazioni, consulta Scegliere come visualizzare i dati dei grafici.
Per applicare le modifiche alla dashboard, nella barra degli strumenti fai clic su Applica. Per ignorare le modifiche, fai clic su Annulla.
Filtra i dati dei grafici
I filtri assicurano che vengano tracciate solo le serie temporali che soddisfano un insieme di criteri. Quando applichi i filtri, potresti ridurre il numero di righe nel grafico, in modo da migliorarne le prestazioni. Un altro modo per migliorare la reattività di un grafico è configurare le opzioni di aggregazione, ordinare e limitare il numero di serie temporali visualizzate. Per ulteriori informazioni, consulta Mostrare gli outlier.
Un filtro è composto da un'etichetta, un comparatore e un valore. Ad esempio:
per trovare corrispondenze di tutte le serie temporali la cui etichetta zone
inizia con "us-central1"
,
potresti usare il filtro zone=~"us-central1.*"
, che utilizza un'espressione regolare
per eseguire il confronto. Esistono quattro operatori di confronto:
- uguale a
=
- non uguale,
!=
- corrispondenza con espressione regolare,
=~
- L'espressione regolare non corrisponde,
!=~
Quando filtri in base all'ID progetto o al contenitore delle risorse,
devi utilizzare l'operatore di uguaglianza (=)
. Quando filtri in base ad altre etichette, puoi utilizzare qualsiasi comparatore supportato.
In genere, puoi filtrare le metriche e le etichette delle risorse,
gruppo di risorse.
Quando specifichi più criteri di filtro, il grafico corrispondente mostra
solo le serie temporali che soddisfano tutti i criteri, un valore logico AND
.
Per aggiungere un filtro quando utilizzi l'interfaccia basata su menu della console Google Cloud: segui questi passaggi:
Nell'elemento Filtro, fai clic su Aggiungi filtro ed effettua una selezione. dal menu.
Per modificare il confronto, seleziona un valore dal menu Criterio di confronto.
Nel campo Valore, inserisci o seleziona un valore:
Per un confronto diretto,
=
o!=
, seleziona il valore dal o inserisci un valore e fai clic su Ok. Puoi inserire valori ad esempious-central1-a
, oppure puoi creare un filtro che inizia constarts_with
oends_with
. Ad esempio, per visualizzare i dati per qualsiasi zonaus-central1
, puoi inserire la stringa filtrostarts_with("us-central1")
. Vedi Filtri di Monitoring per ulteriori informazioni sulle stringhe di filtro.Poiché le voci del menu derivano dalle serie temporali ricevute, quando una risorsa monitorata non genera dati per la metrica selezionata, devi inserire un valore per l'etichetta.
Per un confronto di espressioni regolari,
=~
o!=~
, inserisci un RE2 un'espressione regolare nel campo Valore e fai clic su Ok. Ad esempio, l'espressione regolareus-central1-.*
corrisponde a tutte le zoneus-central1
.Per trovare la corrispondenza con qualsiasi zona statunitense che termina con "a", puoi utilizzare la espressione regolare
^us.*.a$
.Non puoi utilizzare espressioni regolari per filtrare l'
project_id
etichetta della risorsa.Ad esempio, per visualizzare solo la serie temporale di una delle zone
us-central1
, applica un filtrozone=~"us-central1.*"
.
Quando aggiungi più filtri, si applicano i seguenti punti:
Puoi utilizzare la stessa etichetta più volte, il che ti consente di specificare un filtro per un intervallo di valori.
Devono essere soddisfatti tutti i criteri del filtro. e costituiscono un
AND
logico.
Per modificare il valore o il comparatore per un filtro, In corrispondenza dell'elemento del filtro, fai clic su arrow_drop_down Menu, rendi modifiche e fai clic su Ok.
Per eliminare un filtro, fai clic su cancel Annulla.
Scrivere query MQL
Per inserire una query MQL o PromQL:
-
Nella console Google Cloud, vai alla pagina Dashboard:
Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.
Esegui una di queste operazioni:
- Per creare una nuova dashboard, seleziona Crea dashboard.
- Per aggiornare una dashboard esistente, trovala nell'elenco di tutte dashboard e selezionarne il nome.
Fai clic su add Aggiungi widget nella barra degli strumenti.
Nella finestra di dialogo Aggiungi widget, seleziona leaderboard Metrica.
Nella barra degli strumenti della riquadro Query Builder, seleziona il pulsante con code MQL o code PromQL.
Verifica che sia selezionato MQL nel pulsante di attivazione/disattivazione Lingua. Il pulsante di attivazione/disattivazione della lingua si trova nella stessa barra degli strumenti che consente di formattare la query.
(Facoltativo) Disattiva l'opzione di attivazione/disattivazione Esecuzione automatica.
Inserisci la query nell'editor delle query. Ad esempio, per creare un grafico dell'utilizzo della CPU delle istanze VM nel tuo progetto Google Cloud, utilizza la seguente query:
fetch gce_instance | metric 'compute.googleapis.com/instance/cpu/utilization' | group_by 1m, [value_utilization_mean: mean(value.utilization)] | every 1m
Per ulteriori informazioni su MQL, consulta i seguenti documenti:
Fai clic su Esegui query.
Quando l'opzione Esecuzione automatica è abilitata, Il pulsante Esegui query non viene mostrato.
Scrivere query PromQL
Per inserire una query MQL o PromQL:
-
Nella console Google Cloud, vai alla pagina Dashboard:
Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.
Esegui una di queste operazioni:
- Per creare una nuova dashboard, seleziona Crea dashboard.
- Per aggiornare una dashboard esistente, trovala nell'elenco di tutte dashboard e selezionarne il nome.
Fai clic su add Aggiungi widget nella barra degli strumenti.
Nella finestra di dialogo Aggiungi widget, seleziona leaderboard Metrica.
Nella barra degli strumenti della riquadro Query Builder, seleziona il pulsante con code MQL o code PromQL.
Verifica che PromQL sia selezionato con l'opzione Lingua. Il pulsante di attivazione/disattivazione della lingua si trova nella stessa barra degli strumenti che consente di formattare la query.
(Facoltativo) Disattiva l'opzione di attivazione/disattivazione Esecuzione automatica.
Inserisci la query nell'editor di query. Ad esempio, per creare un grafico dell'utilizzo medio della CPU delle istanze VM nel tuo progetto Google Cloud, utilizza la seguente query:
avg(compute_googleapis_com:instance_cpu_utilization)
Per ulteriori informazioni sull'utilizzo di PromQL, consulta PromQL in Cloud Monitoring.
Fai clic su Esegui query.
Quando l'opzione di attivazione/disattivazione Esecuzione automatica è attivata, il pulsante Esegui query non viene visualizzato.
Scrivi query di filtro Monitoring
Quando vuoi eseguire una delle seguenti operazioni, devi utilizzare la modalità di filtro diretto, che ti consente di inserire un filtro di monitoraggio:
- Visualizza un obiettivo del livello di servizio (SLO).
- Visualizza il conteggio dei processi in esecuzione su macchine virtuali (VM).
- Visualizzare una metrica personalizzata per la quale non disponi ancora di dati.
- Filtra una serie temporale in base a un'etichetta per la quale non disponi ancora di dati.
Un filtro di Monitoring o equivalente
filtro metriche, è un'espressione che Monitoring
per identificare le serie temporali da rappresentare sul grafico.
Ad esempio, la seguente espressione restituisce
in un grafico che mostra un conteggio dei processi il cui nome include nginx
:
select_process_count("monitoring.regex.full_match(\".*nginx.*\")")
resource.type="gce_instance"
Puoi anche utilizzare i filtri di Monitoring per identificare le serie temporali
in base al tipo di risorsa e di metrica. La seguente espressione genera un
grafico che mostra il conteggio delle voci di log per tutte le istanze di macchine virtuali Google Cloud nella zona us-east1-b
:
metric.type="logging.googleapis.com/log_entry_count"
resource.type="gce_instance"
resource.label."zone"="us-east1-b"
Per inserire un filtro di Monitoring, segui questi passaggi:
-
Nella console Google Cloud, vai alla pagina Dashboard:
Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.
Esegui una di queste operazioni:
- Per creare una nuova dashboard, seleziona Crea dashboard.
- Per aggiornare una dashboard esistente, individuala nell'elenco delle dashboard e selezionane il nome.
Fai clic su add Aggiungi widget nella barra degli strumenti.
Nella finestra di dialogo Aggiungi widget, seleziona leaderboard Metrica.
Fai clic su help_outline Guida nell'elemento Metrica, quindi seleziona Modalità filtro diretto.
Gli elementi Metrica e Filtro vengono eliminati, mentre un elemento Filtri consente di inserire del testo, viene creato.
Se hai selezionato un tipo di risorsa, una metrica o filtri prima di passare alla modalità Filtro diretto, queste impostazioni vengono visualizzate nell'elemento Filtri.
Nell'area di testo dell'elemento Filtri, inserisci un'espressione di filtro di monitoraggio. Per informazioni sulla sintassi, consulta i seguenti documenti:
Quando utilizzi la modalità di filtro diretto e non sono disponibili dati che soddisfano le viene visualizzato un errore. Alcuni messaggi di errore comuni sono
Chart definition invalid
eNo data is available for the selected timeframe.
(Facoltativo) Configura il modo in cui vengono raggruppate e allineate le serie temporali. Per maggiori informazioni informazioni, consulta Scegliere come visualizzare i dati dei grafici.
Per tornare all'interfaccia basata su menu, Fai clic su tune Esci dalla modalità di filtro diretto.
Scegli come visualizzare i dati dei grafici
Dopo aver selezionato i dati delle serie temporali, il passaggio successivo consiste nel determinare il la visualizzazione dei dati. Ad esempio, vuoi visualizzare ogni serie temporale o vuoi combinare le serie temporali?
Questa sezione spiega come impostare i campi di aggregazione. L'aggregazione consiste nell'allineamento dei punti dati all'interno di una serie temporale e nella combinazione di diverse serie temporali. Per una spiegazione dettagliata dell'aggregazione, consulta Filtri e aggregazione: manipolazione delle serie temporali.
- Per informazioni sulle opzioni di visualizzazione, consulta Impostare le opzioni di visualizzazione dei grafici.
- Per saperne di più su come interagire con il grafico, consulta Esplorare i dati dei grafici.
I contenuti di questa sezione non si applicano quando hai selezionato i dati per il grafico utilizzando un'espressione MQL o PromQL.
Combinare serie temporali
Puoi ridurre la quantità di dati restituiti per una metrica combinando diverse serie temporali. Per combinare più serie temporali, in genere specifichi una o più etichette e una funzione. Le serie temporali con lo stesso valore per tutte le etichette specificate viene raggruppato, quindi la funzione specificato unisce queste serie in una nuova serie temporale.
Le impostazioni dell'elemento Aggregation possono modificare il numero di serie temporali visualizzate nel grafico. Le impostazioni predefinite per questo elemento sono determinate dal tipo di metrica che hai selezionato. Per modificare il display, procedi in uno dei seguenti modi:
Per visualizzare ogni serie temporale, nell'elemento Aggregazione, assicurati che il primo menu sia impostato su Nessuna aggregazione e il secondo su Nessuna.
Per combinare le serie temporali, nell'elemento Aggregation (Aggregazione), procedi nel seguente modo:
Espandi il primo menu e seleziona una funzione.
Il grafico viene aggiornato e mostra una singola serie temporale. Ad esempio, se selezioni Media, la serie temporale visualizzata è la media di tutte le serie temporali.
Per combinare serie temporali con gli stessi valori di etichetta, espandi il secondo menu, quindi seleziona una o più etichette.
Il grafico viene aggiornato e mostra una serie temporale per ogni combinazione univoca di valori delle etichette. Ad esempio, per visualizzare le serie temporali per zona, imposta il secondo menu su zona.
Per configurare la spaziatura tra i punti dati, fai clic su add Aggiungi elemento query, seleziona Intervallo min e poi inserisci un valore.
Ad esempio, se imposti la funzione su Somma e selezioni l'etichetta user_labels.version, esiste una serie temporale per ogni valore dell'etichetta user_labels.version. I punti dati di ogni serie temporale vengono calcolati dalla somma di tutti i valori per le singole serie temporali di una versione specifica:
Quando selezioni più etichette, le serie temporali con lo stesso i valori delle etichette selezionate vengono combinati. Il grafico risultante mostra una serie temporale per ogni combinazione di etichetta e i relativi valori. L'ordine in cui specifichi le etichette non è importante. Il seguente screenshot mostra un grafico in cui le serie temporali sono combinate dai valori Etichette user_labels.version e system_labels.machine_image:
Come mostrato, il grafico mostra una serie temporale per ogni coppia di valori di etichetta. Il fatto che tu ottenga una serie temporale per ogni combinazione di etichette significa che questa tecnica può creare più dati di quelli che puoi inserire in un singolo grafico.
Mostra tutte le serie temporali
Per visualizzare tutte le serie temporali, nell'elemento Aggregation: imposta il primo menu su Non aggregato e il secondo su Nessuno.
Allinea i dati
L'allineamento è il processo di conversione dei dati delle serie temporali ricevuti Monitoraggio in una nuova serie temporale con punti dati in a intervalli fissi. Il processo di allineamento consiste nel raccogliere tutti i punti dati ricevuti in una durata di tempo fissa, applicando una funzione per combinare quei punti dati e assegnando un timestamp al risultato. Questa funzione potrebbe calcolare la media di tutti i campioni o estrarre il massimo di tutti i campioni.
Impostare l'intervallo di allineamento
Per specificare la durata fissa dei punti da combinare, fai clic su add Aggiungi elemento query nel riquadro della query, seleziona Intervallo min e poi completa la finestra di dialogo.
Ad esempio, considera una metrica con un periodo di campionamento di un minuto. Se un grafico
è configurato per visualizzare un'ora di dati, quindi il grafico può visualizzare tutti e 60 i dati
punti. Se il campo Intervallo min è impostato su 10 minutes
, il grafico mostra 6 punti dati. Tuttavia, se ora configuri il grafico in modo che
una settimana di dati, ci sono troppi punti da visualizzare nel grafico, pertanto
l'intervallo nel quale vengono combinati i punti viene modificato automaticamente.
In questo esempio, l'intervallo modificato è di un'ora.
Lo screenshot seguente mostra l'utilizzo della CPU delle istanze VM Compute Engine in un determinato progetto Google Cloud.
In questa immagine, il campo Intervallo min è impostato su 1 minute
:
Il seguente screenshot illustra l'effetto della modifica a titolo di confronto.
l'intervallo da 1 minute
a 5 minutes
:
Aumentando il periodo, il grafico risultante ha meno punti, diminuendo da Da 60 punti per serie temporale a 10 punti per serie temporale. Aumentando il valore Intervallo minimo, vengono combinati più punti, ottenendo una riduzione sui dati tracciati.
Impostare la funzione di allineamento
Quando selezioni la funzione di aggregazione, Cloud Monitoring seleziona la funzione di allineamento per te. Cloud Monitoring determina l'ottimizzazione funzione di allineamento in base al tipo di metrica selezionato e alla tua scelta per la funzione di aggregazione. Tuttavia, puoi specificare una funzione di allineamento ed eseguire l'override della scelta fatta da Cloud Monitoring.
Per specificare la funzione di allineamento, procedi nel seguente modo:
- Nell'elemento Aggregation, espandi il primo menu e seleziona Configura allineatore. La funzione di allineamento e Vengono aggiunti elementi di raggruppamento.
- Espandi l'elemento Funzione di allineamento ed effettua una selezione.
Sebbene la maggior parte delle funzioni di allineamento supportate esegua funzioni matematiche comuni, alcune eseguono azioni più complicate:
next older: per conservare solo il campione più recente all'interno di un periodo di allineamento, seleziona next older. Questa funzione viene comunemente utilizzata con i controlli di uptime ed è una buona scelta se ti interessa solo il valore più recente.
Questa funzione è valida solo per le metriche di misuratore.
percentile: per visualizzare una metrica di distribuzione su un tipo di grafico a linee, grafico ad area impigliato o grafico a barre impigliato, devi selezionare il percentile della distribuzione da visualizzare. Un modo per specificare questo percentile è selezionare una funzione percentile. Puoi selezionare il 5°, 50°, 95° e il 99° percentile. Il punto dati allineato viene determinato calcolando il percentile specificato utilizzando tutti i punti dati nel periodo di allineamento.
Questa funzione è valida solo per le metriche indicatore e delta quando hanno un tipo di dati di distribuzione.
delta: per convertire una metrica cumulativa o una metrica delta in delta. con un campione per periodo di allineamento, utilizza questa funzione. Quando utilizzi questa funzione, è possibile che si verifichi l'interpolazione dei dati. Per un esempio, consulta Tipi, generi e conversioni.
Questa funzione è valida solo per le metriche cumulative e delta.
rate: per convertire una metrica cumulativa o delta in una metrica indicatore, utilizza questa funzione. Se scegli questa funzione, puoi considerare la serie temporale come trasformata come con una funzione delta e poi divisa per il periodo di allineamento. Ad esempio, se l'unità della serie temporale originale è MiB e l'unità del periodo di allineamento è secondo, il grafico ha un'unità di MiB al secondo. Per saperne di più, consulta Tipi, generi e conversioni.
Questa funzione è valida solo per le metriche cumulative e delta.
Per ulteriori informazioni sulle funzioni di allineamento disponibili,
vedi Aligner
nel riferimento API.
Aggregazione secondaria
Se hai più serie temporali che rappresentano già le aggregazioni, puoi ridurre tutte le serie temporali del grafico a un'unica serie temporali scegliendo un Aggregatore secondario. Ad esempio, se Raggruppa i dati per zona, il grafico mostra una serie temporale per ogni zona. Per creare un grafico con una singola serie temporale, utilizza i campi di aggregazione secondaria.
Per alcuni tipi di metriche, puoi scegliere di trasformare i dati. Se questo è disponibile e se imposti il campo Trasforma su un valore diverso rispetto a Nessuno, tutti gli altri campi sono le impostazioni di aggregazione secondarie.
Quando i campi di aggregazione secondari sono configurabili, per accedere a questi campi, a:
- Fai clic su add Aggiungi elemento di query e poi seleziona Aggregazione secondaria.
- Configura l'elemento Aggregazione secondaria.
Passaggi successivi
- Esplorare i dati dei grafici
- Panoramica delle metriche definite dall'utente
- Configurare il nome di una colonna della legenda
- Impostare le opzioni di visualizzazione del grafico