Crea e gestisci dashboard personalizzate

Questo documento descrive come creare e gestire dashboard personalizzate utilizzando la console Google Cloud. Le dashboard personalizzate ti consentono di visualizzare le informazioni di tuo interesse, organizzate in modo utile per te. Ad esempio, potresti creare una dashboard per visualizzare i log, le metriche sul rendimento e i criteri di avviso per le macchine virtuali (VM) nel tuo ambiente di produzione. Dopo aver creato una dashboard personalizzata, puoi anche copiarla, modificarla e condividerla. Per creare dashboard, puoi utilizzare la console Google Cloud, l'API Cloud Monitoring o Google Cloud CLI.

Questo documento descrive come creare e gestire le dashboard personalizzate utilizzando la console Google Cloud:

Questa funzionalità è supportata solo per i progetti Google Cloud.

Informazioni sulle dashboard personalizzate

Le dashboard personalizzate supportano diversi tipi di widget, quindi puoi scegliere il modo migliore per visualizzare i dati. Per impostazione predefinita, le dashboard mostrano tutti i dati metrici disponibili per il tuo progetto Google Cloud. Se configuri un ambito delle metriche, la dashboard può visualizzare i dati delle metriche per più progetti Google Cloud.

Una dashboard personalizzata può mostrare quanto segue:

Puoi migliorare il tempo di caricamento o l'usabilità di una dashboard raggruppando i widget. Ad esempio, potresti aggiungere sezioni a una dashboard. In alternativa, puoi aggiungere widget a un contenitore espanso o compresso.

Dopo aver creato una dashboard, puoi aggiungere filtri, variabili, eventi o etichette definite dall'utente:

  • I filtri a livello di dashboard si applicano a tutti i widget della dashboard. Questi filtri possono essere utili durante la risoluzione dei problemi. Ad esempio, puoi utilizzare questi filtri per visualizzare i dati solo per una zona specifica. Per ulteriori informazioni, consulta Aggiungere o rimuovere filtri.

  • Le variabili vengono applicate ai widget selezionati. Ad esempio, puoi utilizzare una variabile per modificare la query eseguita dal widget o per controllare la visibilità di un widget. Per scoprire di più, consulta Creare e gestire variabili e filtri bloccati.

  • Gli eventi, come l'arresto anomalo di un pod Google Kubernetes Engine, possono aiutarti a correlare i dati provenienti da origini diverse durante la risoluzione di un problema. Per ulteriori informazioni, consulta Mostrare gli eventi in una dashboard.

  • Le etichette possono aiutarti a trovare le dashboard in base al tipo di contenuti visualizzati. Ad esempio, puoi aggiungere l'etichetta prod alle dashboard che mostrano informazioni sui sistemi di produzione. Analogamente, potresti aggiungere l'etichetta staging per indicare che la dashboard mostra informazioni sui sistemi di staging.

Prima di iniziare

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

Aggiungere una dashboard personalizzata al progetto

Esistono diversi approcci che puoi utilizzare per aggiungere una dashboard personalizzata al tuo progetto Google Cloud:

  • Puoi creare una dashboard.
  • Puoi copiare o duplicare una dashboard.
  • Puoi copiare una dashboard da un progetto all'altro.
  • Puoi caricare o installare le dashboard da una posizione condivisa.
  • Puoi importare una dashboard da Grafana.

Ad esempio, supponiamo che tu abbia più progetti Google Cloud e che voglia che definiscano la stessa dashboard personalizzata. In questo caso, puoi creare la dashboard in un progetto e poi scaricare un modello per la dashboard nel tuo sistema locale. Successivamente, puoi installare il modello in altri progetti Google Cloud.

Creare una nuova dashboard

Per creare 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.
  3. Nella pagina Dashboard, fai clic su Crea dashboard personalizzata.

  4. Per aggiungere widget alla dashboard:

    1. Nella barra degli strumenti della dashboard, fai clic su  Aggiungi widget.

    2. Nel riquadro Aggiungi widget, seleziona un widget da aggiungere alla dashboard.

      Puoi selezionare un widget in base al tipo di dati da visualizzare o al modo in cui vuoi visualizzarli. In tutti i casi, viene aperto un riquadro di configurazione. Ad esempio, puoi selezionare il widget Metrica e impostare la visualizzazione su Area in pila. In alternativa, puoi selezionare il widget Area in pila e poi la metrica.

    3. Configura il widget.

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

      Dopo aver aggiunto il widget alla dashboard, puoi modificarne la configurazione.

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

  6. (Facoltativo) Aggiungi etichette definite dall'utente alla dashboard:

    1. Nell'elenco delle dashboard, individua la dashboard e poi fai clic su Aggiungi etichette alla dashboard.
    2. Esegui una delle seguenti operazioni:

      • Per creare un'etichetta e aggiungerla alla dashboard, nella sezione Crea una nuova etichetta, inserisci il nome dell'etichetta nella casella di testo e poi fai clic su Crea e applica.

      • Per configurare le etichette da aggiungere alla dashboard, fai clic su Seleziona le etichette da applicare, seleziona le etichette e poi fai clic su Ok.
    3. Per salvare le modifiche, fai clic su Conferma.

