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 le metriche di una macchina virtuale (VM), puoi usare Metrics Explorer costruisci un grafico che mostra i dati più recenti. Se vuoi un accesso permanente puoi creare un grafico utilizzando Metrics Explorer e salvarla 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 illustrano un singolo tipo di metrica, e complessi, come quelli che illustrano più tipi di metriche. Dopo aver creato un grafico con Metrics Explorer, puoi ignorarlo, salvarle in una dashboard personalizzata, salvarne la configurazione o condividerla.

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

Lo screenshot precedente mostra più righe, ciascuna delle quali mostra la media Utilizzo della CPU per tutte le VM in una zona specifica.

Nota: se stai visualizzando un grafico presente in una dashboard e vuoi esaminare configurazione del grafico o copiarlo in una dashboard diversa, quindi verifica le opzioni del grafico consentono di visualizzare Metrics Explorer del grafico. Quando selezioni questa opzione, Metrics Explorer è aperto e mostra i dati che visualizzazione. Puoi quindi visualizzare o modificare la configurazione, oppure puoi salvarlo in una dashboard personalizzata.

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

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:

   Interfaccia basata su menu

   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, limiti il menu a mostra le voci che includono util. 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 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, quindi per completare la finestra di dialogo. Ad esempio, è possibile visualizzare i dati per una zona applicando un filtro. Puoi aggiungere più filtri. Per ulteriori informazioni, vedi Filtrare i dati dei grafici.

      Per ulteriori informazioni, vedi Seleziona 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 Nessuno.

      • Per combinare le serie temporali nell'elemento Aggregation: 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 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 una combinazione di valori di 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 temporali.

      • (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 della riquadro Query Builder, seleziona il pulsante con  MQL o  PromQL.
   2. Verifica che sia selezionato MQL con l'opzione 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 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:

      • Introduzione a MQL
      • Utilizzo dell'editor di codice per MQL

   PromQL

   1. Nella barra degli strumenti della riquadro Query Builder, seleziona il pulsante con  MQL o  PromQL.
   2. Verifica che PromQL sia selezionato con l'opzione 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 tracciare un grafico CPU delle istanze VM nel tuo progetto Google Cloud, usa 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 Filtri 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 Monitoring nel campo del 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 Nessuno.

      • Per combinare le serie temporali nell'elemento Aggregation: 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 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 una combinazione di valori di 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 temporali.

      • (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. 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. Quota di solito riportano un campione al giorno.
     • Nel riquadro Display, espandi 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, vedi Informazioni sulle metriche basate sul valore 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 visualizzare solo con valore di distribuzione.

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

   • Per configurare il grafico in visualizzare in modalità a raggi X o per visualizzare le statistiche, fai clic su Modalità di analisi.
   • Per confrontare i dati attuali con quelli passati: fai clic su Confronta con i dati precedenti.
   • Per aggiungere una soglia di riferimento, fai clic su Linea della soglia.
   • Per configurare il nome di una colonna della legenda, fai clic su Alias legenda.
   • Per configurare l'assegnazione, le etichette o l'assegnazione dell'asse Y scala, utilizza la classe Menu Assegnazione asse Y, Etichette asse Y e scala dell'asse Y.

Traccia più tipi di metriche in un grafico

In alcune situazioni potresti voler visualizzare serie temporali di diverse tipi di metriche sullo 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. L'altro 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 Monitoraggio.

2. Specifica i dati da visualizzare nel grafico.

   Interfaccia basata su menu

   1. Nell'elemento Metrica, quindi seleziona il primo tipo di metrica di cui vuoi visualizzare i dati. Per informazioni su questi passaggi, vedi Tracciare un grafico con 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, una query con il parametro potrebbe essere aggiunta l'etichetta B.

      2. Per la nuova query, nell'elemento Metrica, seleziona una tipo di risorsa e 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:

      

   3. (Facoltativo) Nel riquadro Display, Espandi il menu dell'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.

Tracciare un grafico di un rapporto di metriche

Potrebbe essere utile monitorare il numero di errori segnalati. ma è più probabile che tu debba monitorare il tasso di errori. Vale a dire che Vuoi sapere quanti errori si sono verificati rispetto al totale il numero di risposte. Per soddisfare questo requisito, puoi configurare un grafico per visualizzare il rapporto di due metriche. Per i riferimenti agli esempi e per informazioni sulle anomalie che possono verificarsi quando rappresenti graficamente i rapporti delle metriche, consulta 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 Monitoraggio.

2. Specifica i dati da visualizzare nel grafico:

   Interfaccia basata su menu

   1. Configura il numeratore:

      1. Nell'elemento Metrica, utilizza i menu per selezionare una tipo di risorsa e tipo di metrica. Per informazioni su questi passaggi, vedi Tracciare un grafico con 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 in una serie temporale da combinare. Per modificare questo campo, fai clic su Aggiungi elemento di 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 una tipo di risorsa e tipo di metrica.

         Seleziona un tipo di metrica il cui tipo di metrica corrisponda al 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: potresti 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 della query, seleziona Crea rapporto, quindi per completare 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:

      

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

   MQL

   1. Nella barra degli strumenti della riquadro Query Builder, seleziona il pulsante con  MQL o  PromQL.
   2. Verifica che sia selezionato MQL con l'opzione 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. MQL consente di calcolare rapporto di due metriche diverse e ti consente di filtrare una singola metrica per un'etichetta e quindi 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:

      • Introduzione a MQL
      • Utilizzare l'editor di codice
      • Report di calcolo

   PromQL

   1. Nella barra degli strumenti della riquadro Query Builder, seleziona il pulsante con  MQL o  PromQL.
   2. Verifica che PromQL sia selezionato con l'opzione 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 usare per esplorare o una metrica di valutazione. Tuttavia, i grafici creati da questo strumento non sono permanenti. Quando esci dalla pagina Metrics Explorer, il grafico viene ignorato.

Per salvare in futuro un grafico configurato con Metrics Explorer riferimento, 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 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 una dashboard personalizzata, o puoi 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 configurazione del grafico, quando incolli questo URL in un browser in cui viene visualizzato il grafico che hai configurato.

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

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 Monitoring, utilizzata con l'API Cloud Monitoring, usa l'interfaccia basata su menu di Metrics Explorer per configurare il grafico. Dopo aver selezionato metriche e 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

• Esplorare i dati dei grafici
• Selezionare le metriche con Esplora metriche
• Visualizzare e gestire l'utilizzo delle metriche
• Impostare le opzioni di visualizzazione del grafico