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

Puoi creare grafici (ad esempio quelli che illustrano un singolo tipo di metrica) e grafici complessi come quelli che illustrano 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, Utilizzo della CPU di un'istanza VM, tracciato nella pagina Metrics Explorer:

Grafico delle metriche utilizzando Metrics Explorer.

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

Tracciare un grafico con 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 oppure inserire un filtro di Monitoring:

    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 consentono di trovare i tipi di metriche disponibili:

        • Per trovare un tipo di metrica specifico, utilizza la barra dei filtri . Ad esempio, se inserisci util, limiti il menu in modo da mostrare 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, nell'elemento Filter seleziona Aggiungi filtro e completa la finestra di dialogo. Ad esempio, puoi visualizzare i dati relativi a una zona applicando un filtro. Puoi aggiungere più filtri. Per maggiori informazioni, vedi Filtrare i dati dei grafici.

      Per maggiori informazioni, consulta Selezionare i dati da rappresentare in un grafico.

    2. Combinare e allineare le serie temporali:

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

      • Per combinare le serie temporali, nell'elemento Aggregation:

        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 e seleziona una o più etichette.

          Il grafico viene aggiornato e mostra una serie temporale per ogni combinazione unica di valori delle etichette. Ad esempio, per visualizzare le serie temporali per zona, imposta il secondo menu su zone.

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

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

      Per ulteriori informazioni sul raggruppamento e sull'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 di creazione di query, seleziona il pulsante con il nome  MQL o  PromQL.
    2. Verifica che sia selezionato MQL nell'opzione di attivazione/disattivazione Lingua. L'opzione di attivazione/disattivazione della lingua si trova nella stessa barra degli strumenti che ti consente di formattare la query.

    3. Inserisci la query nell'editor di query. Ad esempio, per tracciare un grafico dell'utilizzo della CPU delle istanze VM nel tuo progetto Google Cloud, utilizza la query seguente:

      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 di creazione di query, seleziona il pulsante con il nome  MQL o  PromQL.
    2. Verifica che l'opzione PromQL sia selezionata nell'opzione di attivazione/disattivazione Lingua. L'opzione di attivazione/disattivazione della lingua si trova nella stessa barra degli strumenti che ti consente di formattare la query.

    3. Inserisci la query nell'editor di query. Ad esempio, per tracciare l'utilizzo medio delle CPU da parte delle istanze VM nel tuo progetto Google Cloud, utilizza questa 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 e viene creato un elemento Filtri che consente di inserire testo.

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

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

    3. Combinare e allineare le serie temporali:

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

      • Per combinare le serie temporali, nell'elemento Aggregation:

        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 e seleziona una o più etichette.

          Il grafico viene aggiornato e mostra una serie temporale per ogni combinazione unica di valori delle etichette. Ad esempio, per visualizzare le serie temporali per zona, imposta il secondo menu su zone.

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

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

      Per ulteriori informazioni sul raggruppamento e sull'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 di quota, utilizza le seguenti impostazioni:

      • Nella barra degli strumenti, imposta il controllo temporale su almeno una settimana. Le metriche delle quote di solito riportano un campione al giorno.
      • Nel riquadro Display, espandi il menu Tipo di widget e seleziona Grafico a barre in pila.

    • Per i tipi di metriche con un tipo di valore Distribution, 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 come vengono visualizzati i dati. Il menu Tipo di widget elenca tutti i tipi di widget disponibili, ma alcuni potrebbero non essere attivi. Considera un grafico che mostra più serie temporali e supponiamo che ogni valore misurato sia un doppio:

      • I widget Grafico a linee, Grafico a barre in pila e Grafico ad area in pila sono indicati come Compatibile. Puoi selezionare uno qualsiasi di questi tipi.
      • Il widget Heatmap è disattivato perché questi widget possono visualizzare solo dati con valori di distribuzione.

  4. (Facoltativo) Per modificare la modalità di visualizzazione dei dati selezionati nel grafico, utilizza le opzioni nel riquadro Visualizza:

Traccia più tipi di metriche in un grafico

In alcune situazioni, potrebbe essere utile visualizzare nello stesso grafico le serie temporali di tipi di metriche diversi. Ad esempio, per confrontare i carichi di lettura e scrittura su una VM, configura un grafico in modo da 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 creazione di grafici di più metriche.

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 di un singolo tipo di metrica.

      La query per questa selezione ha l'identificatore A.

    2. Per ogni tipo di metrica aggiuntiva:

      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.

      Il seguente screenshot illustra la visualizzazione di Metrics Explorer quando sono presenti due tipi di metriche:

      Esempio di Metrics Explorer con due tipi di metriche.

    3. (Facoltativo) Nel riquadro Visualizzazione, espandi il menu Asse Y e configura l'asse Y utilizzato per ciascun tipo di metrica.

    MQL

    Non supportati.

    PromQL

    Non supportati.

    Filtro di monitoraggio

    Non supportati.

Tracciare un grafico di un rapporto di metriche

Monitorare il numero di errori segnalati può 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 crei grafici dei rapporti delle metriche, consulta la sezione Report 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 di 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 il periodo di tempo fisso per i punti di una serie temporale da combinare. Per modificare questo campo, fai clic su Aggiungi elemento query, seleziona Intervallo minimo 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 corrisponda al numeratore. Ad esempio, se la metrica del numeratore è GAUGE, seleziona una metrica GAUGE per il denominatore.

      2. Aggiorna i campi di aggregazione.

        Consigliamo che le etichette per il tipo di metrica denominatore corrispondano 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, ma puoi selezionare solo le etichette comuni a entrambi i tipi di metriche.

      3. Fai clic su Aggiungi elemento di query, seleziona Intervallo minimo 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 su disco per zona con il numero totale di byte scritti su disco:

      Esempio di un rapporto di metriche.

    4. (Facoltativo) Per invertire le metriche numeratore e denominatore, nell'elemento Ratio espandi il menu, quindi effettua una selezione.

    MQL

    1. Nella barra degli strumenti del riquadro di creazione di query, seleziona il pulsante con il nome  MQL o  PromQL.
    2. Verifica che sia selezionato MQL nell'opzione di attivazione/disattivazione Lingua. L'opzione di attivazione/disattivazione della lingua si trova nella stessa barra degli strumenti che ti consente di formattare la query.

    3. Inserisci la query nell'editor di query. MQL consente di calcolare un rapporto di due metriche diverse e di filtrare una singola metrica in base a un'etichetta e quindi di calcolare il rapporto. La seguente query calcola 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 del riquadro di creazione di query, seleziona il pulsante con il nome  MQL o  PromQL.
    2. Verifica che l'opzione PromQL sia selezionata nell'opzione di attivazione/disattivazione Lingua. L'opzione di attivazione/disattivazione della lingua si trova nella stessa barra degli strumenti che ti consente di formattare la query.

    3. Inserisci la query nell'editor di query. Ad esempio, per tracciare il rapporto della 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 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 per riferimento futuro, aggiungi il grafico a una dashboard personalizzata o salva l'URL del grafico:

  • Per aggiungere il grafico a una dashboard personalizzata, procedi in uno dei seguenti modi:

    • 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, aggiorna il file JSON che definisce la dashboard e i suoi 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 configurazione del grafico, quando incolli questo URL in un browser viene visualizzato il grafico che hai configurato.

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

Salvare la configurazione di un grafico

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

  • Per generare la rappresentazione JSON per un grafico che intendi 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, 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 Monitoring 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