Copiare una dashboard

Quando vuoi sperimentare metriche diverse o opzioni di aggregazione diverse, puoi copiare una dashboard e utilizzarla per scopi sperimentali.

Per copiare 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. Nella barra degli strumenti della console Google Cloud, seleziona il tuo progetto Google Cloud.
  3. Nella pagina Panoramica delle dashboard, identifica la dashboard da copiare e poi fai clic su Copia dashboard.
  4. (Facoltativo) Aggiorna il nome della dashboard.
  5. Fai clic su Copia nella finestra di dialogo di conferma.

Copiare una dashboard in un altro progetto

Per copiare una dashboard da un progetto a un altro, il tuo ruolo IAM per i progetti Google Cloud di destinazione deve includere l'autorizzazione Editor monitoraggio. Per ulteriori informazioni sui ruoli, consulta Controllare l'accesso con Identity and Access Management.

Per copiare una dashboard in un altro progetto Google Cloud, segui questi passaggi:

  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.

  3. Copia il JSON della dashboard negli appunti:

    1. Nella barra degli strumenti della dashboard, fai clic su Impostazioni, poi su JSON e infine su Editor JSON.
    2. Nella barra degli strumenti dell'editor, fai clic su Copia.

  4. Incolla il JSON negli appunti in una nuova dashboard creata in un progetto diverso:

    1. Utilizza il selettore di progetti della console Google Cloud per selezionare il progetto in cui vuoi creare la copia.
    2. Fai clic su Crea dashboard.
    3. Nella barra degli strumenti della dashboard, fai clic su Impostazioni, poi su JSON e infine su Editor JSON.
    4. Incolla i contenuti degli appunti nell'editor.
    5. Fai clic su Applica modifiche.
    6. Per salvare la dashboard modificata, fai clic su Salva nella barra degli strumenti.

Installare un modello di dashboard

Puoi caricare nel tuo progetto Google Cloud un modello per una dashboard se è archiviato in una posizione condivisa. Cloud Monitoring, ad esempio, fornisce un insieme selezionato di modelli di dashboard su GitHub che sono specifici per vari Google Cloud servizi. I grafici in queste dashboard presentano una selezione di metriche pertinenti a un servizio specifico.

Dopo aver caricato un modello di dashboard, puoi personalizzarlo. Ad esempio, puoi aggiungere grafici, etichette o configurare gli eventi da visualizzare.

Per saperne di più, consulta Installare un modello di dashboard.

Importare una dashboard da Grafana

Cloud Monitoring fornisce un importatore che puoi utilizzare per importare i file delle dashboard in formato JSON di Grafana in Cloud Monitoring. Per ulteriori informazioni, consulta Importare le dashboard di Grafana in Cloud Monitoring.

Trovare e visualizzare una dashboard

Le dashboard personalizzate vengono visualizzate nello stesso elenco delle dashboard specifiche per servizio che Cloud Monitoring crea quando aggiungi risorse al tuo progetto Google Cloud.

Per visualizzare 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. Nella barra degli strumenti della console Google Cloud, seleziona il tuo progetto Google Cloud.

    La pagina Dashboard elenca tutte le dashboard nel progetto Google Cloud.

  3. Per trovare una dashboard, puoi:

    • Utilizza le opzioni Visualizzate di recente e Preferiti per limitare le dashboard elencate.

    • Utilizza il menu Integrazioni per elencare solo le dashboard associate a un'integrazione specifica.

    • Utilizza il menu Tipo per elencare solo le dashboard di un tipo specifico. Ad esempio, per elencare le dashboard create automaticamente da Google Cloud in base al tuo utilizzo dei serviziGoogle Cloud , seleziona Servizi Google nel menu Tipo. Per perfezionare ulteriormente l'elenco, utilizza la barra Filtra.

    • Utilizza il menu Etichette per elencare solo le dashboard con un'etichetta specifica definita dall'utente. Ad esempio, supponiamo di aver creato un'etichetta Staging e di averla applicata alle dashboard che mostrano informazioni sulle risorse di staging. Per elencare queste dashboard, seleziona l'etichetta Preparazione. Per perfezionare ulteriormente l'elenco, utilizza la barra Filtra.

    • Aggiungi filtri alla barra Filtra:

      • Per elencare le dashboard il cui nome o descrizione contiene un testo specifico, inserisci il testo nella barra Filtra.

      • Per elencare le dashboard dopo aver applicato un filtro in base al valore del campo della dashboard:

        1. Seleziona Cerca nelle dashboard e poi un campo in base al quale filtrare. Puoi filtrare in base ai seguenti campi della dashboard: nome, descrizione, tipo ed etichetta definita dall'utente.

        2. Inserisci un valore per il filtro o effettua una selezione dal menu.

      • Per elencare le dashboard che non contengono grafici, selezionare Cerca nelle dashboard, Etichette e (Vuota).

      Quando aggiungi più filtri e non includi l'operatore OR tra due filtri, viene utilizzato un operatore AND per unire i filtri.

  4. Dopo aver individuato la dashboard, selezionala.

