Aggiungere filtri temporanei a una dashboard personalizzata

Questo documento descrive come modificare i dati visualizzati in una dashboard personalizzata, senza dover modificare ogni widget, aggiungendo raggruppamenti temporanei e filtri temporanei. Dopo aver aggiunto un raggruppamento o un filtro a livello di dashboard, la barra degli strumenti della dashboard mostra una voce di menu per quel raggruppamento o filtro.

Durante la risoluzione dei problemi, puoi modificare i dati visualizzati in una dashboard aggiungendo raggruppamenti o filtri temporanei. Ad esempio, se stai esaminando un incidente e vuoi che la dashboard mostri solo i dati di una specifica macchina virtuale (VM), aggiungi un filtro temporaneo.

I raggruppamenti e i filtri temporanei vengono eliminati automaticamente quando ricarichi la pagina, ma puoi anche eliminarli manualmente.

Puoi anche creare filtri permanenti. Ad esempio, se blocchi un filtro, si comporta come un filtro temporaneo, ma è sempre disponibile. Puoi anche creare variabili, che ti consentono di applicare un filtro a determinati widget. Per saperne di più, consulta la pagina Creare e gestire variabili e filtri bloccati.

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.

Come funzionano i filtri del dashboard

Un filtro della dashboard specifica un'etichetta e un valore. Le serie temporali visualizzate nella dashboard determinano le etichette disponibili per il filtro. Il modo in cui un widget supporta un filtro a livello di dashboard dipende dal tipo di dati visualizzati dal widget e dalla sua configurazione:

  • Per i widget che mostrano dati delle serie temporali, come i grafici a linee, si applicano le seguenti regole:

    • Se la serie temporale visualizzata dal widget non supporta l'etichetta in un filtro, il filtro a livello di dashboard non modifica i dati visualizzati.

      Ad esempio, se aggiungi un filtro all'etichetta instance_id, ma un grafico nella dashboard non mostra dati con un'etichetta instance_id, allora il filtro non modifica i dati visualizzati.

    • Se il widget specifica un valore per un'etichetta, il filtro a livello di dashboard non modifica i dati visualizzati.

      Ad esempio, se aggiungi un filtro all'etichetta instance_id, ma un grafico nella dashboard include un filtro basato sull'etichetta instance_id, allora il filtro a livello di dashboard non modifica i dati visualizzati.

    • In caso contrario, il grafico filtra i dati visualizzati in modo da includere solo le serie temporali che soddisfano il filtro a livello di dashboard.

  • Per i widget del riquadro dei log, i filtri a livello di dashboard basati su un'etichetta risorsa aggiornano la query. Ad esempio, se aggiungi il filtro a livello di dashboard cluster_name: mycluster, la query viene aggiornata in modo da includere resource.labels."cluster_name"="mycluster".

Puoi aggiungere più filtri a livello di dashboard. Questi filtri sono uniti con un AND logico.

Prima di iniziare

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

Creare o modificare raggruppamenti temporanei

Quando aggiungi raggruppamenti a livello di dashboard, i widget della dashboard mostrano una serie temporale per ogni insieme di serie temporali che hanno gli stessi valori per le etichette di raggruppamento. Per impostazione predefinita, viene mostrata la media di ogni insieme. Tuttavia, quando il widget definisce una funzione di raggruppamento, viene utilizzata questa funzione.

Ad esempio, supponiamo che la dashboard contenga un grafico che mostra l'utilizzo della CPU delle tue istanze VM. Per determinare se devi eseguire il deployment di altre VM in una zona specifica, puoi modificare la dashboard e il grafico per cambiare le opzioni di raggruppamento. Un'alternativa è raggruppare temporaneamente la dashboard per zona e poi visualizzare il grafico di utilizzo della CPU.

Per creare o modificare i raggruppamenti temporanei:

  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 app.
  3. Espandi il menu Raggruppa per e poi seleziona le etichette per il raggruppamento.
  4. Fai clic su OK.

Quando esci dalla dashboard, i raggruppamenti che hai creato vengono eliminati.

Creare un filtro temporaneo

Quando esamini un incidente, potresti voler visualizzare i dati in modi specifici. Ad esempio, potresti voler visualizzare solo le serie temporali per una macchina virtuale specifica o per le risorse in una regione specifica. Quando crei un filtro temporaneo, tutti i widget della dashboard vengono modificati per mostrare i dati che corrispondono a quel filtro. Ad esempio, per configurare tutti i grafici in modo che mostrino solo le serie temporali per una specifica istanza VM, crea un filtro basato sull'etichetta instance_id. Allo stesso modo, per configurare la dashboard in modo che mostri solo le serie temporali per una zona specifica, crea un filtro basato sull'etichetta zone.

Per creare un filtro temporaneo:

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

  3. Nella barra dei filtri della dashboard, fai clic su Aggiungi filtro e poi seleziona un'etichetta dal menu.

    Il menu elenca le etichette per ogni serie temporale mostrata nella dashboard.

    Dopo aver selezionato un'etichetta, viene aggiunto un filtro alla barra degli strumenti della dashboard. Il nome del filtro corrisponde a quello della selezione e il suo valore è impostato su *, che corrisponde a tutti i valori. Ad esempio, se selezioni zone, nella barra degli strumenti viene visualizzato zone: *.

  4. Per selezionare un valore specifico da corrispondere, fai clic sul filtro, ad esempio zone: *, e poi seleziona un valore dal menu. Per ridurre il numero di opzioni del menu, inserisci parte del valore nell'area Filtro.

Quando esci dalla dashboard, i filtri che hai creato vengono eliminati.

Modificare un filtro temporaneo

Per modificare il valore di un filtro temporaneo, fai clic su Menu e poi effettua una selezione.

Dopo aver effettuato una selezione, i grafici e le tabelle vengono aggiornati.

Eliminare un filtro temporaneo

I filtri temporanei vengono eliminati automaticamente quando esci dalla dashboard. Per rimuovere manualmente un filtro temporaneo, fai clic su Elimina.

Passaggi successivi