Aggiungere grafici e tabelle a una dashboard personalizzata

Questo documento descrive come aggiungere grafici, tabelle, indicatori e prospetti a una dashboard personalizzata utilizzando la console Google Cloud. Puoi visualizzare dati delle metriche in un intervallo di tempo aggiungendo un grafico a linee, un grafico ad area in pila, a barre o a mappa termica. Se stai interessato alle misurazioni più recenti, poi aggiungi una tabella, un grafico a torta un indicatore o un prospetto. Indicatori e prospetti cambiano colore in base a il valore più recente rispetto alle soglie di avviso e pericolo.

Le visualizzazioni che puoi aggiungere alle dashboard sono collettivamente chiamati widget. Per informazioni generali sui diversi tipi di widget, consulta la Panoramica delle dashboard.

Grafici, tabelle, indicatori e prospetti nelle dashboard personalizzate possono visualizzare qualsiasi tipo di metrica con un valore numerico o di distribuzione, incluse le metriche definite dall'utente e le metriche basate su log. I grafici non possono rappresentare graficamente dati di tipo stringa.

Questo documento descrive come aggiungere grafici, tabelle, indicatori e prospetti a una dashboard personalizzata che mostra i dati delle serie temporali. Per informazioni su come aggiungere altri tipi di widget alle dashboard, consulta i seguenti documenti:

Per informazioni sull'API Cloud Monitoring, consulta Gestire le dashboard tramite API.

Prima di iniziare

  • Per ottenere le autorizzazioni necessarie per creare e modificare dashboard personalizzate utilizzando la console Google Cloud, chiedi all'amministratore di concederti Ruolo IAM Editor Monitoring (roles/monitoring.editor) per il progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.

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

    Per ulteriori informazioni sui ruoli, consulta Controllare l'accesso con Identity and Access Management.

  • Puoi inserire fino a 40 widget in una dashboard.

  • Per aggiungere un widget a una dashboard, puoi: selezionare la visualizzazione e configurare il widget. In alternativa, puoi selezionare il tipo di dati e poi configurare la visualizzazione.

    Ad esempio, per aggiungere una tabella che mostri l'utilizzo della CPU delle tue istanze VM a una dashboard, puoi procedere nel seguente modo:

    • Seleziona il widget Table e configuralo in modo da visualizzare l'utilizzo della CPU delle tue istanze VM.
    • Seleziona il tipo di dati Metrica, configura il widget in modo che visualizzi l'utilizzo della CPU da parte delle istanze VM, quindi modifica il tipo di widget in Tabella.

    Le istruzioni in questa pagina presuppongono che tu selezioni prima il tipo di dati, e poi configuri la modalità di visualizzazione dei dati.

Aggiungere grafici e tabelle a una dashboard

In questa sezione viene descritto come configurare grafici e tabelle utilizzando Console Google Cloud:

  • I grafici mostrano i dati nel tempo e sono disponibili quattro stili: Linea, Area in pila, Barra in pila e Mappa termica. Un singolo grafico può mostrare più tipi di metriche. Ad esempio, configurare un grafico per visualizzare i byte del disco letti dalle istanze i byte del disco scritti nelle tue istanze.

    Dopo aver configurato un grafico, puoi modificarne il tipo di widget. Per informazioni sul motivo per cui potresti selezionare uno stile specifico, consulta Grafici che mostrano i dati nel tempo.

    Per informazioni sull'utilizzo dell'API Cloud Monitoring per configurare un grafico, consulta Dashboard con un widget XyChart.

  • Le tabelle contengono una riga per ogni combinazione di valori di etichette. Quando le tabelle mostrano dati provenienti più tipi di metriche, ogni riga contiene un risultato di tutte le query, quando una tale unione è possibile.

    Esistono due stili di tabelle. La tabella mostra un valore numerico come "25%". Il widget Elenco principale mostra sia il valore sia un indicatore visivo del valore rispetto all'intervallo di valori possibili.

    Puoi cambiare lo stile di tabelle e grafici, configurare i nomi delle colonne della tabella e aggiungere soglie che modificano il colore nelle celle della tabella. Per ulteriori informazioni e un esempio, vedi Visualizza i dati in formato tabulare in una dashboard.

    Per informazioni sull'utilizzo dell'API Cloud Monitoring per configurare una tabella, consulta Dashboard con un widget TimeSeriesTable.