Modificare una dashboard

Dopo aver creato una dashboard, potresti stabilire che deve essere modificata per essere più utile. Ad esempio, potresti voler aggiungere o rimuovere i widget, modificare il layout o la modalità di visualizzazione dei dati da parte di un widget. Inoltre, ti consigliamo di aggiungere etichette a una dashboard per trovarla più facilmente o per indicare il tipo di contenuti.

Aggiungere o rimuovere le etichette

Le etichette possono aiutarti a trovare le dashboard in base al tipo di contenuti visualizzati. Ad esempio, puoi aggiungere l'etichetta prod alle dashboard che mostrano informazioni sui sistemi di produzione. Analogamente, potresti aggiungere l'etichetta staging per indicare che la dashboard mostra informazioni sui sistemi di staging. Successivamente, quando elenchi le dashboard, puoi selezionare un'etichetta per filtrare l'elenco in modo da visualizzare solo le dashboard che contengono l'etichetta selezionata.

Per aggiungere o rimuovere etichette definite dall'utente 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. Nella barra degli strumenti della console Google Cloud, seleziona il tuo progetto Google Cloud.
  3. Nell'elenco delle dashboard, individua la dashboard e poi fai clic su Aggiungi etichette alla dashboard.
  4. Esegui una delle seguenti operazioni:

    • Per creare un'etichetta e aggiungerla alla dashboard, nella sezione Crea una nuova etichetta, inserisci il nome dell'etichetta nella casella di testo e poi fai clic su Crea e applica.

    • Per configurare le etichette da aggiungere alla dashboard, fai clic su Seleziona le etichette da applicare, seleziona le etichette e poi fai clic su Ok.
  5. Per salvare le modifiche, fai clic su Conferma.

Per elencare, modificare ed eliminare le etichette, fai clic su Gestisci etichette.

Aggiungere o rimuovere filtri e variabili

Dopo aver creato una dashboard, puoi aggiungere filtri e variabili. I filtri vengono applicati a tutti i widget di una dashboard. Le variabili si applicano ad alcuni widget della dashboard. I filtri e le variabili possono essere utili per la risoluzione dei problemi. Ad esempio, puoi utilizzare un filtro in modo che la dashboard mostri i dati solo per una zona specifica.

  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.

  3. Individua e seleziona la dashboard.

    • Per aggiungere un filtro a livello di dashboard che si applichi solo alla sessione corrente, utilizza la barra dei filtri della dashboard. Per ulteriori informazioni, vedi Filtri temporanei.

    • Per aggiungere un filtro permanente per l'intera dashboard, nella barra degli strumenti della dashboard vai a Impostazioni e seleziona Gestisci filtri. Per scoprire di più, consulta Creare e gestire variabili e filtri bloccati.

Modificare i widget o cambiare il layout

