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 mostrare le informazioni che ti interessano, organizzate in modo che siano utili per te. Ad esempio, potresti creare una dashboard per visualizzare i log, le metriche delle prestazioni 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 tue dashboard personalizzate utilizzando la console Google Cloud:

Informazioni sulle dashboard personalizzate

Le dashboard personalizzate supportano diversi tipi di widget, il che ti consente di scegliere il modo migliore per visualizzare i tuoi dati. Per impostazione predefinita, le dashboard mostrano tutti i dati delle metriche disponibili per il 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ò visualizzare quanto segue:

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

Dopo aver creato una dashboard, puoi aggiungere filtri, eventi o etichette:

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

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

  • Le etichette possono aiutarti a individuare le dashboard in base al tipo di contenuti che mostrano. Ad esempio, potresti aggiungere l'etichetta prod alle dashboard che mostrano informazioni sui sistemi di produzione. Analogamente, potresti aggiungere l'etichetta staging per indicare che nella dashboard vengono visualizzate informazioni sui sistemi di gestione temporanea.

    Quando visualizzi le dashboard, puoi selezionare un'etichetta per filtrare l'elenco in base alle dashboard che contengono l'etichetta selezionata.

Prima di iniziare

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

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.

Aggiungi una dashboard personalizzata al progetto

Esistono diversi approcci 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 dashboard da una posizione condivisa.
  • Puoi importare una dashboard da Grafana.

Supponiamo, ad esempio, che tu abbia più progetti Google Cloud e che vogliano definire la stessa dashboard personalizzata. In questo caso, potresti creare la dashboard in un progetto e quindi copiare la definizione della dashboard in altri progetti. In alternativa, puoi scaricare la definizione della dashboard nel tuo sistema locale, quindi installare la definizione in altri progetti Google Cloud.

Crea 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 pagina Dashboard, fai clic su Crea dashboard personalizzata.
  3. Per aggiungere widget alla tua dashboard, procedi nel seguente modo:

    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 a come vuoi visualizzarli. In ogni caso, 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 che il widget è stato aggiunto alla dashboard, puoi modificare la configurazione del widget.

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

  5. (Facoltativo) Aggiungi etichette alla dashboard:

    1. Nell'elenco delle dashboard, individua la dashboard e fai clic su Seleziona.
    2. Nella barra degli strumenti, fai clic su Etichette ed esegui una delle seguenti operazioni:
      • Per creare un'etichetta e aggiungerla alla dashboard, nella casella di testo Crea una nuova etichetta, inserisci il nome dell'etichetta e fai clic su Crea e applica.

        L'etichetta viene creata e aggiunta alla dashboard.

      • Per configurare quali etichette vengono aggiunte alla dashboard, fai clic su Seleziona etichette da applicare, seleziona le etichette e 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 la sperimentazione.

Per copiare una dashboard, procedi nel seguente modo:

  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 pagina Panoramica dashboard, identifica la dashboard da copiare e fai clic su Copia dashboard.
  3. (Facoltativo) Aggiorna il nome della dashboard.
  4. Fai clic su Copia nella finestra di dialogo di conferma.

Copia una dashboard in un altro progetto

Per copiare una dashboard da un progetto all'altro, il tuo ruolo IAM per i progetti Google Cloud di destinazione deve includere l'autorizzazione di editor Monitoring. 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. Copia la definizione della dashboard negli appunti:

    1. Nella barra degli strumenti della dashboard, fai clic su Impostazioni, poi su JSON e infine su Editor JSON.
    2. Fai clic su Copia nella barra degli strumenti dell'editor.
  3. Incolla la definizione in una nuova dashboard creata in un altro progetto:

    1. Utilizza il selettore di progetti della console Google Cloud per selezionare il progetto in cui vuoi salvare la definizione della dashboard.
    2. Fai clic su Crea dashboard personalizzata.
    3. Nella barra degli strumenti della dashboard, fai clic su Impostazioni, poi su JSON e quindi 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.

Installa una dashboard

Puoi caricare nel tuo progetto Google Cloud una dashboard personalizzata la cui definizione è archiviata in una località condivisa. Cloud Monitoring, ad esempio, fornisce su GitHub un insieme selezionato di definizioni di dashboard specifiche per vari servizi Google Cloud. I grafici in queste dashboard presentano una selezione di metriche pertinenti a un servizio specifico.

Dopo aver caricato la definizione di una dashboard, puoi modificarla per mostrare i dati da visualizzare.

Per saperne di più, consulta Installare dashboard di esempio.

Importa una dashboard da Grafana

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

Trovare e visualizzare una dashboard

Le dashboard personalizzate vengono visualizzate nello stesso elenco delle dashboard specifiche per i servizi create da Cloud Monitoring quando aggiungi risorse al tuo progetto Google Cloud.

Per visualizzare una dashboard, procedi nel seguente modo:

  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.

    La pagina Le mie dashboard elenca tutte le dashboard nel tuo progetto Google Cloud.

  2. Per trovare una dashboard, procedi in uno dei seguenti modi:

    • Utilizza la barra Filtro per cercare in base al nome completo o parziale della dashboard oppure per filtrare i dati in base al tipo di dashboard.

    • Seleziona una categoria. Per perfezionare ulteriormente l'elenco, utilizza la barra Filtro.

    • Seleziona l'etichetta per elencare solo le dashboard che la contengono. Per perfezionare ulteriormente l'elenco, utilizza la barra Filtro.

    Per ridurre il numero di risultati elencati, utilizza la barra Filtro. Quando aggiungi più filtri e non includi l'operatore OR tra i due filtri, i filtri vengono uniti da un AND logico.

  3. Dopo aver individuato la dashboard, selezionala.

Modificare una dashboard

Dopo aver creato una dashboard, potresti determinare che necessita di modifiche per renderla più utile. Ad esempio, potresti voler aggiungere o rimuovere widget, modificare il layout o modificare la modalità di visualizzazione dei dati di un widget. Inoltre, potresti voler aggiungere etichette a una dashboard per facilitarne la ricerca o per indicare il tipo di contenuti nella dashboard.

Aggiungere o rimuovere etichette

Per aggiungere o rimuovere le etichette:

  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. Nell'elenco delle dashboard, individua la dashboard e fai clic su Seleziona.
  3. Nella barra degli strumenti, fai clic su Etichette ed esegui una delle seguenti operazioni:
    • Per creare un'etichetta e aggiungerla alla dashboard, nella casella di testo Crea una nuova etichetta, inserisci il nome dell'etichetta e fai clic su Crea e applica.

      L'etichetta viene creata e aggiunta alla dashboard.

    • Per configurare quali etichette vengono aggiunte alla dashboard, fai clic su Seleziona etichette da applicare, seleziona le etichette e fai clic su Ok.
  4. Per salvare le modifiche, fai clic su Conferma.

Aggiungere o rimuovere filtri

Dopo aver creato una dashboard, puoi aggiungere filtri a livello di dashboard che si applicano a tutti i widget o ad alcuni. Questi filtri possono essere utili durante la risoluzione dei problemi. Ad esempio, puoi usare questi filtri per visualizzare 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. Individua e seleziona la dashboard.

    • Per aggiungere un filtro a livello di dashboard valido solo per la sessione corrente, utilizza la barra dei filtri della dashboard. Per saperne di più, consulta la sezione Filtri temporanei.

    • Per aggiungere un filtro permanente a livello di dashboard, vai a Impostazioni nella barra degli strumenti della dashboard e seleziona Gestisci filtri. Per saperne di più, consulta la sezione Filtri permanenti.

Modificare i widget o cambiare il layout

Per modificare i widget su una dashboard o il layout della dashboard, procedi in uno dei seguenti modi:

  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. Individua e seleziona la dashboard.
  3. (Facoltativo) Per aggiungere un widget alla dashboard, fai clic su  Aggiungi widget nella barra degli strumenti della dashboard, quindi 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:

  4. (Facoltativo) Per modificare un widget, effettua una delle seguenti operazioni:

    • Posiziona il puntatore sul widget per attivare la barra degli strumenti, fai clic su  Modifica widget e 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. Ad esempio, per trasformare 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 maggiori informazioni, vedi Cambiare il tipo di widget.

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

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

  5. (Facoltativo) Per eliminare un widget, posiziona il puntatore sul widget per attivare la barra degli strumenti, quindi esegui una delle seguenti operazioni:

    • Se nella barra degli strumenti del widget è visualizzato un pulsante Elimina , fai clic su tale pulsante.
    • In caso contrario, fai clic su Altre opzioni, quindi seleziona Elimina widget.

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

  6. (Facoltativo) Per riposizionare un widget, utilizza il puntatore per trascinarlo tramite la relativa 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.

  7. (Facoltativo) Per ridimensionare un widget, utilizza il puntatore per riposizionare l'angolo destra del widget. 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.

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

Eliminare una dashboard

L'eliminazione di una dashboard che contiene un grafico per un criterio di avviso non elimina i criteri di avviso i cui dati sono stati visualizzati sui grafici. Pertanto, potresti ricevere notifiche da questi criteri dopo l'eliminazione della dashboard. Per informazioni su come gestire i criteri, nella pagina Avvisi della console Google Cloud, consulta Gestire i criteri 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. Per avviare l'azione di eliminazione, trova la dashboard da eliminare e fai clic su Elimina.
  3. Nella finestra di dialogo di conferma, fai clic su Elimina.
  4. Per salvare la dashboard modificata, fai clic su Salva nella barra degli strumenti.

Salva una definizione di dashboard 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 una definizione di dashboard, salvala nel tuo sistema locale, quindi sposta o copia la definizione in una posizione condivisa. Ad esempio, puoi copiare la definizione su un Drive condiviso o in un repository di codice sorgente come GitHub. Chiunque abbia accesso alla località archiviata può installare la dashboard nei propri progetti Google Cloud.

Per salvare la definizione di una dashboard personalizzata in un file in formato JSON archiviato nel tuo sistema locale, procedi nel seguente modo:

  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 dashboard, fai clic su Impostazioni, poi su JSON e quindi su Editor JSON.
  3. Per salvare la definizione della dashboard in un sistema locale, fai clic su Scarica file:

    Il file creato, che ha lo stesso nome della dashboard, contiene una rappresentazione JSON della dashboard. Questo file archivia solo la definizione della dashboard, non i dati delle serie temporali.

Condividere una dashboard

Quando esamini un'anomalia dei dati, potresti volere che un'altra persona del tuo team o della tua organizzazione visualizzi gli stessi dati che stai visualizzando. Ad esempio, potresti notare un calo o un picco imprevisto di una metrica delle prestazioni e potresti voler consultare un membro del team. In questo scenario, vuoi che un membro del tuo team visualizzi la dashboard e i relativi dati.

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

Configura l'aggiornamento dei dati

La barra degli strumenti della dashboard mostra un pulsante che indica se l'aggiornamento automatico è attivato o è disattivato. Per modificare lo stato, fai clic sul pulsante.

Attiva 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 fino a impostare On. Quando viene visualizzato Cloud Done (Fine cloud), le modifiche sono state salvate.

Passaggi successivi