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 mostri i dati più recenti. Se vuoi grafici permanenti, puoi crearne uno utilizzando Metrics Explorer e salvarlo in una dashboard personalizzata. Un'alternativa è creare una dashboard personalizzata, che può visualizzare grafici, log, incidenti e altri contenuti, quindi utilizzare l'interfaccia della dashboard per aggiungere grafici. Per informazioni sulle dashboard personalizzate, consulta Creare e gestire dashboard personalizzate.

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

Lo screenshot seguente mostra un singolo tipo di metrica, l'utilizzo della CPU di un'istanza VM, riportato in un grafico nella pagina Esplora metriche:

Metrica rappresentata in un grafico utilizzando Metrics Explorer.

Lo screenshot precedente mostra più righe, ognuna delle quali mostra l'utilizzo medio della CPU per tutte le VM in una zona specifica.

Grafico di un singolo tipo di metrica

Per configurare un grafico in modo che mostri una singola metrica:

  1. Nella console Google Cloud, vai alla pagina  Esplora metriche:

    Vai a Esplora metriche

    Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.

  2. Specifica i dati da visualizzare nel grafico. Puoi utilizzare un'interfaccia basata su menu, Monitoring Query Language (MQL), PromQL o inserire un filtro di monitoraggio:

    1. Seleziona i dati delle serie temporali che vuoi visualizzare:

      1. 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 barra dei filtri. Ad esempio, se inserisci util, il menu mostrerà solo le voci che includono util. Le voci vengono mostrate quando superano un test "contiene" senza distinzione tra maiuscole e minuscole.

        • 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.

        Ad esempio, puoi fare 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.

      2. (Facoltativo) Per specificare un sottoinsieme di dati da visualizzare, nell'elemento Filtro, seleziona Aggiungi filtro e poi compila la finestra di dialogo. Ad esempio, puoi visualizzare i dati relativi a una zona applicando un filtro. Puoi aggiungere più filtri. Per ulteriori informazioni, consulta la pagina Filtrare i dati dei grafici.

      Per ulteriori informazioni, consulta Selezionare i dati da includere nel grafico.

    2. Combina e allinea le serie temporali:

      • Per visualizzare ogni serie temporale, nell'elemento Aggregazione, imposta il primo menu su Non aggregata e il secondo su Nessuna.

      • Per combinare le serie temporali, nell'elemento Aggregation (Aggregazione), procedi nel seguente modo:

        1. 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.

        2. Per combinare le serie temporali con gli stessi valori delle etichette, espandi il secondo menu e 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.

          Quando il secondo menu è impostato su Nessuna, il grafico mostra una serie temporale.

      • (Facoltativo) Per configurare la spaziatura tra i punti dati, fai clic su Aggiungi elemento query, seleziona Intervallo min, quindi inserisci un valore.

      Per ulteriori informazioni su raggruppamento e allineamento, consulta Scegliere come visualizzare i dati dei grafici.

    3. (Facoltativo) Per visualizzare solo le serie temporali con i valori più alti o più bassi, utilizza l'elemento Ordina e limita.

    MQL

    1. Nella barra degli strumenti del riquadro Query Builder, seleziona il pulsante  MQL o  PromQL.
    2. 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.

    3. 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:

    PromQL

    1. Nella barra degli strumenti del riquadro Query Builder, seleziona il pulsante  MQL o  PromQL.
    2. Verifica che PromQL sia selezionato 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.

    3. Inserisci la query nell'editor delle 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.

    Filtro di monitoraggio

    1. Nell'elemento Metrica, fai clic su Guida e poi seleziona Modalità di filtro diretto.

      Gli elementi Metrica e Filtro vengono eliminati e viene creato un elemento Filtri che consente di inserire del testo.

      Se hai selezionato un tipo di risorsa, una metrica o filtri prima di passare alla modalità Filtro diretto, queste impostazioni vengono visualizzate nel campo dell'elemento Filtri.

    2. Inserisci un filtro di monitoraggio nel campo dell'elemento Filtri.

    3. Combina e allinea le serie temporali:

      • Per visualizzare ogni serie temporale, nell'elemento Aggregazione, imposta il primo menu su Non aggregata e il secondo su Nessuna.

      • Per combinare le serie temporali, nell'elemento Aggregation (Aggregazione), procedi nel seguente modo:

        1. 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.

        2. Per combinare le serie temporali con gli stessi valori delle etichette, espandi il secondo menu e 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.

          Quando il secondo menu è impostato su Nessuna, il grafico mostra una serie temporale.

      • (Facoltativo) Per configurare la spaziatura tra i punti dati, fai clic su Aggiungi elemento query, seleziona Intervallo min, quindi inserisci un valore.

      Per ulteriori informazioni su raggruppamento e allineamento, consulta Scegliere come visualizzare i dati dei grafici.

  3. Aggiorna le impostazioni del grafico in base al tipo di metrica selezionato:

    • Per i tipi di metriche relative alle quote, utilizza le seguenti impostazioni:

      • Nella barra degli strumenti, imposta il controllo del tempo su almeno una settimana. Le metriche relative alle quote in genere generano un campione al giorno.
      • Nel riquadro Visualizza, espandi il menu Tipo di widget e seleziona Grafico a barre in pila.

    • Per i tipi di metriche che hanno un tipo di valore Distribution, assicurati che il menu Tipo di widget sia impostato su Grafico di mappa di calore. Per ulteriori informazioni, consulta Informazioni sulle metriche con valori di distribuzione.

    • Per altri tipi di metriche, utilizza il menu Tipo di widget per visualizzare la modalità di visualizzazione dei dati. Il menu Tipo di widget elenca tutti i tipi di widget disponibili. Tuttavia, alcuni widget potrebbero non essere attivati. Considera un grafico che mostra più serie temporali e supponi che ogni valore misurato sia un doppio:

      • I widget Grafico a linee, Grafico a barre in pila e Grafico ad area in pila sono contrassegnati come Compatibile. Puoi selezionare uno di questi tipi.
      • Il widget Mappa termica è disattivato perché questi widget possono mostrare solo i dati con valori di distribuzione.

  4. (Facoltativo) Per modificare il modo in cui un grafico o una tabella mostra i dati selezionati, utilizza le opzioni nel riquadro Visualizza:

