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.

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 abilitata per le app.

Prima di iniziare

Nel progetto Google Cloud in cui vuoi creare e modificare le dashboard personalizzate:

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. Nella barra degli strumenti della console Google Cloud, seleziona il tuo progetto Google Cloud. Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione della cartella abilitata per le app.
  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 poi seleziona Testo.
  6. Aggiungi un titolo.

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

    Per informazioni sulla formattazione, consulta Comandi Markdown supportati.

  8. Opzioni: 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.

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 trattino. Ad esempio, per fare 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. Esistono tre tipi di widget di gruppo: comprimibili, a discesa e con schede. I widget di gruppo contengono una raccolta di widget e migliorano il rendimento utilizzando dati con priorità inferiore per recuperare i membri della raccolta che non vengono visualizzati. Il widget del gruppo comprimibile visualizza ogni elemento della raccolta quando è espanso, altrimenti tutti gli elementi sono nascosti. I widget Gruppo a discesa e Gruppo di schede, invece, mostrano un solo elemento 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 modo da avere una griglia, questi widget non sono disponibili.

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

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 barra degli strumenti della console Google Cloud, seleziona il tuo progetto Google Cloud. Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione della cartella abilitata per le app.
  3. Nella finestra di dialogo Aggiungi widget, vai alla sezione Layout e poi seleziona il widget Intestazione sezione.

  4. 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 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 di App Hub o il progetto di gestione della cartella abilitata per le app.
  3. Nella finestra di dialogo Aggiungi widget, vai alla sezione Layout e poi seleziona Gruppo comprimibile.

  4. 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.

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

  6. (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 widget di gruppi di schede o gruppi di menu a discesa

I widget di gruppo a discesa e di gruppo di schede contengono una raccolta di altri widget, ma mostrano solo un elemento 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 di App Hub o il progetto di gestione della cartella abilitata per le app.
  3. Se necessario, crea i widget da 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.

    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 modificalo ed esegui un'operazione di aggiunta.

    Ad esempio, per aggiungere widget a un widget gruppo di schede modificando il gruppo:

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

    3. Fai clic su Aggiungi widget e poi 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 pulsanti Più basso e Più 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 gruppo. La barra degli strumenti del widget visualizzato ti consente di modificare il 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 i seguenti widget alle tue dashboard personalizzate:

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