Per modificare i widget di una dashboard o il relativo layout:

  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.
  3. Individua e seleziona la dashboard.

  4. (Facoltativo) Per aggiungere un widget alla dashboard, fai clic su  Aggiungi widget nella barra degli strumenti della dashboard, poi seleziona e configura il widget. Per applicare le modifiche alla dashboard, fai clic su Applica nella barra degli strumenti. Per ignorare le modifiche, fai clic su Annulla.

    Per ulteriori informazioni, consulta le seguenti pagine:

  5. (Facoltativo) Per modificare un widget, esegui una delle seguenti operazioni:

    • Posiziona il cursore sul widget per attivare la barra degli strumenti, fai clic su  Modifica widget e poi aggiorna il widget. Per applicare le modifiche alla dashboard, fai clic su Applica nella barra degli strumenti. Per ignorare le modifiche, fai clic su Annulla.

      Puoi modificare la maggior parte delle impostazioni del widget, incluso il tipo di widget. Ad esempio, per modificare un grafico a linee in un grafico ad area in pila, fai clic su Grafico a linee e seleziona Grafico ad area in pila dal menu. Per ulteriori informazioni, consulta Modificare il tipo di un widget.

    • Fai clic su Impostazioni, poi su JSON e infine su Editor JSON. Se modifichi il file JSON, devi fare clic su Applica modifiche.

      Puoi anche accedere al JSON di un widget modificandolo nella barra degli strumenti dei widget e facendo clic su  Visualizza codice.

  6. (Facoltativo) Per eliminare un widget, posiziona il cursore sul widget per attivare la barra degli strumenti e poi esegui una delle seguenti operazioni:

    • Se nella barra degli strumenti del widget è visualizzato un pulsante Elimina, fai clic sul pulsante.
    • In caso contrario, fai clic su Altre opzioni e poi su Elimina widget.

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

  7. (Facoltativo) Per riposizionare un widget, utilizza il cursore per trascinarlo dall'intestazione in una nuova posizione. Per applicare le modifiche alla dashboard, fai clic su Applica nella barra degli strumenti. Per ignorare le modifiche, fai clic su Annulla.

    Non puoi riposizionare i widget quando una dashboard è in modalità griglia.

  8. (Facoltativo) Per ridimensionare un widget, utilizza il cursore per riposizionare il suo angolo a destra. Per applicare le modifiche alla dashboard, fai clic su Applica nella barra degli strumenti. Per ignorare le modifiche, fai clic su Annulla.

    Non puoi ridimensionare i widget quando una dashboard è in modalità griglia.

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

Eliminare una dashboard

L'eliminazione di una dashboard contenente un grafico per un criterio di avviso non comporta l'eliminazione degli avvisi i cui dati sono stati visualizzati su questi grafici. Pertanto, potresti ricevere notifiche da queste norme dopo l'eliminazione della dashboard. Per informazioni su come gestire le policy, che puoi eseguire dalla pagina Avvisi nella console Google Cloud, consulta Gestire le policy di avviso.

Per eliminare 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.
  3. Per avviare l'azione di eliminazione, individua la dashboard da eliminare e fai clic su Elimina.
  4. Nella finestra di dialogo di conferma, fai clic su Elimina.
  5. Per salvare la dashboard modificata, fai clic su Salva nella barra degli strumenti.

Salvare una dashboard come modello in un sistema locale

Potresti aver creato una dashboard personalizzata che altri membri del tuo team o della tua organizzazione vogliono installare nei loro progetti. Quando vuoi condividere un modello di dashboard, salvalo nel tuo sistema locale, quindi spostalo o copialo in una posizione condivisa. Ad esempio, puoi copiare il modello su un Drive condiviso o in un repository di codice sorgente come GitHub. Chiunque abbia accesso alla posizione archiviata può installare la dashboard nei propri progetti Google Cloud.

Per salvare un modello di una dashboard personalizzata in un file in formato JSON memorizzato sul tuo sistema locale:

  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.
  3. Nella barra degli strumenti della dashboard, fai clic su Impostazioni, poi su JSON e infine su Editor JSON.

  4. Fai clic su Scarica file:

    Il file creato, che ha lo stesso nome della dashboard, contiene una rappresentazione JSON della dashboard. Questo file è solo un modello; non memorizza i dati delle serie temporali.

Condividere una dashboard

Quando stai esaminando un'anomalia nei dati, potresti volere che un'altra persona nel tuo team o nella tua organizzazione visualizzi gli stessi dati che stai visualizzando. Ad esempio, potresti notare un calo o un picco imprevisto in una metrica sul rendimento e voler consultare un collega. In questo scenario, vuoi che il tuo collega visualizzi la dashboard e i relativi dati.

Per informazioni su come condividere un link a una dashboard, consulta Condividere una dashboard personalizzata.

Configurare l'aggiornamento dei dati

Quando apri una dashboard, questa è configurata con l'aggiornamento automatico disattivato. Nella barra degli strumenti viene visualizzata un'opzione di attivazione/disattivazione, , che indica questo stato.

Per attivare l'aggiornamento automatico per la sessione corrente, vai alla barra degli strumenti e seleziona Attiva l'aggiornamento automatico.

Per disattivare l'aggiornamento automatico dopo averlo attivato, vai alla barra degli strumenti e seleziona Aggiornamento automatico disattivato.

Attivare il salvataggio automatico delle modifiche alla configurazione

Per impostazione predefinita, le dashboard non salvano le modifiche. Per attivare il salvataggio automatico, fai clic sul pulsante di attivazione/disattivazione Salvataggio automatico finché non si trova in posizione On. Quando viene visualizzato Cloud Done, le modifiche sono state salvate.

Passaggi successivi