Grafico con più tipi di metriche

In alcuni casi, potresti voler visualizzare le serie temporali di diversi tipi di metrica nello 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 creare un grafico con più metriche, devi utilizzare l'interfaccia basata su menu. Le altre interfacce non supportano la visualizzazione di più metriche in un grafico.

Per visualizzare più metriche in un grafico:

  1. Nella console Google Cloud, vai alla pagina  Esplora metriche:

    Vai a Esplora metriche

    Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.

  2. Specifica i dati da visualizzare nel grafico.

    1. Nell'elemento Metrica, seleziona il primo tipo di metrica di cui vuoi visualizzare i dati. Per informazioni su questi passaggi, consulta Creare un grafico per un singolo tipo di metrica.

      La query per questa selezione ha l'identificatore A.

    2. Per ogni tipo di metrica aggiuntiva, svolgi i seguenti passaggi:

      1. Seleziona Aggiungi query. Viene aggiunta una nuova query. Ad esempio, potrebbe essere aggiunta una query con l'etichetta B.

      2. Per la nuova query, nell'elemento Metrica, seleziona un tipo di risorsa e un tipo di metrica. Puoi anche aggiungere filtri, combinare serie temporali, e ordinare e limitare il numero di serie temporali visualizzate.

      Lo screenshot seguente mostra la visualizzazione di Metrics Explorer quando sono presenti due tipi di metriche nel grafico:

      Esempio di Metrics Explorer con due tipi di metriche.

    3. (Facoltativo) Nel riquadro Visualizza, espandi il menu Asse Y e configura l'asse Y da utilizzare per ogni tipo di metrica.

    MQL

    Non supportati.

    PromQL

    Non supportati.

    Filtro di monitoraggio

    Non supportati.

Grafico di un rapporto di metriche

Il monitoraggio del numero di errori segnalati potrebbe essere utile, ma è più probabile che tu debba monitorare la frequenza degli 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 tra due metriche. Per riferimenti a esempi e per informazioni sulle anomalie che possono verificarsi quando rappresenti i rapporti delle metriche, consulta Rapporti delle metriche.

Per visualizzare un rapporto tra metriche in un grafico:

  1. Nella console Google Cloud, vai alla pagina  Esplora metriche:

    Vai a Esplora metriche

    Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.

  2. Specifica i dati da visualizzare nel grafico:

    1. Configura il numeratore:

      1. Nell'elemento Metrica, utilizza i menu per selezionare un tipo di risorsa e un tipo di metrica. Per informazioni su questi passaggi, consulta Creare un grafico per un singolo tipo di metrica.
      2. Aggiorna i campi di aggregazione. Per impostazione predefinita, calcola la media di tutte le serie temporali.
      3. (Facoltativo) Aggiorna la durata fissa del periodo di tempo per i punti all'interno di una serie temporale da combinare. Per modificare questo campo, fai clic su Aggiungi elemento di query, seleziona Intervallo min e completa la finestra di dialogo.

    2. Seleziona Aggiungi query e configura il denominatore:

      1. Per la nuova query, nell'elemento Metrica, seleziona un tipo di risorsa e un tipo di metrica.

        Seleziona un tipo di metrica il cui tipo di metrica è uguale a quello del numeratore. Ad esempio, se la metrica del numeratore è una metrica GAUGE, seleziona una metrica GAUGE per il denominatore.

      2. Aggiorna i campi di aggregazione.

        Ti consigliamo di impostare le etichette per il tipo di metrica del denominatore in modo che corrispondano ai valori impostati per il tipo di metrica del numeratore. Ad esempio, puoi selezionare l'etichetta zone per il numeratore e il denominatore.

        Non è necessario utilizzare lo stesso insieme di etichette per entrambi i tipi di metriche. Tuttavia, puoi selezionare solo le etichette comuni a entrambi i tipi di metriche.

      3. Fai clic su Aggiungi elemento di query, seleziona Intervallo min e assicurati che questo campo sia impostato sul valore utilizzato dal numeratore.

    3. Nella barra degli strumenti del riquadro delle query, seleziona Crea rapporto e poi completa la finestra di dialogo.

      Dopo aver creato il rapporto, vengono visualizzate tre query:

      • Rapporto A/B identifica la query sul rapporto.
      • A identifica la query per il numeratore.
      • B identifica la query per il denominatore.

      L'esempio seguente illustra un rapporto che confronta la somma dei byte scritti sul disco per zona con il numero totale di byte scritti sul disco:

      Esempio di un rapporto tra metriche.

    4. (Facoltativo) Per cambiare le metriche del numeratore e del denominatore, espandi il menu nell'elemento Rapporto e poi seleziona una voce.

    MQL

    1. Nella barra degli strumenti del riquadro Query Builder, seleziona il pulsante  MQL o  PromQL.
    2. 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.

    3. Inserisci la query nell'editor delle query. MQL ti consente di calcolare il rapporto tra due metriche diverse, filtrare una singola metrica in base a un'etichetta e poi calcolare il rapporto. La seguente query calcola il rapporto tra le risposte con un valore di 500 e il numero totale di risposte:

      fetch https_lb_rule::loadbalancing.googleapis.com/https/request_count
| {
    filter response_code_class = 500
  ;
    ident
  }
| group_by [matched_url_path_rule]
| outer_join 0
| div

      Per ulteriori informazioni su MQL, consulta i seguenti documenti:

    PromQL

    1. Nella barra degli strumenti del riquadro Query Builder, seleziona il pulsante  MQL o  PromQL.
    2. Verifica che PromQL sia selezionato 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.

    3. Inserisci la query nell'editor delle query. Ad esempio, per tracciare il rapporto tra la 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.

    Filtro di monitoraggio

    Non supportati.

Salvare un grafico per 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 ignorato.

Per salvare un grafico configurato con Metrics Explorer come riferimento futuro, aggiungilo a una dashboard personalizzata o salvane l'URL:

  • Per aggiungere il grafico a una dashboard personalizzata, svolgi una delle seguenti operazioni:

    • 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.

    • Se utilizzi l'API Cloud Monitoring per gestire le dashboard personalizzate, aggiornate il file JSON che definisce la dashboard e i relativi contenuti. Per accedere alla rappresentazione JSON, fai clic su  Editor JSON nella barra degli strumenti del grafico.

      Per informazioni dettagliate sull'utilizzo dell'API per gestire le dashboard personalizzate, consulta Creare e gestire dashboard tramite API.

  • Per conservare un riferimento alla configurazione del grafico, salva l'URL del grafico. Poiché l'URL del grafico codifica la relativa configurazione, quando incolli questo URL in un browser viene visualizzato il grafico configurato.

    Per ottenere l'URL del grafico, fai clic su Collega nella barra degli strumenti del grafico.

Salvare la configurazione di un grafico

Quando gestisci le dashboard personalizzate utilizzando l'API Cloud Monitoring, puoi utilizzare Metrics Explorer per aiutarti a creare i dati da fornire 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 in Metrics Explorer per visualizzare e copiare la rappresentazione JSON del grafico.

  • Per identificare la sintassi di un filtro di monitoraggio, utilizzato con l'API Cloud Monitoring, utilizza l'interfaccia basata su menu di Metrics Explorer per configurare il grafico. Dopo aver selezionato la metrica e i filtri, passa alla modalità di filtro diretto per visualizzare il filtro di monitoraggio equivalente.

Salvare i dati visualizzati dal grafico

Per salvare i dati visualizzati dal grafico nel tuo sistema locale, fai clic su Scarica CSV.

Passaggi successivi