Creare grafici con Metrics Explorer

Questo documento descrive come esplorare i dati delle metriche creando un grafico temporaneo con Metrics Explorer. Ad esempio, per visualizzare l'utilizzo della CPU di una macchina virtuale (VM) puoi utilizzare Metrics Explorer per creare un grafico che mostra i dati più recenti.

Puoi creare grafici semplici, come quelli che graficino un solo tipo di metrica, e grafici complessi, come quelli che graficino più tipi di metriche. Dopo aver creato un grafico con Metrics Explorer, puoi ignorarlo, salvarlo in una dashboard personalizzata, salvarne la configurazione o condividerlo.

Il seguente screenshot mostra un singolo tipo di metrica, l'utilizzo della CPU di un'istanza VM, tracciato nella pagina Metrics Explorer:

Metrica tracciata utilizzando Metrics Explorer.

Lo screenshot precedente mostra tre righe, ognuna con i dati delle serie temporali per una VM specifica.

Tracciare un singolo tipo di metrica

Per configurare un grafico in modo che mostri una singola metrica utilizzando Metrics Explorer, procedi come segue:

Nella console Google Cloud, seleziona Monitoring o fai clic sul pulsante seguente:
Vai a Monitoring
Nel riquadro di navigazione, seleziona Metrics Explorer .
Specifica i dati da visualizzare nel grafico. Per utilizzare un'interfaccia basata su menu o per inserire un filtro Monitoring, seleziona la scheda Configurazione. Per utilizzare il Query Tool di Monitoring (MQL), seleziona la scheda MQL.
Scheda Configurazione
Per configurare un grafico:
1. Seleziona i dati della serie temporale che vuoi visualizzare.
2. (Facoltativo) Raggruppa e allinea le serie temporali.
Seleziona i dati della serie temporale che vuoi visualizzare

Seleziona una risorsa e una metrica procedendo in uno dei seguenti modi:
- Per registrare un tipo di metrica, ad esempio l'utilizzo della CPU di una VM, procedi come segue:
  1. Espandi il menu Seleziona una metrica.
  2. (Facoltativo) Per limitare il numero di scelte, inserisci il nome della metrica o della risorsa nella barra dei filtri. Ad esempio, per tracciare la latenza di richiesta per un'istanza VM, puoi inserire "latenza".
  3. Utilizza i menu per selezionare una risorsa e una metrica specifiche. Ad esempio, potresti effettuare le seguenti scelte:
    
    Nel menu Risorse attive, seleziona Istanza VM.
    
    Nel menu Categorie di metriche attive, seleziona uptime_check.
    
    Nel menu Metriche attive, seleziona Latenza richiesta.
    
    Fai clic su Applica.
  4. (Facoltativo) Per specificare un sottoinsieme di dati da visualizzare, seleziona Aggiungi filtro e completa la finestra di dialogo. Ad esempio, puoi visualizzare i dati per una zona applicando un filtro. Puoi aggiungere più filtri. Per maggiori informazioni, consulta la pagina Filtrare i dati dei grafici.
- Per registrare un obiettivo del livello di servizio o il numero di processi in esecuzione sulle VM, inserisci un filtro Monitoring:
  1. Fai clic su Guida nel menu Seleziona una metrica.
  2. Seleziona Modalità filtro diretto.
  3. Inserisci un filtro Monitoring nella casella di testo.
Per ulteriori informazioni, consulta Selezionare le metriche quando si utilizza Metrics Explorer

(Facoltativo) Raggruppare e allineare le serie temporali
- Per visualizzare tutte le serie temporali, lascia vuoti i campi Group By e Aggregator.
- Per raggruppare le serie temporali in base a un'etichetta, utilizza il campo Group by (Raggruppa per). Se selezioni un valore per questo campo, viene selezionato automaticamente anche un valore per il campo Aggregatore.
- Per specificare come combinare le serie temporali, imposta il campo Aggregatore. Ad esempio, se il campo Raggruppa per è vuoto e il campo Aggregatore è impostato su media, il grafico mostra la media delle serie temporali.
- Per configurare l'elaborazione delle singole serie temporali, seleziona Opzioni avanzate.
Per saperne di più, vedi Scegliere come visualizzare i dati dei grafici.
Scheda MQL

Inserisci la query nell'Editor query. Ad esempio, per registrare l'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
```
I seguenti documenti forniscono informazioni su MQL:
- Introduzione a MQL
- Utilizzo dell'Editor query
Scheda PromQL

Inserisci la query nell'Editor query. Ad esempio, per tracciare un grafico dell'utilizzo medio della CPU delle istanze VM nel 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.
Se a un grafico è associato un tipo di metrica di quota o un tipo di valore Distribution, aggiorna lo stile del grafico e l'impostazione di controllo dell'ora. Per gli altri tipi di metriche, la modifica dei valori predefiniti è facoltativa.

Per i tipi di metriche della quota, utilizza le seguenti impostazioni:
- Imposta il controllo del tempo su almeno una settimana, perché queste metriche in genere segnalano un campione al giorno.
- Nella barra degli strumenti di Metrics Explorer, seleziona Grafico a linee, quindi seleziona Grafico ad area in pila dal menu.
Per i tipi di metriche con valori di distribuzione, utilizza le seguenti impostazioni:
- Nella barra degli strumenti di Metrics Explorer, seleziona Grafico a linee, quindi seleziona Grafico mappa termica. Per ulteriori informazioni, consulta le metriche di distribuzione.
(Facoltativo) Per aggiungere una soglia al grafico, visualizza solo i valori anomali, confronta i dati attuali con i dati precedenti o modifica l'impostazione relativa al colore, seleziona Impostazioni. Per ulteriori informazioni sulle opzioni disponibili, consulta l'articolo Impostare le opzioni di visualizzazione.

Grafico di più tipi di metriche

In alcuni casi, potresti voler visualizzare le serie temporali di diversi tipi di metriche sullo stesso grafico. Ad esempio, per confrontare i carichi di lettura e scrittura su una VM, configura un grafico per visualizzare il numero di byte letti e il numero di byte scritti.

Per registrare più metriche, devi utilizzare la scheda Configurazione. L'interfaccia MQL in Metrics Explorer non supporta la creazione di grafici per più metriche.

Per visualizzare più metriche su un grafico:

Nella console Google Cloud, seleziona Monitoring o fai clic sul pulsante seguente:
Vai a Monitoring
Nel riquadro di navigazione, seleziona Metrics Explorer .
Seleziona la scheda Configurazione.
Seleziona una risorsa e una metrica procedendo in uno dei seguenti modi:
- Per registrare un tipo di metrica, ad esempio l'utilizzo della CPU di una VM, procedi come segue:
  1. Espandi il menu Seleziona una metrica.
  2. (Facoltativo) Per limitare il numero di scelte, inserisci il nome della metrica o della risorsa nella barra dei filtri. Ad esempio, per tracciare la latenza di richiesta per un'istanza VM, puoi inserire "latenza".
  3. Utilizza i menu per selezionare una risorsa e una metrica specifiche. Ad esempio, potresti effettuare le seguenti scelte:
    1. Nel menu Risorse attive, seleziona Istanza VM.
    2. Nel menu Categorie di metriche attive, seleziona uptime_check.
    3. Nel menu Metriche attive, seleziona Latenza richiesta.
    4. Fai clic su Applica.
  4. (Facoltativo) Per specificare un sottoinsieme di dati da visualizzare, seleziona Aggiungi filtro e completa la finestra di dialogo. Ad esempio, puoi visualizzare i dati per una zona applicando un filtro. Puoi aggiungere più filtri. Per maggiori informazioni, consulta la pagina Filtrare i dati dei grafici.
- Per registrare un obiettivo del livello di servizio o il numero di processi in esecuzione sulle VM, inserisci un filtro Monitoring:
  1. Fai clic su Guida nel menu Seleziona una metrica.
  2. Seleziona Modalità filtro diretto.
  3. Inserisci un filtro Monitoring nella casella di testo.
Per ulteriori informazioni, consulta Selezionare le metriche quando si utilizza Metrics Explorer
(Facoltativo) Raggruppa e allinea le serie temporali:
- Per visualizzare tutte le serie temporali, lascia vuoti i campi Group By e Aggregator.
- Per raggruppare le serie temporali in base a un'etichetta, utilizza il campo Group by (Raggruppa per). Se selezioni un valore per questo campo, viene selezionato automaticamente anche un valore per il campo Aggregatore.
- Per specificare come combinare le serie temporali, imposta il campo Aggregatore. Ad esempio, se il campo Raggruppa per è vuoto e il campo Aggregatore è impostato su media, il grafico mostra la media delle serie temporali.
- Per configurare l'elaborazione delle singole serie temporali, seleziona Opzioni avanzate.
Per saperne di più, vedi Scegliere come visualizzare i dati dei grafici.
Per ogni tipo di metrica aggiuntivo, procedi nel seguente modo:
1. Seleziona Aggiungi un'altra metrica.
  
  La prima volta che fai clic su Aggiungi un'altra metrica, le selezioni che hai effettuato in precedenza vengono mostrate nel riquadro espandibile Serie temporali A. Inoltre, si apre il riquadro Serie temporale B. Questo riquadro contiene i campi di configurazione completati per registrare la seconda metrica.
  
  Il seguente screenshot illustra questo comportamento:
2. Per specificare la metrica da aggiungere al grafico, utilizza le opzioni di configurazione nel nuovo riquadro. Ad esempio, per la seconda metrica, utilizza i campi nel riquadro Serie B.

Grafico di un rapporto di metriche

Monitorare il numero di errori segnalati potrebbe essere utile; tuttavia, è più probabile che tu debba monitorare la percentuale di errori. In altre parole, vuoi sapere quanti errori si sono verificati rispetto al numero totale di risposte. Per soddisfare questo requisito, puoi configurare un grafico per visualizzare il rapporto di due metriche. Per riferimenti agli esempi e per informazioni sulle anomalie che possono verificarsi quando grafici rapporti sulle metriche, consulta Rapporti sulle metriche.

Per visualizzare il rapporto delle metriche su un grafico:

Nella console Google Cloud, seleziona Monitoring o fai clic sul pulsante seguente:
Vai a Monitoring
Nel riquadro di navigazione, seleziona Metrics Explorer .
Specifica i dati da visualizzare nel grafico. Per utilizzare un'interfaccia basata su menu o per inserire un filtro Monitoring, seleziona la scheda Configurazione. Per utilizzare l'approccio MQL, seleziona la scheda MQL:
Scheda Configurazione
1. Configura il numeratore:
  1. Per selezionare una risorsa e una metrica, utilizza i menu.
  2. (Facoltativo) Per limitare le serie temporali mostrate, aggiungi i filtri.
  3. (Facoltativo) Aggiorna i campi di raggruppamento e i parametri di allineamento.
2. Seleziona Aggiungi un'altra metrica.
  
  Quando fai clic su Aggiungi un'altra metrica, le selezioni effettuate in precedenza vengono visualizzate nel riquadro Serie temporali A. Inoltre, si apre il riquadro Serie temporale B. Questo riquadro contiene i campi di configurazione completati per inserire nel grafico la seconda metrica.
  
  Il seguente screenshot illustra questo comportamento:
3. Configura il denominatore:
  1. Per selezionare una risorsa e una metrica per il denominatore, utilizza i menu nel riquadro Serie temporale B.
    
    Entrambe le metriche devono avere lo stesso tipo. Ad esempio, se la metrica Serie temporale A è una metrica GAUGE, la metrica selezionata per Serie temporale B deve essere una metrica GAUGE.
  2. (Facoltativo) Per limitare le serie temporali mostrate, aggiungi i filtri.
  3. Assicurati che il valore del campo Periodo di allineamento minimo sia lo stesso per entrambe le metriche.
  4. Imposta i parametri di raggruppamento per la seconda metrica.
    
    Consigliamo di fare in modo che i campi di raggruppamento della seconda metrica corrispondano ai valori per Serie temporali-A. Ad esempio, puoi raggruppare entrambe le metriche in base all'etichetta zone.
    
    Non è necessario utilizzare lo stesso raggruppamento per entrambe le metriche, tuttavia puoi raggruppare solo le etichette comuni a entrambe le metriche.
4. Attiva Visualizza metriche come rapporto.
  
  Dopo aver effettuato la selezione, l'etichetta Serie temporale A viene rinominata Numeratore, mentre l'etichetta Serie temporale B viene rinominata Denominatore.
5. (Facoltativo) Per cambiare la metrica corrispondente al numeratore, fai clic su Scambia numeratore.
6. (Facoltativo) Espandi Mostra opzioni rapporto per configurare le opzioni di aggregazione secondaria.
Scheda MQL

Inserisci la query nell'Editor query. Ad esempio, per registrare l'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
```
I seguenti documenti forniscono informazioni su MQL:
- Introduzione a MQL
- Utilizzo dell'Editor query
- Proporzioni di calcolo
Scheda PromQL

Inserisci la query nell'Editor query. Ad esempio, per tracciare un grafico del rapporto di latenza media della metrica my_summary_latency_seconds, utilizza la seguente query:
```
sum without (instance)(rate(my_summary_latency_seconds_sum[5m])) /
sum without (instance)(rate(my_summary_latency_seconds_count[5m]))
```
Per ulteriori informazioni sull'utilizzo di PromQL, consulta PromQL in Cloud Monitoring.

Salvare un grafico come riferimento futuro

Metrics Explorer ti consente di creare un grafico da utilizzare per esplorare una metrica. Tuttavia, i grafici creati da questo strumento non sono permanenti. Quando esci dalla pagina Metrics Explorer, il grafico viene eliminato.

Per salvare un grafico che hai configurato con Metrics Explorer come riferimento futuro, aggiungi il grafico a una dashboard personalizzata o salva l'URL del grafico:

Per aggiungere il grafico a una dashboard personalizzata, puoi:
- Se utilizzi la console Google Cloud per gestire le dashboard personalizzate, seleziona Salva grafico nella barra degli strumenti di Metrics Explorer e completa la finestra di dialogo. Puoi salvare il grafico in una dashboard personalizzata esistente o crearne una esistente.
- Se utilizzi l'API Cloud Monitoring per gestire le tue dashboard personalizzate, aggiorna il file JSON che definisce la dashboard e i suoi contenuti. Puoi accedere alla rappresentazione JSON dal menu Altre opzioni che si trova nella barra degli strumenti di Metrics Explorer.
  
  Per informazioni dettagliate sull'utilizzo dell'API per gestire le dashboard personalizzate, consulta Gestire le dashboard tramite API.
Per mantenere un riferimento alla configurazione del grafico, salva l'URL del grafico. Poiché l'URL del grafico codifica la configurazione del grafico, quando incolli questo URL in un browser viene visualizzato il grafico che hai configurato.

Per ottenere l'URL del grafico, seleziona Altre opzioni nella barra degli strumenti di Metrics Explorer, poi seleziona Condividi tramite URL.

Salvare la configurazione di un grafico

Quando gestisci le dashboard personalizzate utilizzando l'API Cloud Monitoring, puoi utilizzare Metrics Explorer per creare i dati che fornisci all'API:

Per generare la rappresentazione JSON di un grafico che prevedi di aggiungere a una dashboard, configura il grafico con Metrics Explorer. Puoi quindi utilizzare le opzioni di Metrics Explorer per visualizzare e copiare la rappresentazione JSON del grafico.
Per identificare la sintassi di un filtro di Monitoring utilizzato con l'API Cloud Monitoring, usa l'interfaccia basata su menu di Metrics Explorer per configurare il grafico. Dopo aver selezionato la metrica e i filtri, passa alla modalità filtro diretto per visualizzare il filtro di Monitoring equivalente.

Creare grafici con Metrics Explorer

Tracciare un singolo tipo di metrica

Scheda Configurazione

Seleziona i dati della serie temporale che vuoi visualizzare

(Facoltativo) Raggruppare e allineare le serie temporali

Scheda MQL

Scheda PromQL