Aggiungere testo e raggruppamenti a una dashboard

I widget di testo, intestazione di sezione e gruppo in una dashboard personalizzata in Cloud Monitoring ti consentono di documentare i passaggi per la risoluzione dei problemi e di organizzare grandi raccolte di grafici. Puoi utilizzare i widget di testo Markdown per visualizzare link e indicazioni operative e le intestazioni di sezione per generare un sommario navigabile. Per ridurre il disordine visivo e migliorare i tempi di caricamento della dashboard, puoi raggruppare i widget in gruppi comprimibili, a discesa o a schede.

Questo documento descrive come aggiungere questi widget utilizzando la consoleGoogle Cloud . Per informazioni sull'utilizzo dell'API Cloud Monitoring, consulta Crea e gestisci le dashboard tramite API.

Prima di iniziare

Completa i seguenti passaggi nel progetto Google Cloud in cui vuoi creare e modificare dashboard personalizzate:

Aggiungi testo a una dashboard

Lo screenshot seguente mostra un widget di testo:

Esempio di una dashboard con un widget di testo.

Le informazioni contenute in questa sezione riguardano la console Google Cloud . Per informazioni sull'utilizzo dell'API Cloud Monitoring, consulta Dashboard con un widget Text.

Per aggiungere un widget di testo 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 . Per le configurazioni di App Hub, seleziona il progetto host o il progetto di gestione di App Hub.
  3. Seleziona una dashboard o fai clic su Crea dashboard.
  4. Nella barra degli strumenti, fai clic su  Aggiungi widget.
  5. Nella finestra di dialogo Aggiungi widget, vai alla sezione Layout e seleziona Testo.
  6. Aggiungi un titolo.

  7. Nel riquadro Contenuti, inserisci il testo che vuoi visualizzare.

    Per informazioni sulla formattazione, consulta la sezione Sintassi Markdown.

  8. (Facoltativo) Utilizza i campi nel riquadro Visualizzazione per personalizzare i contenuti.

    Ad esempio, potresti voler configurare la visibilità del widget.

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

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

Sintassi Markdown

Questa sezione descrive la maggior parte della sintassi Markdown supportata dal widget di testo. I tag HTML non sono supportati.

  • Intestazioni

    Una riga che inizia con un cancelletto, #, indica un'intestazione. Puoi utilizzare più simboli di cancelletto per diversi livelli di intestazioni. Ad esempio, per un'intestazione di primo livello utilizza un singolo cancelletto, # Header. Per un'intestazione di secondo livello, utilizza due cancelletti, ## Second-level header.

  • Paragrafi

    Per creare un nuovo paragrafo, utilizza una riga vuota.

  • Enfasi

    • Corsivo: utilizza *italic* o _italic_.
    • Grassetto: utilizza **bold** o __bold__.
    • Grassetto e corsivo: utilizza ***bold and italic***.
    • Carattere a larghezza fissa: utilizza gli apici inversi, `fixed font`.

  • Link: formattali come [link text](path).

    Puoi utilizzare qualsiasi valore per link text. Il valore di path deve fare riferimento a un anchor HTML nella dashboard o essere un URL di una pagina esterna.

    • Per creare un link a un'altra sezione della dashboard, imposta path sull'ancoraggio della sezione. L'ancoraggio di una sezione è il titolo della sezione, convertito in minuscolo con le parole separate da un trattino. Ad esempio, per creare un link a una sezione con il titolo "Grafici che utilizzano variabili", imposta path su #charts-using-variables.

    • Per creare un link a una risorsa esterna, imposta path sull'URL. Ad esempio, per creare un link a example.com, imposta path su https://example.com/.

  • Elenchi: puoi creare elenchi ordinati o elenchi non ordinati e nidificarli.

    • Per gli elenchi ordinati, aggiungi il prefisso 1. a ogni elemento dell'elenco. Quando il testo viene visualizzato, gli elementi vengono numerati in sequenza. Ad esempio:

      1. Ordered list item 1
1. Ordered list item 2

    • Per gli elenchi non ordinati, aggiungi un prefisso a ogni elemento dell'elenco con un segno più (+), un trattino (-) o un asterisco (*). Ad esempio:

      + Unordered list item 1
+ Unordered list item 2

    • Per nidificare gli elenchi, applica il rientro all'elenco nidificato. Ad esempio:

      1.  Item 1
    + Nested unordered-list item 1
    + Nested unordered-list item 2
1.  Item 2
    1. Nested ordered-list item 1
    1. Nested ordered-list item 2

  • Variabili: formattale come ${VARIABLE_NAME}.

    Il widget di testo mostra solo il valore o i valori della variabile. Ad esempio, se hai una variabile basata su etichette in cui la chiave è zone e il valore è us-west1, il widget di testo visualizza us-west1.

    Quando il valore di una variabile è il carattere jolly (*), il widget di testo visualizza all.

    Le variabili non riconosciute vengono visualizzate così come sono scritte e non vengono visualizzate.

  • Caratteri di escape

    Alcuni caratteri, come i segni più (+), vengono convertiti in elementi di un elenco. Se vuoi visualizzare questi tipi di caratteri letteralmente, utilizza una barra rovesciata per eseguire l'escape del carattere, \+.

Organizza i widget della dashboard

Le dashboard personalizzate ti consentono di specificare la posizione dei grafici, delle policy di avviso e di altri widget. Tuttavia, puoi migliorare l'usabilità di una dashboard con molti widget creando sezioni nella dashboard o raggruppando i widget:

  • Per creare sezioni indicizzate nella dashboard, utilizza il widget section-header. Quando aggiungi questo widget alla dashboard, viene creato un sommario e viene aggiunto un divisore orizzontale alla dashboard. Il sommario ti consente di accedere a una sezione specifica della dashboard. Ogni widget di sezione contiene un'ancora. Durante la risoluzione dei problemi, potresti voler condividere l'URL della sezione con un collega. Per copiare l'URL della sezione, fai clic con il tasto destro del mouse su Link all'intestazione, quindi seleziona Copia indirizzo link.

  • Per ridurre il tempo di caricamento di una dashboard, utilizza i widget di gruppo. Esistono tre tipi di widget di gruppo: comprimibile, menu a discesa e scheda. I widget di gruppo contengono una raccolta di widget e migliorano le prestazioni recuperando i dati con una priorità inferiore per i membri della raccolta che non vengono visualizzati. Il widget del gruppo comprimibile mostra ogni membro della raccolta quando viene espanso; altrimenti, tutti i membri sono nascosti. Al contrario, i widget Gruppo a discesa e Gruppo di schede mostrano un solo membro della raccolta. La differenza tra questi widget è che selezioni il membro da visualizzare utilizzando un menu o una scheda.

Per utilizzare i widget descritti in questa sezione, la dashboard personalizzata deve utilizzare la modalità mosaico, che è il layout predefinito. Se modifichi il layout in una griglia, questi widget non sono disponibili.

Per la maggior parte dei widget, puoi configurare la visibilità. Tuttavia, i widget organizzativi sono sempre visibili.

Il resto di questa sezione descrive come aggiungere e configurare i widget che puoi utilizzare per organizzare le dashboard. Per informazioni sulla modifica di questi widget, consulta Modifica la configurazione di un widget.

Aggiungi un widget di intestazione della sezione

Per informazioni sull'utilizzo dell'API Cloud Monitoring per creare un widget di intestazione di sezione, consulta Dashboard con un widget SectionHeader.

Per aggiungere un widget di intestazione di sezione utilizzando la console 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 . Per le configurazioni di App Hub, seleziona il progetto host o il progetto di gestione di App Hub.
  3. Nella finestra di dialogo Aggiungi widget, vai alla sezione Layout e seleziona il widget Intestazione sezione.

  4. Nel widget, fai clic su Modifica sezione e completa la finestra di dialogo:

    • Il valore del campo Nome della sezione viene visualizzato nel sommario.
    • Il valore del campo Sottotitolo viene visualizzato nella dashboard.
    • Se selezioni Aggiungi un divisore al sommario, viene aggiunta una linea orizzontale dopo la voce nel sommario.

Aggiungi widget di gruppi comprimibili

Per informazioni sull'utilizzo dell'API Cloud Monitoring per creare un widget di gruppo comprimibile, consulta Dashboard con un widget CollapsibleGroup.

Per aggiungere un widget di gruppo comprimibile utilizzando la console 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 . Per le configurazioni di App Hub, seleziona il progetto host o il progetto di gestione di App Hub.
  3. Nella finestra di dialogo Aggiungi widget, vai alla sezione Layout e seleziona Gruppo comprimibile.

  4. Per aggiungere un widget al gruppo, trascinalo nel gruppo.

    Dopo aver aggiunto i widget al gruppo, puoi utilizzare il puntatore per ridimensionarli e riposizionarli.

  5. Per aggiungere un titolo descrittivo al gruppo, posiziona il puntatore sul widget per attivare la barra degli strumenti, quindi fai clic su Modifica gruppo.

  6. (Facoltativo) Per forzare la compressione del gruppo per impostazione predefinita, posiziona il puntatore sul widget per attivare la barra degli strumenti, quindi fai clic su Comprimi gruppo.

    Quando un widget di gruppo comprimibile è compresso, Monitoring recupera i dati per i widget nel gruppo con una priorità inferiore rispetto agli altri widget. Di conseguenza, la dashboard si carica più rapidamente.

Aggiungi widget di gruppi di menu a discesa o di gruppi di schede

I widget dei gruppi di menu a discesa e dei gruppi di schede contengono una raccolta di altri widget, ma mostrano un solo membro della raccolta. La differenza tra questi widget è il modo in cui selezioni l'elemento della raccolta da visualizzare. I gruppi di menu a discesa forniscono un menu, mentre i gruppi di schede forniscono schede nella barra degli strumenti.

Per informazioni sull'utilizzo dell'API Cloud Monitoring per creare questi widget, consulta Dashboard con un widget SingleViewGroup.

Per aggiungere questi widget 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 . Per le configurazioni di App Hub, seleziona il progetto host o il progetto di gestione di App Hub.
  3. Se necessario, crea i widget che vuoi aggiungere al widget di gruppo.

  4. Nella finestra di dialogo Aggiungi widget, vai alla sezione Layout e poi seleziona Gruppo di menu a discesa o Gruppo di schede.

    Un widget del tipo selezionato viene aggiunto alla dashboard.

  5. Per aggiungere widget come un grafico a linee a un widget di gruppo, trascinali nel widget di gruppo o modifica il widget di gruppo ed esegui un'operazione di aggiunta.

    Ad esempio, per aggiungere widget a un widget gruppo di schede modificando il gruppo, procedi nel seguente modo:

    1. Nella barra degli strumenti del widget, seleziona Modifica gruppo di schede, quindi seleziona Modifica gruppo.
    2. (Facoltativo) Inserisci un titolo per il gruppo.

    3. Fai clic su Aggiungi widget, quindi effettua una selezione dal menu Aggiungi widget.

      Il menu Aggiungi widget elenca i widget che possono essere aggiunti al gruppo.

    4. Ripeti il passaggio precedente per ogni widget che vuoi aggiungere al widget del gruppo di schede.

    5. Utilizza i pulsanti Sposta in basso e Sposta in alto per ordinare i widget nel widget di gruppo.

    6. Fai clic su Applica.

    La dashboard viene aggiornata e viene visualizzato solo uno dei widget aggiunti al widget di gruppo. La barra degli strumenti del widget visualizzato ti consente di modificare il widget visualizzato o di eseguire altre azioni.

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

Passaggi successivi

Puoi anche aggiungere widget alle dashboard personalizzate che mostrano quanto segue:

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