Per aggiungere un grafico o una tabella a una dashboard:

  1. Nella console Google Cloud, vai alla pagina  Dashboard:

    Vai a Dashboard

    Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.

  2. Esegui una di queste operazioni:

    • Per creare una nuova dashboard, seleziona Crea dashboard.
    • Per aggiornare una dashboard esistente, individuala nell'elenco di tutte le dashboard e selezionane il nome.

  3. Nella barra degli strumenti, fai clic su  Aggiungi widget.

  4. Nella finestra di dialogo Aggiungi widget, seleziona  Metrica.

  5. 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 Attiva. 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, vedi 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 Aggregation: imposta il primo menu su Non aggregato e il secondo su Nessuno.

      • 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 una combinazione di valori di 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. (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 con l'opzione 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. 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 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 e poi seleziona Modalità di filtro diretto.

      Gli elementi Metrica e Filtro vengono eliminati e viene creato un elemento Filtri che consente di inserire del 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. Combina e allinea 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: 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 una combinazione di valori di 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 su raggruppamento e allineamento, consulta Scegliere come visualizzare i dati dei grafici.

  6. (Facoltativo) Configura il grafico o la tabella per visualizzare più tipi di metriche.

    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.

    MQL

    Non supportati.

    PromQL

    Non supportati.

    Filtro di monitoraggio

    Non supportati.

  7. (Facoltativo) Configura il grafico per visualizzare un rapporto di tipi di metriche.

    1. Configura il grafico in modo che mostri due tipi di metriche con lo stesso tipo di metrica. Ad esempio, entrambe sono metriche GAUGE.
    2. Assicurati che il valore del campo Intervallo minimo sia uguale per entrambi i tipi di metriche. Per accedere a questo campo, fai clic su Aggiungi elemento di query e seleziona Intervallo minimo.

    3. 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 entrambi i tipi di metriche.

    4. 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 dei byte scritti sul disco per zona con il numero totale di byte scritti sul disco:

      Esempio di un rapporto tra metriche.

    5. (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 del riquadro Query Builder, seleziona il pulsante  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 che consente di formattare la query.

    3. Inserisci la query nell'editor delle 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 calcola il rapporto tra le risposte con un valore di 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 delle query. Ad esempio, per tracciare il 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 ulteriori informazioni sull'utilizzo di PromQL, consulta PromQL in Cloud Monitoring.

    Filtro di monitoraggio

    Non supportati.

  8. (Facoltativo) Per modificare la visualizzazione, nel riquadro Visualizza, fai clic su Tipo di widget e poi effettua una selezione.

    Il menu Tipo di widget elenca tutti i tipi di widget che possono visualizzare lo stesso tipo di dati. Tuttavia, alcuni widget potrebbero non essere attivati. Ad esempio, prendi in considerazione un grafico in una dashboard configurato per mostrare un tipo di metrica. Il grafico a linee mostra più serie temporali e ogni valore misurato è un doppio:

    • Tabella, Grafico a torta, Grafico a linee, Grafico a barre in pila e I widget del grafico ad area in pila sono elencati come compatibili. Puoi selezionare uno di questi tipi.

    • I widget Prospetto e Indicatore sono elencati come Compatibile con le regolazioni perché questi widget possono visualizzare solo una singola serie temporale. Per attivare questi tipi di widget, modifica la configurazione del raggruppamento.

    • Il widget Mappa termica è disattivato perché questi widget possono mostrare solo i dati con valori di distribuzione.

    • Il riquadro dei log non è elencato perché non può visualizzare i dati delle serie temporali.

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

  10. Per applicare le modifiche alla dashboard, nella barra degli strumenti fai clic su Applica. Per ignorare le modifiche, fai clic su Annulla.

  11. Per salvare la dashboard modificata, fai clic su Salva nella barra degli strumenti.

Visualizza solo i dati più recenti

Il monitoraggio offre diversi modi per visualizzare solo le misurazioni più recenti, anziché la cronologia delle misurazioni:

  • Per visualizzare graficamente il valore più recente di ogni serie temporale, in cui ogni valore viene mostrato come frazione della somma di tutti i valori, aggiungi un grafico a torta. Puoi configurare questi grafici in modo che mostrino il valore totale.

  • Per visualizzare il valore più recente di ogni serie temporale in un formato tabulare, aggiungi una tabella. Puoi limitare il numero di righe di una tabella e configurare il righe di una tabella per mostrare un valore rispetto a un intervallo di valori.

  • Per ottenere un'indicazione verde, ambra o rossa del valore più recente rispetto a un insieme di soglie, aggiungi un indicatore o un prospetto alla dashboard.

Graficare i dati più recenti con un grafico a torta

Per visualizzare i dati più recenti sotto forma di frazione del totale, aggiungi un grafico a torta. Come per le tabelle, un grafico a torta può mostrare qualsiasi tipo di metrica che ha un valore numerico e possono visualizzare i percentili metriche con valore di distribuzione. Ogni serie temporale contribuisce con un segmento alla torta.

Lo screenshot seguente mostra una dashboard che mostra l'utilizzo della CPU delle istanze di macchine virtuali utilizzando due diverse configurazioni di un widget Grafico a torta:

Esempio di widget **PieChart**.

Per informazioni su come aggiungere grafici a torta a una dashboard, consulta i seguenti documenti:

  • Console Google Cloud: consulta la sezione intitolata Aggiungi grafici e tabelle in questo documento.

    • Dopo aver selezionato i dati da includere nel grafico, nel riquadro Visualizza imposta il campo Tipo di widget su Grafico a torta.
    • Per visualizzare il valore totale, imposta il campo Tipo di grafico su Donut.

  • API Cloud Monitoring: consulta Dashboard con un widget PieChart.

Visualizza i dati più recenti in formato tabulare

Per visualizzare i dati più recenti in formato tabulare, aggiungi una tabella. Le tabelle possono visualizzare dati numerici. Ad esempio, possono mostrare uno o più tipi di metriche o i percentile per le metriche con valori di distribuzione.

Quando una tabella mostra un tipo di metrica, ogni riga corrisponde a una serie temporale. Una colonna della tabella che mostra un valore numerico, che può essere il valore più recente o un valore aggregato. Le altre colonne visualizzano le etichette nella serie temporale. Quando una tabella visualizza più tipi di metriche, i dati di entrambi i tipi vengono mostrati nella stessa riga, se possibile. Per ulteriori informazioni, consulta In che modo le tabelle uniscono più tipi di metriche.

Sono disponibili due widget che visualizzano i dati in forma tabulare: il widget Elenco in alto. e Tabella. La differenza principale tra questi due widget è che il widget Elenco in alto ordina le righe e visualizza valore insieme a un indicatore visivo del valore confrontato con l'intervallo valori possibili. Poiché il widget Elenco di controllo offre una visuale del valore, non puoi applicare un colore alla cella in base il confronto tra il valore e una soglia.

Per informazioni sulla configurazione delle tabelle, consulta le seguenti sezioni:

Lo screenshot seguente mostra due tabelle. La prima tabella mostra due tipi di metriche: il numero di byte letti dalle istanze e il numero di byte scritti nelle istanze. Viene visualizzato un valore aggregato con una barra di riferimento. La seconda tabella mostra il valore più recente di un tipo di metrica e la colonna del valore è stata configurata per colorare la cella in base al confronto del valore con una soglia:

Esempio di tabella che mostra due tipi di metriche.

Mostra il valore più recente o il valore aggregato

Per impostazione predefinita, le tabelle mostrano il valore più recente. Tuttavia, una tabella può mostrare un valore calcolato nell'intervallo di tempo selezionato per la dashboard.

Per scegliere tra il valore più recente e quello aggregato, utilizza il campo Opzione valore.

Se mostri il valore aggregato, per ogni serie temporale i dati all'interno dell'intervallo di tempo selezionato dalla dashboard vengono combinati dalla funzione di allineamento. La funzione di allineamento è una delle opzioni di aggregazione e non viene mostrato per impostazione predefinita. Per visualizzare la funzione di allineamento, espandi la sezione Aggregazione e, nel primo elemento, seleziona Configura allineatore. Dopo aver effettuato questa selezione, l'elemento Aggregazione viene sostituito da un elemento Raggruppamento e da un menu denominato Funzione di allineamento.

Seleziona le colonne da visualizzare

Per impostazione predefinita, una colonna della tabella mostra un valore numerico. Tutte le altre colonne corrispondono a un'etichetta nella serie temporale. Per le colonne basate sulle etichette, il nome della colonna sia ricavato dall'etichetta.

Per configurare le colonne mostrate dalla tabella, espandi il menu Colonne visibili e fai le tue selezioni.

Configurare il formato della colonna

  • Per configurare una singola colonna, nell'elemento Colonne: espandi il menu Colonna di override, seleziona la colonna da modificare e quindi esegui una delle seguenti operazioni:

    • Per impostare il nome della colonna, utilizza il campo Nome visualizzato.
    • Per impostare l'allineamento dei dati nella colonna, utilizza il metodo Allinea a sinistra, Allinea al centro e Pulsanti di allineamento a destra.
    • Per assegnare un codice colore alla cella in base al confronto del valore numerico con una soglia, imposta le soglie di avviso e di pericolo.
    • Se scrivi query PromQL, utilizza il menu Unità per impostare le unità mostrate con i dati. Le unità vengono configurate automaticamente configurare la query utilizzando le selezioni di menu.

Mostra il valore di riferimento

Le tabelle possono mostrare solo un valore oppure un valore relativo a l'intervallo di valori. Quando è selezionata l'opzione di intervallo, il valore viene visualizzato insieme a una barra di colore blu, la cui lunghezza è proporzionale al valore mostrato.

Per configurare se viene visualizzato un valore referenziale, utilizza la Vista metriche .

Ordinare e filtrare le tabelle

Puoi modificare l'ordine delle righe nella visualizzazione della tabella e filtrare i contenuti della tabella in modo da visualizzare solo righe specifiche. Queste impostazioni non sono permanenti. Quando esci dalla pagina della dashboard o quando la ricarichi, le opzioni di ordinamento e filtro che hai applicato vengono ignorate.

Hai a disposizione le seguenti opzioni di ordinamento e filtro:

  • Per ordinare la tabella in base a una colonna, fai clic sull'intestazione della colonna.

  • Per modificare le colonne della tabella, fai clic su Visualizza colonne, apporta le modifiche necessarie, poi fai clic su OK.

  • Per elencare solo righe specifiche, aggiungi uno o più filtri. Puoi aggiungere più filtri. Se non specifichi l'operatore OR tra due filtri, viene generato logical-AND unisce questi filtri.

    Per aggiungere un filtro, fai clic su Enter property name or value e seleziona un dal menu, poi inserisci un valore o selezionane uno dal valore o dal menu Fogli Google. Ad esempio, se filtri in base alla proprietà Name e inserisci il valore demo, la tabella elenca solo le righe in cui il campo Name include il valore demo.

Visualizzare i dati più recenti con indicazione di avviso o errore

Per visualizzare la misurazione più recente rispetto a un insieme di colori distinti soglie, aggiungi un indicatore o un prospetto. I misuratori mostrano solo la misurazione più recente, mentre i prospetti mostrano anche una cronologia delle misurazioni recenti. Anche il colore di sfondo di questi widget è codificato in base al colore. Quando il valore più recente rientra negli intervalli previsti, il colore del widget è bianco. Quando il valore è compreso in un intervallo di avviso, il widget diventa giallo ambra. Analogamente, quando il valore rientra in un intervallo di pericolo, il widget diventa rosso.

Entrambi i widget mostrano una singola serie temporale. Lo screenshot seguente mostra un esempio di indicatore quando la misurazione più recente è inferiore alle soglie di avviso e pericolo:

Esempio di indicatore.

Le informazioni rimanenti in questa sezione sono relative nella console Google Cloud. Per informazioni sull'utilizzo dell'API Cloud Monitoring, consulta Dashboard con un Scorecard di base.

Per aggiungere un indicatore o un prospetto a una dashboard:

  1. Nella console Google Cloud, vai alla pagina  Dashboard:

    Vai a Dashboard

    Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.

  2. Esegui una di queste operazioni:

    • Per creare una nuova dashboard, seleziona Crea dashboard.
    • Per aggiornare una dashboard esistente, individuala nell'elenco di tutte le dashboard e selezionane il nome.

  3. Nella barra degli strumenti, fai clic su  Aggiungi widget.

  4. Nella finestra di dialogo Aggiungi widget, seleziona  Metrica.

  5. 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 Attiva. 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, è 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. Combina le serie temporali utilizzando i campi Aggregazione:

      • Espandi il primo menu e seleziona la funzione che combina la serie temporale.
      • Espandi il secondo menu e assicurati che non siano selezionate etichette.

    MQL

    1. Nella barra degli strumenti del riquadro Query Builder, seleziona il pulsante  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 che consente di formattare la query.

    3. Inserisci la query nell'editor delle query. Devi assicurarti che l'aggregazione sono impostati per combinare tutte le serie temporali. Ad esempio, per creare un grafico dell'utilizzo della CPU delle istanze VM nel tuo progetto Google Cloud, utilizza la seguente query:

      fetch gce_instance
| metric 'compute.googleapis.com/instance/cpu/utilization'
| group_by 1m, [value_utilization_mean: mean(value.utilization)]
| every 1m
| group_by [], [value_utilization_mean_mean: mean(value_utilization_mean)]

      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 e poi seleziona Modalità di filtro diretto.

      Gli elementi Metrica e Filtro vengono eliminati e viene creato un elemento Filtri che consente di inserire del 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.

    3. Combina le serie temporali utilizzando i campi Aggregazione:

      • Espandi il primo menu e seleziona la funzione che combina la serie temporale.
      • Espandi il secondo menu e assicurati che non siano selezionate etichette.

  6. Nel riquadro Visualizza, configura il grafico a contatore o il prospetto:

    1. Fai clic su Tipo di widget e seleziona Indicatore o Prospetto.

    2. Per i widget indicatore, fai clic su Intervallo indicatore e imposta i valori minimo e massimo. Quando un indicatore mostra percentuale, imposta questi valori rispettivamente su 0 e 1.

    3. Fai clic su Soglia indicatore, quindi imposta le soglie di avviso e di pericolo. Campi di soglia che sono vuoti, non vengono utilizzati.

      Per l'indicatore visualizzato in precedenza vengono impostate due soglie. Valori superiori a 0,9 rientrano nell'intervallo di pericolo. Valori superiori a 0,7 ma non nel raggio di pericolo, sono nell'intervallo di avviso.

    4. Per i prospetti, fai clic su Visualizzazione grafico di Spark, ed espandi il menu delle opzioni e poi seleziona lo stile di visualizzazione.

  7. Per applicare le modifiche alla dashboard, fai clic su Applica nella barra degli strumenti. Per ignorare le modifiche, fai clic su Annulla.

  8. Per salvare la dashboard modificata, fai clic su Salva nella barra degli strumenti.

Come le tabelle uniscono i dati per più tipi di metriche

Se una tabella esegue query su più tipi di metriche, la console Google Cloud esegue un'operazione di unione esaminando le etichette allegate per entrambi i tipi di metriche. Quando le etichette comuni a entrambe le query permetta a Monitoring di determinare un identificatore di riga univoco, quindi a riga singola nella tabella mostra il valore più recente per ogni query. In caso contrario, c'è una riga per ogni serie temporale.

Ad esempio, supponiamo che una tabella esegua una query su due diversi tipi di metriche. Chiamiamoci queste query A e B. Di seguito viene descritto come vengono uniti i risultati della query:

  • Se il risultato di entrambe le query ha lo stesso insieme di etichette, l'unione è sempre riuscita. Ogni riga contiene il valore più recente per ogni query. Se una query non restituisce un valore per una determinata combinazione di etichette, la cella della tabella è vuota.

    Ad esempio, supponiamo che entrambe le query contengano un'etichetta zone. La tabella contiene una riga per ogni zona registrata dalle query A e B. Tuttavia, se la query A restituisce una serie temporale la cui zona è us-central1-a, ma la query B non restituisce una serie temporale con questo valore, il valore più recente per la query B viene visualizzato come una cella vuota.

  • Se le etichette dei risultati di una query sono un sottoinsieme delle etichette dei risultati dell'altra query, i risultati vengono uniti.

    Ad esempio, supponiamo che i risultati di entrambe le query includano le etichette per location e cluster_name, ma che anche i risultati per la query A includi un'etichetta per memory_type. In questo caso, ogni riga corrisponde a una serie temporale con valori univoci per le tre etichette.

    In qualsiasi riga, il valore mostrato per la query B è il valore della serie temporale corrispondente alle due etichette comuni location e cluster_name e la terza etichetta viene ignorata.

  • Se i risultati delle due query non condividono alcuna etichetta o se condividono alcune etichette, ma non abbastanza da formare un identificatore di riga univoco, non sarà possibile unire i risultati. La tabella elenca una riga per ogni serie temporale restituiti dalla query A o dalla query B e alcune celle della tabella sono vuote.

    Ad esempio, supponiamo che le etichette per la query A siano location e memory_type e che le etichette per la query B siano location e cluster_name. Anche se l'etichetta location è comune, non è sufficiente per creare un identificatore di riga univoco.

    Come descritto nella sezione successiva, potresti riuscire a risolvere un errore di unione.

Risolvere l'errore di unione

Quando rappresenti più metriche in un grafico, potrebbe verificarsi un errore di unione perché le metriche utilizzano nomi di etichette diversi per lo stesso campo. Un modo per risolvere questo errore è convertire una query in PromQL e poi utilizzare la funzione label_replace() per convertire i nomi delle etichette utilizzati da un tipo di metrica in modo che corrispondano a quelli dell'altro tipo di metrica.

Ad esempio, considera una tabella configurata con due query:

  • A: esegue query su Prometheus/kube_pod_container_status_ready/gauge tipo di metrica. Le opzioni di aggregazione sono impostate per sommare le serie temporali dopo il raggruppamento dei dati in base all'etichetta cluster.

  • B: esegue query sul tipo di metrica kubernetes.io/container/memory/request_bytes. Le opzioni di aggregazione sono impostate per sommare le serie temporali dopo il raggruppamento dei dati in base all'etichetta cluster_name.

La tabella non può unire i risultati perché i risultati della query A e della query B hanno etichette diverse.

Per risolvere l'errore, converti la query A in PromQL e sostituisci cluster con cluster_name. L'esempio seguente illustra la query modificata:

sum by (cluster_name)(
    label_replace(
        avg_over_time(kube_pod_container_status_ready[${__interval}]),
        "cluster_name", "$1", "cluster", "(.*)"
    )
)

Con le modifiche, entrambe le query producono lo stesso insieme di etichette. Pertanto, ogni riga della tabella elenca un nome di cluster, il valore per la query A e il valore per la query B.

Per informazioni sull'utilizzo di PromQL, consulta PromQL in Cloud Monitoring.

Passaggi successivi

Puoi anche aggiungere i seguenti widget alle tue dashboard personalizzate:

Per informazioni su come esplorare i dati dei grafici e filtrare le dashboard, consulta i seguenti documenti: