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 i dati delle metriche in un intervallo di tempo aggiungendo un grafico a linee, un grafico ad area impilata, un grafico a barre o un grafico di mappa termica. Se ti interessano solo le misurazioni più recenti, aggiungi una tabella, un grafico a torta, un indicatore o un prospetto. Gli indicatori e i prospetti cambiano colore in base al confronto tra il valore più recente e le soglie di avviso e pericolo.

Le visualizzazioni che puoi aggiungere alle dashboard vengono chiamate collettivamente 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 i 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 il ruolo IAM Editor monitoraggio (roles/monitoring.editor) per il tuo 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 i ruoli personalizzati o altri ruoli predefiniti.

    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 poi configurare il widget oppure selezionare prima 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 da visualizzare l'utilizzo della CPU delle istanze VM e poi imposta il tipo di widget su 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

Questa sezione descrive come configurare grafici e tabelle utilizzando la console Google Cloud:

  • I grafici mostrano i dati nel tempo e sono disponibili quattro stili: A linee, Ad area in pila, A barre in pila e Mappa termica. Un singolo grafico può mostrare più tipi di metriche. Ad esempio, potresti configurare un grafico per visualizzare i byte del disco letti dalle tue istanze e 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 delle etichette. Quando le tabelle mostrano i dati di più tipi di metriche, ogni riga contiene un risultato di tutte le query, se è possibile un'unione di questo tipo.

    Esistono due stili di tabelle. Il widget Tabella visualizza 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 tra tabelle e grafici, configurare i nomi delle colonne della tabella e aggiungere soglie che cambiano il colore delle celle della tabella. Per ulteriori informazioni e un esempio, consulta Visualizzare 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 un'interfaccia basata su menu, Monitoring Query Language (MQL), PromQL o inserire un 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 i tipi di metriche con dati.

        Ad esempio, puoi fare 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 compila la finestra di dialogo. Ad esempio, puoi visualizzare i dati relativi a una zona applicando un filtro. Puoi aggiungere più filtri. Per ulteriori informazioni, consulta la sezione Filtrare i dati dei grafici.

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

    2. Combina e allinea le serie temporali:

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

      • Per combinare le serie temporali, nell'elemento Aggregation (Aggregazione), 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 è la media di tutte le serie temporali.

        2. Per combinare le serie temporali con gli stessi valori delle etichette, 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 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 su raggruppamento e allineamento, consulta Scegliere come visualizzare i dati dei grafici.

    3. (Facoltativo) Per visualizzare solo le serie temporali con i valori più alti o più bassi, utilizza l'elemento Ordina e limita.

    MQL

    1. Nella barra degli strumenti del riquadro Query Builder, seleziona il pulsante  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 delle query. 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

      Per ulteriori informazioni su MQL, consulta i seguenti documenti:

    PromQL

    1. Nella barra degli strumenti del riquadro Query Builder, seleziona il pulsante  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 che 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 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 Non aggregata e il secondo su Nessuna.

      • Per combinare le serie temporali, nell'elemento Aggregation (Aggregazione), 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 è la media di tutte le serie temporali.

        2. Per combinare le serie temporali con gli stessi valori delle etichette, 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 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 su raggruppamento e allineamento, consulta Scegliere come visualizzare i dati dei grafici.

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

    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 sono presenti due tipi di metriche nel grafico:

    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 in modo che mostri un rapporto tra 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 min.

    3. Aggiorna i campi di aggregazione.

      Ti consigliamo di impostare le etichette per il tipo di metrica del denominatore in modo che 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 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 delle query, seleziona Crea rapporto e poi completa la finestra di dialogo.

      Dopo aver creato il rapporto, vengono visualizzate tre query:

      • Rapporto A/B identifica la query sul rapporto.
      • A identifica la query per il numeratore.
      • B identifica la query per il denominatore.

      L'esempio seguente illustra un rapporto che confronta la somma dei byte scritti sul disco per zona con il numero totale di byte scritti sul disco:

      Esempio di un rapporto tra metriche.

    5. (Facoltativo) Per cambiare le metriche del numeratore e del denominatore, espandi il menu nell'elemento Rapporto e poi seleziona una voce.

    MQL

    1. Nella barra degli strumenti del riquadro Query Builder, seleziona il pulsante  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 delle query. MQL ti consente di calcolare il rapporto tra due metriche diverse, filtrare una singola metrica in base a un'etichetta e poi 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 del riquadro Query Builder, seleziona il pulsante  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 che 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 abilitati. 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:

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

    • I widget Prospetto e Indicatore sono contrassegnati come Compatibile con gli aggiustamenti perché possono mostrare una sola 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 il modo in cui un grafico o una tabella mostra i dati selezionati, utilizza le opzioni nel riquadro Visualizza:

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

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

Visualizzare 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 le righe di una tabella in modo da 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 come frazione del totale, aggiungi un grafico a torta. Come le tabelle, un grafico a torta può visualizzare qualsiasi tipo di metrica che ha un valore numerico e può visualizzare i percentile per le metriche con valori di distribuzione. Ogni serie temporale contribuisce con un'una fetta 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 Aggiungere grafici e tabelle di 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 A ciambella.

  • API Cloud Monitoring: consulta la 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 della tabella 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.

Esistono due widget che mostrano i dati in formato tabulare: il widget Elenco principale e il widget Tabella. La differenza principale tra questi due widget è che il widget Elenco principale ordina l'ordine delle righe e mostra il valore insieme a un indicatore visivo del valore rispetto all'intervallo di valori possibili. Poiché il widget Elenco principale fornisce una rappresentazione visiva del valore, non puoi applicare un codice a colori alla cella in base al confronto del valore con 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 mostrato un valore aggregato insieme a 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 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 visualizzata per impostazione predefinita. Per visualizzare la funzione di allineamento, espandi l'elemento Aggregazione e seleziona Configura allineatore nel primo elemento. 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 su etichette, il nome della colonna è dedotto 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 Sostituisci colonna, seleziona la colonna da modificare e poi svolgi una delle seguenti operazioni:

    • Per impostare il nome della colonna, utilizza il campo Nome visualizzato.
    • Per impostare l'allineamento dei dati nella colonna, utilizza i pulsanti Allineamento a sinistra, Allineamento al centro e 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 quando configuri la query utilizzando le selezioni del menu.

Mostra il valore di riferimento

Le tabelle possono mostrare un solo valore o un valore relativo all'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 la visualizzazione di un valore di riferimento, utilizza l'elemento Visualizzazione metrica.

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 e 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 applicato un operatore AND logico per unire i filtri.

    Per aggiungere un filtro, fai clic su Enter property name or value, seleziona una proprietà dal menu, quindi inserisci un valore o selezionalo dal menu dei valori. 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 soglie codificate a colori, 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 rientra in un intervallo di avviso, il widget diventa 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 restanti informazioni in questa sezione riguardano la 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 un'interfaccia basata su menu, Monitoring Query Language (MQL), PromQL o inserire un 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 i tipi di metriche con dati.

        Ad esempio, puoi fare 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 compila la finestra di dialogo. Ad esempio, puoi visualizzare i dati relativi a una zona applicando un filtro. Puoi aggiungere più filtri. Per ulteriori informazioni, consulta la sezione Filtrare i dati dei grafici.

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

    2. Combina le serie temporali utilizzando i campi Aggregation:

      • 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 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 delle query. Devi assicurarti che i campi di aggregazione siano 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 del riquadro Query Builder, seleziona il pulsante  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 che 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 Aggregation:

      • 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 Quadro di misura o Prospetto.

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

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

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

    4. Per i prospetti, fai clic su Visualizzazione grafico Spark, poi espandi il menu delle opzioni e 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.

In che modo le tabelle uniscono i dati per più tipi di metriche

Se una tabella esegue query per più tipi di metriche, la console Google Cloud esegue un'operazione di unione esaminando le etichette associate ai dati aggregati per entrambi i tipi di metriche. Quando le etichette comuni a entrambe le query consentono a Monitoraggio di determinare un identificatore di riga univoco, una singola riga della tabella mostra il valore più recente per ogni query. In caso contrario, è presente una riga per ogni serie temporale.

Ad esempio, supponiamo che una tabella esegua query su due tipi di metriche diversi. Chiamiamo 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 etichette per location e cluster_name, ma che i risultati della query A includano anche 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 sufficienti per formare un identificatore di riga univoco, i risultati non possono essere uniti. La tabella elenca una riga per ogni serie temporale restaurata 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 sul tipo di metrica Prometheus/kube_pod_container_status_ready/gauge. Le opzioni di aggregazione sono impostate per sommare le serie temporali dopo gruppare i 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 gruppare i 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 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: