Aggiungere testo e raggruppamenti a una dashboard

Questo documento descrive come aggiungere informazioni utili a una dashboard e come raggruppare i widget in una dashboard. Ad esempio, potresti voler aggiungere informazioni sulla dashboard, link a risorse pertinenti o cosa fare in diverse situazioni. Quando una dashboard contiene molti widget, puoi migliorarne l'usabilità raggruppandoli.

Per informazioni sull'API Cloud Monitoring, consulta Creare e gestire le dashboard tramite l'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.

Prima di iniziare

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

Aggiungere testo a una dashboard

La schermata seguente illustra un widget di testo:

Esempio di una dashboard con un widget di testo.

Le informazioni in questa sezione si riferiscono alla Google Cloud console. 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 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 Google Cloud console, seleziona il tuo Google Cloud progetto. Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione.
  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 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ù cancelletti 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 spaziatura fissa: utilizza i backtick, `fixed font`.

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

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

    • Per creare un link a un'altra sezione della dashboard. L'ancora per 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 le 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 non ordinati e puoi nidificare gli elenchi.

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

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

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

      + Unordered list item 1
+ Unordered list item 2

    • Per nidificare gli elenchi, rientra l'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: formatta come ${VARIABLE_NAME}.

    Il widget di testo esegue il rendering solo del valore o dei 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 come scritte e non vengono sottoposte a rendering.

  • Caratteri di escape

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

Organizzare 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 di intestazione della sezione. Quando aggiungi questo widget alla dashboard, viene creato un sommario e viene aggiunto un divisore orizzontale alla dashboard. Il sommario ti consente di navigare in una sezione specifica della dashboard. Ogni widget di sezione contiene un'ancora. Quando risolvi i 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, e 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, a discesa e a schede. I widget di gruppo contengono una raccolta di widget e migliorano il rendimento utilizzando dati con priorità inferiore da recuperare per i membri della raccolta non visualizzati. Il widget di gruppo comprimibile mostra tutti i membri della raccolta quando viene espanso, altrimenti tutti i membri sono nascosti. Al contrario, i widget di gruppo a discesa e di gruppo di schede mostrano solo un membro della raccolta. La differenza tra questi widget è se 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 configurarli 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 Modificare la configurazione di un widget.

Aggiungere un widget di intestazione della sezione

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

Per aggiungere un widget di intestazione della sezione utilizzando la Google Cloud console, procedere come segue:

  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 Google Cloud console, seleziona il tuo Google Cloud progetto. Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione.
  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, allora viene aggiunta una riga orizzontale dopo la voce nel sommario.

Aggiungere widget di gruppo comprimibile

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

Per aggiungere un widget di gruppo comprimibile utilizzando la Google Cloud console, eseguire le operazioni riportate di seguito:

  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 Google Cloud console, seleziona il tuo Google Cloud progetto. Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione.
  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 del gruppo con una priorità inferiore rispetto ad altri widget. Di conseguenza, la dashboard viene caricata più rapidamente.

Aggiungere widget di gruppo a discesa o di gruppo a schede

I widget di gruppo a discesa e di gruppo di schede contengono una raccolta di altri widget, ma visualizzano solo un membro della raccolta. La differenza tra questi widget è il modo in cui selezioni il membro della raccolta da visualizzare. I gruppi a discesa forniscono un menu, mentre i gruppi a 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 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 Google Cloud console, seleziona il tuo Google Cloud progetto. Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione.
  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 seleziona Gruppo a discesa o Gruppo di schede.

    Alla dashboard viene aggiunto un widget del tipo selezionato.

  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 di gruppo a schede modificando il gruppo:

    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 gruppo di schede.

    5. Utilizza i pulsents Abbassa e Alza per ordinare i widget nel widget di gruppo.

    6. Fai clic su Applica.

    La dashboard viene aggiornata e solo uno dei widget aggiunti al widget di gruppo è visibile. La barra degli strumenti del widget visualizzato ti consente di modificare il widget visualizzato o 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:

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