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 Esplora metriche 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. In alternativa, puoi creare una dashboard personalizzata, che può visualizzare grafici, log, incidenti e altri contenuti, e utilizzare per aggiungere grafici alla dashboard. 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.

Il seguente screenshot mostra una singola di metrica (Utilizzo della CPU di un'istanza VM) tracciata nella Pagina Metrics Explorer:

Grafico delle metriche 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 uno dei seguenti basata su menu, Monitoring Query Language (MQL), PromQL oppure puoi inserire 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 attivo. Per impostazione predefinita, i menu mostrano solo tipi di metriche con dati.

        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.

      2. (Facoltativo) Per specificare un sottoinsieme di dati da visualizzare, selezionate Aggiungi filtro nell'elemento Filtro e completate 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 sezione Filtrare i dati dei grafici.

      Per ulteriori informazioni, vedi Seleziona i dati da rappresentare in un 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: segui questi passaggi:

        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 rappresenta la media di tutte le serie temporali.

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

          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 di query, seleziona Intervallo minimo, e inserisci un valore.

      Per ulteriori informazioni sul raggruppamento e sull'allineamento, consulta Scegli come visualizzare i dati dei grafici.

    3. (Facoltativo) Per visualizzare solo le serie temporali con il valore più alto o più basso utilizzare i campi Ordina e Limite.

    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 tracciare un grafico Utilizzo della CPU delle istanze VM nel progetto Google Cloud, utilizza 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 della riquadro Query Builder, seleziona il pulsante con  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. 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, quindi Seleziona Modalità filtro diretto.

      Gli elementi Metrica e Filtro vengono eliminati, mentre un elemento Filters viene eliminato. che ti consente di inserire 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. Combinare e allineare 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: segui questi passaggi:

        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 rappresenta la media di tutte le serie temporali.

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

          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 sul raggruppamento e sull'allineamento, consulta Scegli 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 con Distribution di valore, assicurati che il menu Tipo di widget sia impostato su Grafico a mappa termica: Per ulteriori informazioni, consulta Informazioni sulle metriche con valori di distribuzione.

    • Per altri tipi di metriche, utilizza il menu Tipo di widget per visualizzare il modo in cui vengono mostrati i dati. Il menu Tipo di widget elenca tutti i tipi di widget tipi di widget; tuttavia alcuni widget potrebbero non essere attivi. Considera un grafico che mostra più serie temporali e supponiamo che ogni valore misurato è un doppio:

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

  4. (Facoltativo) Per modificare la modalità di visualizzazione dei dati selezionati in un grafico o in una tabella, utilizza opzioni nel riquadro Visualizza:

Traccia più tipi di metriche in un grafico

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

Per rappresentare graficamente 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, una query con potrebbe essere aggiunta 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 per ordinare e limitare il numero di serie temporali visualizzate.

      Il seguente screenshot illustra la visualizzazione di Metrics Explorer quando vengono rappresentati due tipi di metriche:

      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 di 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 di metriche su 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, viene calcolata 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.

        Consigliamo di applicare le etichette per il tipo di metrica denominatore corrispondono ai valori impostati per il tipo di metrica 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 tipi di metriche.

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

    3. Nella barra degli strumenti del riquadro delle query, seleziona Crea rapporto, quindi 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 di i byte scritti su disco per zona, fino al numero totale di byte scritte su disco:

      Esempio di un rapporto di metriche.

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

    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 di 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 esegue il calcolo il rapporto tra le risposte con un valore pari a 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 della riquadro Query Builder, seleziona il pulsante con  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. consente di formattare la query.

    3. Inserisci la query nell'editor di query. Ad esempio, per rappresentare su grafico il rapporto latenza media della metrica my_summary_latency_seconds, utilizza 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 Esplora metriche per 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 tue dashboard personalizzate, e poi 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 usi l'API Cloud Monitoring per gestire le tue dashboard personalizzate, quindi aggiorna 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 le dashboard in base all'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 dashboard personalizzate utilizzando l'API Cloud Monitoring, puoi utilizzare Metrics Explorer per creare i dati che fornisci all'API:

  • a generare la rappresentazione JSON per un grafico che prevedi. per 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 a menu di Esplora metriche 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.

Salva i dati visualizzati dal grafico

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

Passaggi successivi