Creare grafici con Metrics Explorer

Questo documento spiega come esplorare i dati delle metriche creando grafici temporanei conMetrics Explorere. Ad esempio, per visualizzare l'utilizzo della CPU di una macchina virtuale (VM), utilizza Metrics Explorer per creare un grafico che mostri i dati più recenti. Per creare grafici permanenti, crea un grafico con Metrics Explorere e salvalo in una dashboard personalizzata. In alternativa, crea una dashboard personalizzata e utilizza la sua interfaccia per aggiungere grafici. Le dashboard possono visualizzare dati di log, dati delle metriche, dati delle tracce, incidenti e altri contenuti. Per saperne di più, consulta Crea e gestisci dashboard personalizzate.

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

L'immagine seguente mostra un singolo tipo di metrica, l'utilizzo della CPU di un'istanza VM, visualizzato nella pagina Esplora metriche:

Grafico che mostra un singolo tipo di metrica, l'utilizzo della CPU, utilizzando Metrics Explorere.

L'immagine mostra più linee. Ogni riga mostra l'utilizzo medio della CPU per tutte le VM in una zona specifica.

Questa funzionalità è supportata solo per i progetti Google Cloud . Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione.

Prima di iniziare

Per ottenere le autorizzazioni necessarie per suddividere un grafico in base alle etichette, chiedi all'amministratore di concederti il ruolo IAM Visualizzatore Monitoring (roles/monitoring.viewer) sul progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Tracciare un singolo tipo di metrica

Per impostazione predefinita, quando crei un grafico, lo stile di visualizzazione è impostato su grafico a linee. Questo stile di grafico è appropriato per la maggior parte dei dati delle metriche. Puoi modificare lo stile del grafico utilizzando il menu Tipo di widget.

Per configurare un grafico in modo che visualizzi 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. Nella barra degli strumenti della console Google Cloud , seleziona il tuo progetto Google Cloud . Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione.

  3. Specifica i dati da visualizzare nel grafico. Puoi utilizzare un'interfaccia basata su menu, PromQL o 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 aiutano a trovare i tipi di metrica disponibili:

        • Per trovare un tipo di metrica specifico, utilizza la barra dei filtri. Ad esempio, se inserisci util, il menu mostra solo le voci che includono util. Le voci vengono mostrate quando superano un test "contiene" senza distinzione tra maiuscole e minuscole.
        • Per mostrare tutti i tipi di metriche, anche quelli senza dati, fai clic su Attive. 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 e poi completa la finestra di dialogo. Ad esempio, puoi visualizzare i dati di una zona applicando un filtro. Puoi aggiungere più filtri. Per ulteriori informazioni, consulta Filtra i dati dei grafici.

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

    2. Combina e allinea le serie temporali:

      • Per visualizzare ogni serie temporale, nell'elemento Aggregazione, imposta il primo menu su Nessuna aggregazione e il secondo su Nessuna.
      • Per combinare le serie temporali, nell'elemento Aggregazione, 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 è la media di tutte le serie temporali.

        2. Per combinare serie temporali con gli stessi valori 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 zona.

          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 poi inserisci un valore.

      Per ulteriori informazioni su raggruppamento e allineamento, consulta Scegli 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.

    PromQL

    1. Nella barra degli strumenti del riquadro del generatore di query, seleziona il pulsante il cui nome è  PromQL.

    2. Inserisci la query nell'editor di query. Ad esempio, per tracciare 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 saperne di più sull'utilizzo di PromQL, consulta PromQL in Cloud Monitoring.

    Filtro di monitoraggio

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

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

      Se hai selezionato un tipo di risorsa, una metrica o dei 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 Nessuna aggregazione e il secondo su Nessuna.
      • Per combinare le serie temporali, nell'elemento Aggregazione, 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 è la media di tutte le serie temporali.

        2. Per combinare serie temporali con gli stessi valori 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 zona.

          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 poi inserisci un valore.

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

Opzioni di configurazione avanzate

Questa sezione descrive le opzioni disponibili per personalizzare il widget:

Suddividere il grafico per etichette

Per impostazione predefinita, Metrics Explorer mostra un grafico che mostra i dati della metrica selezionata. Quando esamini un problema, la funzionalità di suddivisione può aiutarti a determinare se la causa sono tipi o posizioni di risorse specifici.

Per visualizzare il tipo di metrica selezionato suddiviso per etichette, seleziona Mostra suddivisione.

Per saperne di più su questa funzionalità, consulta Suddividere un grafico in base alle etichette.

Modificare la visualizzazione

