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 aggiungere informazioni sulla dashboard, link a risorse pertinenti o istruzioni su cosa fare in situazioni diverse. Quando una dashboard contiene molti widget, puoi migliorare la sua usabilità raggruppandoli.

Per informazioni sull'API Cloud Monitoring, consulta Creare e gestire le dashboard tramite API.

Prima di iniziare

Aggiungere testo a una dashboard

Lo screenshot seguente mostra un widget di testo:

Esempio di una dashboard con un widget di testo.

Le informazioni 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. Seleziona una dashboard o fai clic su Crea dashboard.
  3. Nella barra degli strumenti, fai clic su  Aggiungi widget.
  4. Nella finestra di dialogo Aggiungi widget, vai alla sezione Layout e poi seleziona Testo.
  5. Aggiungi un titolo.
  6. Nel riquadro Contenuti, inserisci il testo che vuoi visualizzare.

    Per informazioni sulla formattazione, consulta Comandi Markdown supportati.

  7. Opzioni: utilizza i campi nel riquadro Visualizzazione per personalizzare i contenuti.

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

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

Comandi Markdown supportati

Questa sezione descrive i comandi Markdown supportati dal widget di testo:

  • Intestazioni

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

  • Caratteri

    • Corsivo: utilizza *italic* o _italic_.
    • Grassetto: utilizza **bold** o __bold__.
  • Link: formatta come [link text](path).

    Puoi utilizzare qualsiasi valore per 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 di una sezione è il titolo della sezione, convertito in minuscolo con le parole separate da un tratto. Ad esempio, per creare un link a una sezione con il titolo "Grafici che utilizzano le variabili", imposta path su #charts-using-variables.

    • Per eseguire il collegamento a una risorsa esterna, imposta path sull'URL. Ad esempio, per eseguire il collegamento a example.com, imposta path su https://example.com/.

  • Variabili: formatta 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 mostra 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 visualizzate.

Organizzare i widget della dashboard

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

  • Per creare sezioni indicizzate nella dashboard, utilizza il widget sezione-intestazione. Quando aggiungi questo widget alla dashboard, viene creato un sommario e viene aggiunto un divisore orizzontale alla dashboard. Il sommario ti consente di passare a una sezione specifica della dashboard. Ogni widget della sezione contiene un'ancora. Quando risolvi i problemi, ti consigliamo di condividere l'URL della sezione con un collega. Per copiare l'URL della sezione, fai clic con il tasto destro del mouse su Collega a titolo e poi seleziona Copia indirizzo link.

  • Per ridurre il tempo di caricamento di una dashboard, utilizza i widget di gruppo comprimibili e i widget con visualizzazione singola. Entrambi i widget contengono una raccolta di widget e migliorano il rendimento utilizzando dati con priorità inferiore per recuperare i membri della raccolta non visualizzati. Il widget del gruppo comprimibile visualizza ogni elemento della raccolta quando è espanso, altrimenti tutti gli elementi sono nascosti. Al contrario, un widget di gruppo con visualizzazione singola mostra un solo elemento della raccolta alla volta e puoi utilizzare un menu per selezionare l'elemento da visualizzare.

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 modo da avere una griglia, questi widget non sono disponibili.

Il resto di questa sezione descrive come aggiungere e configurare i widget che puoi utilizzare per organizzare le dashboard. Per informazioni su come modificare 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.

Per aggiungere un widget di intestazione della 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 finestra di dialogo Aggiungi widget, vai alla sezione Layout e poi seleziona il widget Intestazione sezione.
  3. Nel widget, fai clic su Modifica sezione e completa la finestra di dialogo:

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

Aggiungere un widget di gruppo comprimibile

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 finestra di dialogo Aggiungi widget, vai alla sezione Layout e poi seleziona Gruppo comprimibile.
  3. Per aggiungere un widget al gruppo, trascinalo al suo interno.

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

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

  5. (Facoltativo) Per assicurarti che il gruppo sia compresso per impostazione predefinita, posiziona il cursore 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 dei widget nel gruppo con una priorità inferiore rispetto agli altri widget. Di conseguenza, la dashboard si carica più rapidamente.

Aggiungere un widget di gruppo con visualizzazione singola

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

Per aggiungere un widget di gruppo con una sola visualizzazione 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. Se necessario, crea i widget da aggiungere al widget con visualizzazione singola.
  3. Nella finestra di dialogo Aggiungi widget, vai alla sezione Layout e poi seleziona Gruppo di visualizzazioni singole.

    Alla dashboard viene aggiunto un widget di gruppo con una sola visualizzazione.

  4. Aggiungere widget al widget gruppo con visualizzazione singola:

    1. Nel widget gruppo con visualizzazione singola, espandi il menu Widget e poi seleziona Modifica gruppo.
    2. Fai clic su Aggiungi widget, quindi effettua una selezione dal menu Aggiungi widget.

    3. Ripeti il passaggio precedente per ogni widget che vuoi aggiungere al widget gruppo con visualizzazione singola.

    4. Utilizza i pulsanti Più basso e Più alto per ordinare i widget nel widget di gruppo.

    5. Fai clic su Invia.

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

Passaggi successivi

Puoi anche aggiungere i seguenti widget alle tue dashboard personalizzate:

Per informazioni su come esplorare i dati dei grafici e filtrare le dashboard, consulta i seguenti documenti: