Visualizzare i dati delle metriche in una dashboard personalizzata

Questo documento descrive come visualizzare i dati delle metriche in una dashboard personalizzata. I grafici a linee mostrano i valori dei dati delle metriche nel tempo. Tuttavia, puoi anche utilizzare tabelle o altre visualizzazioni per mostrare i valori più recenti per i dati delle metriche. Puoi visualizzare i dati delle metriche con un valore numerico o di distribuzione, incluse le metriche definite dall'utente e le metriche basate sui log.

Se vuoi visualizzare altri tipi di dati, consulta i seguenti documenti:

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

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

Visualizzazioni per i dati delle metriche

Per visualizzare i dati nel tempo, utilizza i grafici. Sono disponibili quattro stili:

  • A linee
  • Area in pila
  • Barre in pila
  • Mappa termica

I grafici a linee sono la visualizzazione predefinita e sono adatti alla maggior parte dei dati delle metriche. I grafici a barre in pila sono ideali per rappresentare graficamente i dati delle metriche con campioni poco frequenti, ad esempio le metriche delle quote. Per i dati delle metriche il cui tipo di valore è una distribuzione, utilizza la mappa termica.

Per visualizzare solo i valori più recenti, utilizza uno dei seguenti stili:

  • Le tabelle mostrano le etichette, consentono di limitare il numero di righe e di codificare i colori delle celle in base al valore.
  • Indicatori e prospetti mostrano un'indicazione verde, ambra o rossa in base al confronto tra il valore e un insieme di soglie.
  • Gli istogrammi mostrano la frequenza relativa dei valori più recenti di più serie temporali.
  • I grafici a torta mostrano il valore più recente di ciascuna serie temporale come frazione della somma di tutti i valori.
  • Le mappe ad albero mostrano i valori più recenti dei dati raggruppati come una serie di rettangoli nidificati, in cui il colore di un rettangolo è proporzionale al suo valore.

Dopo aver configurato un widget, puoi modificarne la visualizzazione.

Prima di iniziare

Completa quanto segue nel progetto Google Cloud in cui vuoi creare e gestire i dashboard:

Visualizzare i dati delle metriche in una dashboard

Per visualizzare i dati delle metriche nella dashboard:

  1. Aprire una dashboard e aggiungere un widget
  2. Seleziona un tipo di metrica da visualizzare
  3. Salva le modifiche

Potresti voler modificare l'aspetto del grafico, visualizzare un rapporto tra le metriche o apportare altre modifiche. Per scoprire le opzioni disponibili, consulta la sezione Opzioni di configurazione avanzata di questo documento.

Aprire una dashboard e aggiungere un widget

Per visualizzare i dati delle metriche in una dashboard personalizzata:

  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. 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. Esegui una delle seguenti operazioni:

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

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

  5. Nella finestra di dialogo Aggiungi widget, seleziona un widget.

    • Per aggiungere un grafico a linee, seleziona  Metrica.
    • Per aggiungere una visualizzazione diversa, selezionala dalla raccolta di widget.

    Puoi modificare lo stile di visualizzazione utilizzando le opzioni del widget.

Seleziona un tipo di metrica da visualizzare

In questo passaggio, configuri una query. La query definisce i dati visualizzati dal widget.

  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 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 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 e poi completa la finestra di dialogo. Ad esempio, puoi visualizzare i dati per una zona applicando un filtro. Puoi aggiungere più filtri. Per ulteriori informazioni, vedi Filtrare i dati nei 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.

Salva le modifiche

Dopo aver selezionato un tipo di metrica da visualizzare, puoi salvare le modifiche, modificare le impostazioni predefinite o configurare i campi specifici del widget. Le seguenti sezioni di questo documento potrebbero essere utili quando configuri i campi specifici del widget:

Quando il grafico ti soddisfa, salva le modifiche e poi aggiorna la dashboard.

  1. Per applicare le modifiche alla dashboard, fai clic su Applica nella barra degli strumenti. Per ignorare le modifiche, fai clic su Annulla.
  2. Per salvare la dashboard modificata, fai clic su Salva nella barra degli strumenti.

Dopo aver salvato il widget, puoi modificarlo e modificarne le impostazioni. Ad esempio, puoi modificare lo stile di visualizzazione.

Opzioni di configurazione avanzate

Questa sezione descrive le opzioni disponibili per personalizzare il widget:

Modificare la visualizzazione

Per visualizzare i valori più recenti dei dati delle metriche, anziché visualizzarli nel tempo, utilizza una delle seguenti visualizzazioni:

Per modificare la visualizzazione del widget, nel riquadro Visualizzazione, seleziona Tipo di widget ed effettua una selezione dal 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, supponiamo che un grafico a linee visualizzi diverse serie temporali. Il menu Tipo di widget mostra che la maggior parte dei tipi di visualizzazione sono elencati come Compatibili. Ad esempio, puoi sempre passare da un grafico a linee a una tabella. Tuttavia, i seguenti tipi di widget non sono disponibili:

  • Il widget Mappa termica è disattivato perché questi widget possono visualizzare solo dati con valori di distribuzione.
  • Il pannello dei log non è elencato perché non può visualizzare i dati delle metriche.

Impostare l'aspetto

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

Imposta visibilità

Per impostazione predefinita, la dashboard mostra il widget. Se definisci variabili, puoi rendere visibile il widget solo quando la variabile ha valori specifici. Per saperne di più, vedi Impostare la visibilità di un widget.

Visualizzare più tipi di metriche

Puoi configurare grafici e tabelle in modo che mostrino più tipi di metriche. Per le tabelle, Cloud Monitoring tenta di visualizzare i valori per entrambi i tipi di metriche nella stessa riga, se possibile. Per saperne di più, vedi Come le tabelle uniscono i dati di 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 vengono tracciati due tipi di metriche:

Esempio di Metrics Explorer con due tipi di metriche.

PromQL

Non supportati.

Filtro di monitoraggio

Non supportati.

Visualizzare un rapporto tra i tipi di metriche

Potresti voler rappresentare graficamente un rapporto tra metriche quando Google Cloud non fornisce i dati delle metriche nel formato che preferisci.

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

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

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

  5. (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.

Filtro di monitoraggio

Non supportati.

Configurare una tabella

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

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 l'ultimo valore di un tipo di metrica e la colonna dei valori è stata configurata per codificare a colori la cella in base al confronto del valore con una soglia:

Esempio di tabella che mostra due tipi di metriche.

Esistono due widget che mostrano i dati in formato tabellare: il widget Elenco principale e il widget Tabella. La differenza principale tra questi due widget è che il widget Elenco principale ordina le 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 assegnare un codice colore alla cella in base al confronto del valore con una soglia.

Per aggiungere una tabella alla dashboard:

  1. Apri una dashboard e aggiungi un widget e aggiungi un widget Tabella o Elenco principale.

  2. Seleziona un tipo di metrica da visualizzare.

    Ogni riga della tabella corrisponde a una serie temporale. Una colonna della tabella mostra un valore numerico che è l'ultimo valore o un valore aggregato. Le altre colonne mostrano le etichette nella serie temporale.

  3. (Facoltativo) Seleziona un altro tipo di metrica.

    Quando una tabella mostra più tipi di metriche, i dati per entrambi i tipi di metriche vengono visualizzati nella stessa riga, se possibile. Per saperne di più, consulta Informazioni sulle tabelle che mostrano più tipi di metriche.

  4. Configura la tabella:

Puoi anche utilizzare l'API Cloud Monitoring per aggiungere un widget tabella a una dashboard. Per saperne di più, consulta Dashboard con un widget TimeSeriesTable.

Visualizzare l'ultimo valore 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 l'ultimo valore e il valore aggregato, utilizza il campo Opzione valore.

Se visualizzi 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 deriva dall'etichetta.

Per configurare le colonne mostrate dalla tabella, espandi il menu Colonne visibili ed effettua le 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 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 i pulsanti Allinea a sinistra, Allinea al centro e Allinea 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 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.

Visualizza valore di riferimento

Le tabelle possono visualizzare solo un valore oppure un valore relativo all'intervallo di valori. Quando è selezionata l'opzione Intervallo, il valore viene mostrato 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.

Ordina e filtra

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

Sono disponibili 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. Quando non specifichi l'operatore OR tra due filtri, viene unito un AND logico.

    Per aggiungere un filtro, fai clic su Enter property name or value, seleziona una proprietà dal menu e poi inserisci un valore o seleziona un'opzione 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.

Informazioni sulle tabelle che mostrano più tipi di metriche

Se una tabella esegue query per più tipi di metriche, la Google Cloud console 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 Monitoring 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 diversi tipi di metriche. 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 ha sempre esito positivo. 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 segnalata dalla query A e dalla query 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, l'ultimo valore della query B viene visualizzato come cella vuota.

  • Se le etichette per i risultati di una query sono un sottoinsieme delle etichette per i 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 questa situazione, 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 che corrisponde alle due etichette comuni, location e cluster_name, e la terza etichetta viene ignorata.

  • Se i risultati delle due query non condividono etichette o se condividono alcune etichette, ma non abbastanza per formare un identificatore di riga univoco, i risultati non possono essere uniti. La tabella elenca una riga per ogni serie temporale restituita 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 essere in grado di risolvere un errore di unione.

Come risolvere un errore di unione

Quando tracci più metriche, 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 aver raggruppato 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 aver raggruppato i dati in base all'etichetta cluster_name.

La tabella non può unire i risultati perché quelli 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 del cluster, il valore della query A e il valore della query B.

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

Configurare i misuratori e i prospetti

Per visualizzare la misurazione più recente rispetto a un insieme di soglie con codice colore, aggiungi un indicatore o un prospetto. Gli indicatori 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. 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. Allo stesso modo, quando il valore si trova in un intervallo di pericolo, il widget diventa rosso.

Questi widget possono mostrare più indicatori o prospetti. Ad esempio, l'immagine seguente mostra un widget a indicatore che visualizza tre indicatori:

Esempio di misuratore.

Il numero di indicatori mostrati dal widget indicatore dipende dalle impostazioni di aggregazione. Nell'esempio, le impostazioni di aggregazione generano tre serie temporali, quindi vengono visualizzati tre indicatori. Definisci le soglie a livello di widget, in modo che vengano applicate a ogni serie temporale. In questo esempio, un indicatore è rosso, uno è ambra e il terzo è verde.

Il resto delle informazioni in questa sezione riguarda la consoleGoogle Cloud . Per informazioni sull'utilizzo dell'API Cloud Monitoring, consulta Dashboard con una query Scorecard di base.

Per aggiungere un indicatore o un prospetto a una dashboard:

  1. Apri una dashboard e aggiungi un widget e aggiungi un widget Indicatore o Prospetto.

  2. Seleziona un tipo di metrica da visualizzare.

  3. Nel riquadro Display, configura il widget:

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

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

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

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

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

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

Configurare istogrammi, grafici a torta e mappe ad albero

Questa sezione fornisce informazioni su come configurare i widget che mostrano i valori delle metriche più recenti in formato grafico.

Configurare un istogramma

Un istogramma fornisce informazioni sulla frequenza relativa del valore più recente di più serie temporali. ovvero l'asse x è indicizzato per bin, ognuno dei quali corrisponde a un intervallo di valori. L'asse Y specifica un conteggio, ovvero il numero di campioni i cui valori rientrano nell'intervallo del bin.

Lo screenshot seguente mostra un widget istogramma:

Esempio di widget **Istogramma**.

L'esempio mostra il valore più recente per circa 50 serie temporali. Il valore più recente per la maggior parte delle serie temporali è 0,145 o inferiore.

Per aggiungere un istogramma a una dashboard:

  1. Apri una dashboard e aggiungi un widget e un widget Istogramma.

  2. Seleziona un tipo di metrica da visualizzare.

    Viene mostrato un istogramma con una configurazione dei bin predefinita.

  3. (Facoltativo) Aggiorna la configurazione del bin:

    • Per configurare il numero o le dimensioni dei bin, seleziona Bin dell'istogramma e fai una selezione.

      • Per specificare il numero di bin, seleziona Conteggio e poi inserisci un valore. Ti consigliamo di inserire un valore di almeno 5 e non superiore a 50. Tuttavia, questa funzionalità supporta fino a 1000 bin.

      • Per specificare le dimensioni di ogni bin, seleziona Dimensioni e poi inserisci un valore.

    • Per specificare i valori minimo e massimo dell'asse x, seleziona Intervallo asse x e completa la finestra di dialogo.

    • Per specificare la scalatura lineare o logaritmica sull'asse Y, seleziona Scala dell'asse Y e completa la finestra di dialogo.

  4. Seleziona Applica e poi Salva.

Puoi anche utilizzare l'API Cloud Monitoring per aggiungere un widget istogramma a una dashboard. Per saperne di più, consulta Dashboard con un widget Histogram.

Configurare 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ò mostrare qualsiasi tipo di metrica con un valore numerico e può mostrare i percentili per le metriche con valori di distribuzione. Ogni serie temporale contribuisce con una fetta al grafico a torta.

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

Esempio di widget **Grafico a torta**.

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

  1. Apri una dashboard e aggiungi un widget e aggiungi un widget Grafico a torta.

    Per visualizzare il valore totale, imposta il campo Tipo di grafico su A ciambella.

  2. Seleziona un tipo di metrica da visualizzare.

Per informazioni sull'utilizzo dell'API per configurare un grafico a torta, consulta Dashboard con un widget PieChart.

Configurare una mappa ad albero

Per visualizzare i dati più recenti come una serie nidificata di rettangoli, in cui ogni rettangolo corrisponde a una raccolta univoca di valori delle etichette, aggiungi una mappa ad albero. Supponi di aver aggregato i dati che stai rappresentando nel grafico in base all'etichetta zone. Se imposti il tipo di widget su mappa ad albero, ogni rettangolo della mappa ad albero corrisponde a una zona. La saturazione del colore di un rettangolo è proporzionale al valore che rappresenta.

Lo screenshot seguente mostra un widget treemap in cui le serie temporali sono aggregate per zone e storage_type:

Esempio di widget **Mappa ad albero**.

Nello screenshot, la descrizione comando viene mostrata per un rettangolo.

Per configurare una mappa ad albero:

  1. Apri una dashboard e aggiungi un widget e aggiungi un widget Treemap.
  2. Seleziona un tipo di metrica da visualizzare.
  3. Se l'elemento Aggregazione mostra Nessuna aggregazione, utilizza il menu per selezionare una funzione di aggregazione. Ad esempio, seleziona Media o Max.
  4. Nel secondo campo dell'elemento Aggregazione, seleziona almeno un'etichetta.
  5. Per applicare le modifiche alla dashboard, fai clic su Applica nella barra degli strumenti. Per ignorare le modifiche, fai clic su Annulla.
  6. Per salvare la dashboard modificata, fai clic su Salva nella barra degli strumenti.

Per informazioni sull'utilizzo dell'API per configurare una mappa ad albero, consulta Dashboard con un widget Treemap.

Passaggi successivi

Puoi anche aggiungere i seguenti widget alle dashboard personalizzate:

Per informazioni sull'esplorazione dei dati dei grafici e sul filtraggio delle dashboard, consulta i seguenti documenti: