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, nella barra degli strumenti della dashboard viene visualizzata una voce di menu relativa a quel raggruppamento o filtro.

Durante la risoluzione dei problemi, puoi modificare i dati visualizzati da 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 macchina virtuale (VM) specifica, aggiungi un filtro temporaneo.

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

Per informazioni su come creare filtri permanenti, consulta [Aggiungere filtri permanenti alle dashboard personalizzate][filtro permanente].

Come funzionano i filtri nella dashboard

Un filtro della dashboard specifica un'etichetta e un valore. Le serie temporali visualizzate nella dashboard determinano le etichette disponibili per l'applicazione dei filtri. 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 visualizzano dati delle serie temporali, come i grafici a linee, si applicano le seguenti regole:

    • Se le serie temporali visualizzate dal widget non supportano 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 i dati con l'etichetta instance_id, 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, il filtro a livello di dashboard non modifica i dati visualizzati.

    • In caso contrario, il grafico filtra i dati visualizzati solo per 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 della 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 dall'operatore logico AND.

Prima di iniziare

Per ottenere le autorizzazioni necessarie per aggiungere o modificare i filtri temporanei utilizzando la console Google Cloud, chiedi all'amministratore di concederti il ruolo IAM Visualizzatore Monitoring (roles/monitoring.viewer) nel tuo progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Per ulteriori informazioni sui ruoli, consulta Controllare l'accesso con Identity and Access Management.

Crea o modifica raggruppamenti temporanei

Quando aggiungi raggruppamenti a livello di dashboard, i widget sulla dashboard mostrano una serie temporale per ogni insieme di serie temporali con 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.

Supponiamo, ad esempio, che la dashboard contenga un grafico che mostra l'utilizzo della CPU da parte delle istanze VM. Per determinare se è necessario eseguire il deployment di più VM in una determinata zona, puoi modificare la dashboard e il grafico per cambiare le relative opzioni di raggruppamento. In alternativa, puoi raggruppare temporaneamente la dashboard per zona e visualizzare il grafico sull'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. Espandi il menu Raggruppa per di , quindi seleziona le etichette per il raggruppamento.
  3. Fai clic su Ok.

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

Creare un filtro temporaneo

Quando indaghi su un incidente, potresti voler esaminare i dati in modi specifici. Ad esempio, potresti voler visualizzare solo le serie temporali per una macchina virtuale o per risorse Quando crei un filtro temporaneo, tutti i widget della dashboard vengono modificati in modo da mostrare i dati corrispondenti 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. Analogamente, per configurare la dashboard in modo che mostri solo le serie temporali relative a 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 dei filtri della dashboard, fai clic su Aggiungi filtro e seleziona un'etichetta dal menu.

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

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

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

Quando esci dalla dashboard, tutti i filtri creati vengono eliminati.

Aggiungere filtri temporanei corrispondenti a una serie temporale

Per maggiori informazioni su una serie temporale specifica mostrata in un grafico, puoi utilizzare la legenda del grafico per applicare filtri temporanei. Puoi applicare filtri che corrispondono a etichette specifiche della serie temporale, alla risorsa della serie temporale o solo alle etichette della metrica. In questa sezione vengono descritte queste opzioni.

Dashboard di esempio

Per descrivere il comportamento delle diverse opzioni, puoi utilizzare una dashboard che mostri le metriche CPU utilization e Disk read bytes per le istanze VM di Compute Engine. Il seguente screenshot mostra questa dashboard per un sistema:

Visualizzazione della dashboard di esempio.

Filtrare in base a tutte le etichette di una serie temporale

Quando vuoi applicare l'insieme più restrittivo di etichette, filtra in base a tutte le etichette. Con questa opzione, le etichette identificano una risorsa unica e un insieme univoco di valori per le etichette della metrica.

Per applicare filtri temporanei che identificano una serie temporale specifica in un grafico:

  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. Identifica il grafico ed espandi la legenda per visualizzare ulteriori dettagli facendo clic su  Espandi legenda.
  3. Scorri la legenda fino a quando non trovi la serie temporale specifica che ti interessa, fai clic su Azioni per questa serie temporale e poi seleziona Filtra la dashboard in modo da visualizzare tutte le etichette.

Ad esempio, quando questi passaggi vengono applicati al grafico che mostra la metrica CPU utilization per la dashboard di esempio, vengono aggiunti i seguenti filtri:

  • Etichetta metrica: instance_name.

  • Etichette delle risorse per le istanze VM di Compute Engine:

    • project_id
    • instance_id
    • zone

Il seguente screenshot illustra il risultato:

