Gestire i widget della dashboard

Dopo aver creato una dashboard personalizzata, potresti volerla modificare. Ad esempio, potresti voler convertire un grafico a linee, che mostra ogni serie temporale, in un grafico ad area in pila per visualizzare la proporzione con cui ogni serie temporale contribuisce alla somma.

Questo documento descrive come modificare il tipo di un widget, come modificare la serie temporale visualizzata da un widget e come eliminare un widget utilizzando la consoleGoogle Cloud . Per informazioni su come gestire le dashboard personalizzate tramite l'API, consulta Crea e gestisci dashboard tramite API.

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

• Aggiungere grafici, tabelle e indicatori
• Visualizzare policy di avviso e incidenti
• Visualizzare le voci di log
• Aggiungere testo e raggruppare i widget
• Visualizzare gli obiettivi del livello di servizio (SLO)

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

Prima di iniziare

Completa i seguenti passaggi nel progetto Google Cloud in cui vuoi gestire le dashboard:

• 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 Monitoring (roles/monitoring.editor) nel tuo progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

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

  Per saperne di più sui ruoli, consulta Controllare l'accesso con Identity and Access Management.

Visualizza rappresentazione JSON

La rappresentazione JSON di una dashboard o di un widget può essere utile quando preferisci gestire le dashboard utilizzando l'API Cloud Monitoring, ma prototipi le dashboard utilizzando la console Google Cloud .

Per visualizzare o modificare la rappresentazione JSON della dashboard:

1. Nella Google Cloud console, 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 Google Cloud progetto. Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione della cartella app.
3. Seleziona una dashboard o fai clic su Crea dashboard.

4. Esegui una di queste operazioni:

   • Per visualizzare o modificare la rappresentazione JSON della dashboard, nella barra degli strumenti della dashboard, fai clic su settings Impostazioni, fai clic su JSON, quindi su Editor JSON.

     Ora puoi visualizzare o modificare la rappresentazione JSON. Se apporti modifiche, assicurati di fare clic su Applica modifiche.

   • Per visualizzare o modificare la rappresentazione JSON di un widget specifico, posiziona il puntatore sul widget per attivare la barra degli strumenti, fai clic su edit Modifica widget e poi fai clic su code Editor JSON.

     Ora puoi visualizzare o modificare il file JSON. Se apporti modifiche, assicurati di fare clic su Applica modifiche.

Modificare il tipo di widget

Quando un widget mostra i dati corretti, ma non li presenta nel modo più utile, valuta la possibilità di modificare il tipo di widget. Ad esempio, supponiamo di avere un grafico a linee nella dashboard. Per visualizzare il contributo di ogni serie temporale alla somma, trasforma il grafico a linee in un grafico ad area in pila.

Puoi modificare il tipo di un widget solo se il widget di destinazione può rappresentare i dati mostrati dal widget di origine. Ad esempio, puoi sempre trasformare un grafico a linee in un grafico ad area in pila o a barre in pila. Allo stesso modo, puoi sempre convertire un grafico a barre, che mostra una singola serie temporale, in un grafico a linee. Tuttavia, potresti non essere in grado di convertire un grafico a linee, che può mostrare più serie temporali, in un grafico a contatore.

Non puoi modificare il tipo di grafico che mostra i dati per un criterio di avviso, un pannello dei log o un gruppo comprimibile. Non puoi convertire alcun widget in un pannello dei log o in un widget di gruppo comprimibile.

Creare un criterio di avviso da un grafico a linee

Per convertire un grafico a linee che mostra un singolo tipo di metrica in un grafico che mostra i dati per un criterio di avviso, segui questi passaggi:

1. Nella Google Cloud console, 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 Google Cloud progetto. Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione della cartella app.
3. Seleziona una dashboard o fai clic su Crea dashboard.

4. Posiziona il puntatore sul widget per attivare la barra degli strumenti, fai clic su more_vert Altre opzioni e poi seleziona Converti in grafico degli avvisi.

   Quando effettui questa selezione, si apre la finestra di dialogo Crea criterio di avviso e le selezioni di metrica, filtro e raggruppamento del grafico vengono applicate alla condizione di avviso. Completa la specifica del criterio di avviso e poi fai clic su Crea. Per informazioni su questi passaggi, vedi Creare un criterio di avviso.

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

Impostare il tipo di widget

Per eseguire conversioni diverse dalla conversione di un grafico a linee in un grafico che mostra i dati per unacriterio di avvisoo, segui questi passaggi:

1. Nella Google Cloud console, 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 Google Cloud progetto. Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione della cartella app.
3. Seleziona una dashboard o fai clic su Crea dashboard.
4. Sul widget di cui vuoi modificare il tipo, posiziona il puntatore sul widget per attivare la barra degli strumenti e poi fai clic su edit Modifica widget.

