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 crearne uno utilizzando Metrics Explorer e salvarlo in una dashboard personalizzata. In alternativa, puoi creare una dashboard personalizzata in grado di visualizzare grafici, log, incidenti e altri contenuti e utilizzare l'interfaccia della dashboard per aggiungere grafici alla dashboard. Per informazioni sulle dashboard personalizzate, consulta Creare e gestire dashboard personalizzate.

Puoi creare grafici, ad esempio quelli che registrano un singolo tipo di metrica, e grafici complessi, ad esempio quelli che includono più tipi di metriche. Dopo aver creato un grafico con Metrics Explorer, puoi eliminarlo, 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:

Lo screenshot precedente mostra più righe, dove ogni riga mostra l'utilizzo medio della CPU per tutte le VM in una zona specifica.

Nota: se stai visualizzando un grafico in una dashboard e vuoi visualizzarne la configurazione o copiarlo in un'altra dashboard, controlla se le opzioni del grafico ti consentono di visualizzare il grafico Metrics Explorer. Quando selezioni questa opzione, si apre Metrics Explorer e vengono visualizzati i dati che stavi visualizzando. Puoi quindi visualizzare o modificare la configurazione oppure salvare il grafico in una dashboard personalizzata.

Tracciare un grafico con un singolo tipo di metrica

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

1. Nel pannello di navigazione della console Google Cloud, seleziona Monitoring e poi  Metrics Explorer:

   Vai a Metrics Explorer

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

   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 alla visualizzazione delle voci che includono util. Le voci vengono mostrate quando superano un test "contains" senza distinzione tra maiuscole e minuscole.

         • Per visualizzare tutti i tipi di metriche, anche quelli senza dati, fai clic su Attivo. Per impostazione predefinita, i menu mostrano solo i 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 Filtro, seleziona Aggiungi filtro, quindi completa la finestra di dialogo. Ad esempio, puoi visualizzare i dati per una zona applicando un filtro. Puoi aggiungere più filtri. Per ulteriori informazioni, consulta Filtrare i dati dei grafici.

      Per maggiori informazioni, consulta Selezionare i dati da tracciare.

   2. Combinare e allineare le serie temporali:

      • Per visualizzare tutte le serie temporali, nell'elemento Aggregation imposta il primo menu su Unaggregated (Non aggregato) e il secondo su None.

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

      Per ulteriori informazioni sul raggruppamento e sull'allineamento, consulta la sezione 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 del generatore di query, seleziona il pulsante il cui nome è  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 query. Ad esempio, per tracciare un grafico sull'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 saperne di più su MQL, consulta i seguenti documenti:

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

   PromQL

   1. Nella barra degli strumenti del riquadro del generatore di query, seleziona il pulsante il cui nome è  MQL o  PromQL.
   2. Verifica che sia selezionato PromQL 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 query. Ad esempio, per tracciare un grafico dell'utilizzo medio della CPU delle istanze VM nel tuo progetto Google Cloud, utilizza la query seguente:

      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 sulla Guida e seleziona Modalità filtro diretto.

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

      Se hai selezionato un tipo di risorsa, una metrica o un filtro prima di passare alla modalità di filtro diretto, queste impostazioni vengono mostrate 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 tutte le serie temporali, nell'elemento Aggregation imposta il primo menu su Unaggregated (Non aggregato) e il secondo su None.

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

      Per ulteriori informazioni sul raggruppamento e sull'allineamento, consulta la sezione 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 dell'ora su almeno una settimana. Le metriche relative alle quote segnalano in genere un campione al giorno.
     • Nel riquadro Visualizzazione, 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 mappa termica. Per scoprire di più, consulta Informazioni sulle metriche con valori di distribuzione.

   • Per altri tipi di metriche, usa il menu Tipo di widget per visualizzare come vengono mostrati i 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 supponiamo che ogni valore misurato sia doppio:

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

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

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

Tracciare un grafico di più tipi di metriche

In alcuni casi, potresti voler visualizzare serie temporali di tipi di metriche diversi 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 tracciare più metriche in un grafico, 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. Nel pannello di navigazione della console Google Cloud, seleziona Monitoring e poi  Metrics Explorer:

   Vai a Metrics Explorer

2. Specifica i dati da visualizzare nel grafico.

   Interfaccia basata su menu

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

      La query per questa selezione ha l'identificatore A.

   2. Per ogni tipo di metrica aggiuntivo:

      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, ordinare e limitare il numero

      Lo screenshot seguente illustra la visualizzazione di Metrics Explorer quando sono rappresentati in grafico due tipi di metriche:

      

   3. (Facoltativo) Nel riquadro Display, 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 del rapporto di metriche

Monitorare il numero di errori segnalati potrebbe essere utile, ma è più probabile che tu debba monitorare la percentuale di errori. In altre parole, vuoi sapere quanti errori si sono verificati misurati rispetto al numero totale di risposte. Per soddisfare questo requisito, puoi configurare un grafico in modo che mostri il rapporto tra due metriche. Per i riferimenti agli esempi e per informazioni sulle anomalie che possono verificarsi quando crei un grafico dei rapporti delle metriche, consulta Rapporto delle metriche.

Per visualizzare un rapporto delle metriche su un grafico:

1. Nel pannello di navigazione della console Google Cloud, seleziona Monitoring e poi  Metrics Explorer:

   Vai a Metrics Explorer

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 un tipo di risorsa e un tipo di metrica. Per informazioni su questi passaggi, consulta Tracciare un grafico di 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 per i punti all'interno di 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 un tipo di risorsa e un tipo di metrica.

         Seleziona un tipo di metrica il cui tipo di metrica sia uguale al numeratore. Ad esempio, se la metrica del numeratore è una metrica GAUGE, seleziona una metrica GAUGE come denominatore.

      2. Aggiorna i campi di aggregazione.

         Ti consigliamo che le etichette per il tipo di metrica del denominatore 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 set di etichette per entrambi i tipi di metrica; tuttavia, puoi selezionare solo le etichette comuni a entrambi i tipi di metrica.

      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, 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 dei byte scritti su disco per zona e il numero totale di byte scritti su disco:

      

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

   MQL

   1. Nella barra degli strumenti del riquadro del generatore di query, seleziona il pulsante il cui nome è  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 query. MQL consente di calcolare un rapporto tra due metriche diverse e di filtrare una singola metrica in base a un'etichetta per calcolare il rapporto. La seguente query calcola il rapporto tra le risposte con un valore 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 saperne di più su MQL, consulta i seguenti documenti:

      • Introduzione a MQL
      • Utilizzo dell'editor di codice
      • Rapporto di calcolo

   PromQL

   1. Nella barra degli strumenti del riquadro del generatore di query, seleziona il pulsante il cui nome è  MQL o  PromQL.
   2. Verifica che sia selezionato PromQL 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 query. Ad esempio, per rappresentare su grafico il rapporto di latenza media della metrica my_summary_latency_seconds, utilizza la query seguente:

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

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, esegui una delle seguenti operazioni:

  • Se utilizzi la console Google Cloud per gestire le tue 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 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 per 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, fai clic su Link 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 forniti all'API:

• Per generare la rappresentazione JSON per 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, 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 nel 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 Metrics Explorer
• Visualizzare l'utilizzo e la diagnostica delle metriche
• Impostare le opzioni di visualizzazione dei grafici