Visualizzazione della dashboard di esempio con filtri per tutte le etichette di una serie temporale di utilizzo della CPU.

Nella figura precedente, il grafico che mostra la metrica CPU utilization mostra una singola serie temporale. Questo comportamento è dovuto al fatto che hai aggiunto filtri che corrispondono alle etichette delle serie temporali. Tuttavia, il grafico che mostra la metrica Disk read bytes mostra più serie temporali. La metrica Disk read bytes contiene tre etichette oltre all'etichetta instance_name, quindi è possibile fare riferimento alla stessa istanza per più serie temporali in questo grafico.

A titolo di confronto, quando i passaggi precedenti vengono applicati al grafico che mostra la metrica Disk read bytes per la dashboard di esempio, vengono aggiunti i seguenti filtri:

  • Etichette metriche:

    • instance_name
    • device_name
    • storage_type
    • device_type

  • Etichette delle risorse per le istanze VM di Compute Engine:

    • project_id
    • instance_id
    • zone

Visualizzazione della dashboard di esempio con i filtri per tutte le etichette di una serie temporale in byte di lettura su disco.

Come mostrato nello screenshot precedente, entrambi i grafici ora mostrano una singola serie temporale.

Filtra per etichette di risorse di una serie temporale

Quando filtri in base a tutte le etichette delle risorse, limiti la dashboard in modo che mostri le serie temporali per una risorsa specifica. Ora puoi visualizzare le metriche solo per quella risorsa, eliminando temporaneamente dalla visualizzazione le serie temporali che non sono di tuo interesse.

Per applicare filtri temporanei che identificano la risorsa per una serie temporale specifica visualizzata da un grafico, 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. Identifica il grafico ed espandi la legenda per visualizzare ulteriori dettagli facendo clic su  Espandi legenda.
  3. Scorri la legenda fino a quando non trovi la serie temporale specifica che ti interessa, fai clic su Azioni per questa serie temporale e poi seleziona Filtra la dashboard in base alle etichette delle risorse.

Ad esempio, quando questi passaggi vengono eseguiti nel grafico che mostra la metrica CPU utilization per la dashboard di esempio, vengono aggiunti tre filtri. Questi filtri corrispondono alle etichette per la risorsa, un'istanza VM:

Visualizzazione della dashboard di esempio con filtri per le etichette delle risorse di una serie temporale di utilizzo della CPU.

Come illustrato nello screenshot precedente, quando filtri per risorsa, un grafico potrebbe visualizzare più serie temporali.

Poiché l'opzione Filtra la dashboard in base alle etichette delle risorse applica solo le etichette delle risorse alla barra dei filtri temporanea, il risultato è lo stesso quando selezioni questa opzione da uno dei due grafici.

Filtrare per etichette di metrica di una serie temporale

Questa opzione consente di applicare filtri che corrispondono ai valori delle etichette di una metrica. Ad esempio, quando visualizzi le metriche di bilanciamento del carico, potresti voler visualizzare le serie temporali relative a un solo protocollo specifico.

Per applicare filtri temporanei che identificano la metrica per una specifica serie temporale visualizzata da un grafico:

  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. Identifica il grafico ed espandi la legenda per visualizzare ulteriori dettagli facendo clic su  Espandi legenda.
  3. Scorri la legenda fino a trovare la serie temporale specifica che ti interessa, fai clic su Azioni per questa serie temporale e poi seleziona Filtra la dashboard in base alle etichette delle metriche.

Ad esempio, quando questi passaggi vengono eseguiti sul grafico che mostra la metrica CPU utilization per la dashboard di esempio, viene aggiunto un filtro basato sull'etichetta instance_name. In questo caso, è possibile che entrambi i grafici mostrino più serie temporali, poiché il valore dell'etichetta instance_name è configurabile. In altre parole, puoi avere più VM con lo stesso valore per l'etichetta instance_name.

Per fare un confronto, quando i passaggi precedenti vengono applicati al grafico che mostra la metrica Disk read bytes per la dashboard di esempio, vengono aggiunti quattro filtri. Questi filtri corrispondono alle etichette della metrica Disk read bytes.

Quando i filtri temporanei includono solo i filtri delle metriche, vengono visualizzate le serie temporali per la metrica in questione, indipendentemente dalla risorsa in base alla quale è stata scritta la serie temporale. Dal momento che non stai limitando le serie temporali a una risorsa specifica, potresti vedere più serie temporali su un grafico. Lo screenshot precedente illustra questo comportamento, in quanto entrambi i grafici mostrano due serie temporali.

Modificare o eliminare un filtro temporaneo

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

Passaggi successivi