5. Nel riquadro Visualizzazione, espandi il menu 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, considera un grafico che mostra più serie temporali, in cui ogni misurazione è un numero double:

   • Il pannello dei log non è elencato perché non può visualizzare i dati delle serie temporali.
   • I widget Prospetto e Indicatore sono elencati sotto l'intestazione Compatibile con gli aggiustamenti perché questi due widget possono mostrare una sola serie temporale e il grafico ne mostra più di una. Prima di poter eseguire la conversione a uno di questi tipi, devi modificare la configurazione del raggruppamento.
   • Il widget Mappa termica è disattivato perché questi widget mostrano solo dati con valori di distribuzione.
   • I widget Grafico ad area in pila, Grafico a barre in pila e Tabella sono elencati sotto l'intestazione Compatibili. Puoi selezionare uno di questi valori.

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

Modificare la configurazione di un widget

Per modificare la serie temporale visualizzata da un widget o la modalità di combinazione delle serie temporali, modifica la configurazione del widget. Ad esempio, quando un grafico mostra molte serie temporali, puoi migliorare le prestazioni e la chiarezza visiva del grafico raggruppando le serie temporali in base a una o più etichette.

Per modificare la configurazione di un widget:

1. Nella Google Cloud console, 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 Google Cloud progetto. Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione della cartella app.
3. Seleziona una dashboard o fai clic su Crea dashboard.

4. Modifica il widget:

   • Per tutti i widget diversi dal widget a visualizzazione singola e dal widget del gruppo comprimibile, posiziona il puntatore sul widget per attivare la barra degli strumenti, quindi fai clic su edit Modifica widget.

     Si apre la pagina di configurazione del widget.

   • Per il widget del gruppo comprimibile, esegui una delle seguenti operazioni:

     • Per modificare il nome del gruppo, fai clic su edit Modifica gruppo, quindi completa la finestra di dialogo.
     • Per aggiungere widget al gruppo, trascinali dalla dashboard al gruppo.
     • Per rimuovere i widget dal gruppo, eliminali o trascinali nello spazio inutilizzato della dashboard.

   • Per il widget a visualizzazione singola, espandi il menu Widget, fai clic su edit Modifica gruppo e poi esegui una delle seguenti operazioni:

     • Per aggiungere un widget al gruppo, fai clic su Aggiungi widget e completa la finestra di dialogo.

     • Per rimuovere un widget dal gruppo, procedi in uno dei seguenti modi:

       1. Per eliminare un widget, fai clic su delete Elimina widget.
       2. Per rimuovere un widget dal gruppo e spostarlo nella dashboard, fai clic su cancel Rimuovi dal gruppo.

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

Eliminare un widget

La velocità con cui una dashboard mostra i dati dipende dal numero di widget che visualizza e dal numero di serie temporali visualizzate da ogni widget. Per migliorare il rendimento di una dashboard, una possibilità è inserire i widget usati raramente in un widget di gruppo comprimibile e comprimere il gruppo. I dati per i widget in un gruppo compresso vengono caricati con una priorità inferiore rispetto agli altri widget della dashboard. Un'alternativa all'utilizzo del widget Gruppo comprimibile è eliminare i widget che non utilizzi.

L'eliminazione di un grafico associato a un criterio di avviso non comporta l'eliminazione del criterio di avviso i cui dati sono stati visualizzati nel grafico. Per eliminare un criterio di avviso, vai alla pagina Avvisi nella console Google Cloud . Per informazioni su come eliminare un criterio, vedi Gestire i criteri di avviso. Non puoi eliminare un criterio di avviso da una dashboard personalizzata.

Per eliminare un widget in una dashboard:

1. Nella Google Cloud console, 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 Google Cloud progetto. Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione della cartella app.
3. Seleziona una dashboard o fai clic su Crea dashboard.

4. Elimina il widget:

   • Per tutti i widget diversi dal widget a visualizzazione singola e dal widget del gruppo comprimibile, posiziona il puntatore sul widget per attivare la barra degli strumenti, fai clic su more_vert Altre opzioni e poi seleziona Elimina widget.

   • Per il widget del gruppo comprimibile, posiziona il puntatore sul widget per attivare la barra degli strumenti, quindi esegui una delle seguenti operazioni:

     • Per eliminare il widget del gruppo comprimibile e i widget che contiene, fai clic su delete Rimuovi gruppo e i relativi figli.
     • Per eliminare un widget di gruppo comprimibile e spostare i widget nella dashboard, fai clic su cancel Rimuovi il gruppo ma mantieni i relativi figli.

   • Per il widget a visualizzazione singola, espandi il menu Widget, fai clic su edit Modifica gruppo e poi esegui una delle seguenti operazioni:

     • Per eliminare il widget del gruppo a visualizzazione singola e i widget che contiene, fai clic su delete Elimina gruppo.
     • Per eliminare il gruppo a visualizzazione singola e spostare i widget che contiene nella dashboard, fai clic su cancel Separa.

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

Passaggi successivi

• Esplorare i dati dei grafici
• Configurare le legende
• Filtrare una dashboard:
  • Aggiungere filtri temporanei a una dashboard personalizzata
  • Aggiungere filtri permanenti a una dashboard personalizzata