Per impostazione predefinita, Metrics Explorer mostra i dati della metrica selezionata come grafico a linee. Questo stile di grafico è appropriato per la maggior parte dei tipi di metriche, ma non per tutti.

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 del tempo su almeno una settimana. Le metriche delle quote in genere riportano un campione al giorno.
    • Nel riquadro Visualizzazione, espandi il menu Tipo di widget e poi seleziona Grafico a barre in pila.
  • Per i tipi di metrica con un tipo di valore Distribuzione, assicurati che il menu Tipo di widget sia impostato su Grafico a mappa termica. Per saperne di più, consulta Informazioni sulle metriche con valori di distribuzione.
  • Per altri tipi di metriche, utilizza il menu Tipo di widget per visualizzare come vengono mostrati i dati. Il menu Tipo di widget elenca tutti i tipi di widget disponibili, ma alcuni potrebbero non essere abilitati. Considera un grafico che mostra più serie temporali e supponi che ogni valore misurato sia un numero double:
    • I widget 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 dati con valori di distribuzione.

Modificare l'aspetto del grafico

Per impostazione predefinita, Metrics Explorer mostra le serie temporali utilizzando la modalità colore. A ogni serie temporale viene assegnato un colore univoco e lo sfondo è bianco. Tuttavia, puoi modificare questo aspetto.

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

Grafico di più tipi di metriche

Questa funzionalità è disponibile solo quando utilizzi l'interfaccia basata su menu. Non è disponibile quando utilizzi i filtri PromQL o Monitoring.

In alcune situazioni, potresti voler visualizzare le serie temporali di diversi tipi di metriche 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 rappresentare graficamente più metriche, devi utilizzare l'interfaccia basata su menu. Le altre interfacce non supportano la creazione di grafici per 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. Nella barra degli strumenti della console Google Cloud , seleziona il tuo progetto Google Cloud . Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione.

  3. 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 Creazione di un grafico per un singolo tipo di metrica.

      La query per questa selezione ha l'identificatore A.

    2. Per ogni tipo di metrica aggiuntivo, segui questi 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 vengono tracciati 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 ogni tipo di metrica.

Grafico di un rapporto di metriche

Questa funzionalità è disponibile solo quando utilizzi l'interfaccia basata su menu o PromQL. Non è disponibile quando utilizzi i filtri di monitoraggio.

Il monitoraggio del numero di errori segnalati potrebbe essere utile, ma è più probabile che tu debba monitorare il tasso di errori. ovvero vuoi sapere quanti errori si sono verificati rispetto al numero totale di risposte. Per soddisfare questo requisito, puoi configurare un grafico in modo che visualizzi il rapporto tra due metriche. Per riferimenti a esempi e per informazioni sulle anomalie che possono verificarsi quando tracci i rapporti tra le metriche, consulta Rapporti tra le metriche.

Per visualizzare un rapporto tra le 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. Nella barra degli strumenti della console Google Cloud , seleziona il tuo progetto Google Cloud . Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione.

  3. 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 Creazione di 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 di tempo per combinare i punti all'interno di una serie temporale. 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 poi 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 per il denominatore.

      2. Aggiorna i campi di aggregazione.

        Ti consigliamo di fare in modo 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 è obbligatorio utilizzare lo stesso insieme 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 query, seleziona Intervallo minimo e assicurati che questo campo sia impostato sul valore utilizzato dal numeratore.

    3. Nella barra degli strumenti del riquadro della 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 del 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 di metriche.

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

    PromQL

    1. Nella barra degli strumenti del riquadro del generatore di query, seleziona il pulsante il cui nome è  PromQL.

    2. Inserisci la query nell'editor di query. Ad esempio, per tracciare un grafico del 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 saperne di più sull'utilizzo di PromQL, consulta PromQL in Cloud Monitoring.

Salvare un grafico

Dopo aver configurato un grafico, potresti volerlo salvare per riferimento futuro o salvare i dati visualizzati. Questa sezione descrive queste opzioni.

Salvare un link a un grafico

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.

Aggiungere il grafico a una dashboard personalizzata

Metrics Explorer ti consente di creare un grafico che puoi utilizzare per esplorare una metrica. Tuttavia, i grafici creati con questo strumento non sono persistenti. Quando esci dalla paginaMetrics Explorere, il grafico viene eliminato.

Per salvare un grafico che hai configurato con Metrics Explorer per riferimento futuro, aggiungilo 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 dashboard personalizzate, seleziona Salva con nome nella barra degli strumenti di Metrics Explorer, seleziona Grafico della dashboard e poi 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 widget. Il codice JSON per ogni widget include la query utilizzata dal sistema per recuperare i dati da visualizzare.

      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 Crea e gestisci le dashboard tramite l'API.

Salvare i dati visualizzati dal grafico

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

Crea un criterio di avviso dal grafico

Puoi creare una criterio di avviso per monitorare i dati che hai rappresentato graficamente. Per creare un criterio di avviso:

  1. Nella barra degli strumenti, fai clic su Salva come e seleziona Criterio di avviso.

    Si apre la finestra di dialogo dei criteri di avviso con i campi di selezione delle metriche compilati. La criterio di avviso è configurata per inviarti una notifica quando il valore dei dati monitorati diventa maggiore della soglia.

  2. Completa i seguenti passaggi e poi salva la policy:

    • Nella sezione Configura attivatore, aggiorna la soglia.
    • Aggiungi canali di notifica.
    • Inserisci un nome per la criterio di avviso.

Passaggi successivi