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 filtro o un raggruppamento a livello di dashboard, la barra degli strumenti della dashboard mostra una voce di menu per il raggruppamento o il filtro in questione.

Durante la risoluzione dei problemi, puoi modificare i dati visualizzati in una dashboard aggiungendo filtri o raggruppamenti temporanei. Ad esempio, se stai indagando su 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.

Come funzionano i filtri della 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, ad esempio 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 sull'etichetta instance_id, ma un grafico nella dashboard non mostra 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 sull'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 di 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

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

Potresti anche essere in grado di 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.

Creare o modificare 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.

Ad esempio, supponiamo che la tua dashboard contenga un grafico che mostra l'utilizzo della CPU da parte delle istanze VM. Per determinare se devi eseguire il deployment di più VM in una determinata zona, puoi modificare la dashboard e il grafico per cambiare le opzioni di raggruppamento. In alternativa, puoi raggruppare temporaneamente la dashboard per zona e poi 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 il cui sottotitolo è Monitoring.

  2. Espandi il menu Raggruppa per , quindi seleziona le etichette per il raggruppamento.
  3. Fai clic su Ok.

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

Creare un filtro temporaneo

Quando stai indagando su un incidente, è consigliabile esaminare 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 in modo da mostrare i dati che corrispondono al 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 per una zona specifica, crea un filtro in base all'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 il cui sottotitolo è Monitoring.

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

    Il menu elenca le etichette per tutte le serie temporali visualizzate 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 mostra zone: *.

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

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

Aggiungere filtri temporanei che corrispondono a una serie temporale

Per ulteriori informazioni su una serie temporale specifica visualizzata in un grafico, puoi utilizzare la legenda del grafico per applicare filtri temporanei. Puoi applicare filtri che corrispondono alle 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, prendi in considerazione una dashboard che visualizzi 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 di etichette più restrittivo, filtra in base a tutte le etichette. Con questa opzione, le etichette identificano una risorsa univoca e un insieme univoco di valori per le etichette della metrica.

Per applicare filtri temporanei che identificano una serie temporale specifica su 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 il cui 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 seleziona Filtra dashboard per 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

Lo screenshot seguente illustra il risultato:

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

Nella figura precedente, il grafico in cui è visualizzata 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 che più serie temporali in questo grafico facciano riferimento alla stessa istanza.

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 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 di byte letti dal disco.

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

Filtrare in base alle etichette delle risorse di una serie temporale

Quando filtri in base a tutte le etichette delle risorse, la dashboard può mostrare solo 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 ti interessano.

Per applicare filtri temporanei che identificano la risorsa per una serie temporale specifica visualizzata 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 il cui 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 seleziona Filtra 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 della risorsa, un'istanza VM:

Visualizzazione della dashboard di esempio con i 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 dashboard in base alle etichette delle risorse applica solo le etichette delle risorse alla barra dei filtri temporanea, il risultato è lo stesso se selezioni questa opzione da uno dei grafici.

Filtrare in base alle etichette delle metriche 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 solo a un protocollo specifico.

Per applicare filtri temporanei che identificano la metrica per una serie temporale specifica visualizzata 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 il cui 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 seleziona Filtra dashboard in base alle etichette delle metriche.

Ad esempio, quando questi passaggi vengono eseguiti nel 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.

Se i filtri temporanei includono solo filtri delle metriche, vengono visualizzate le serie temporali per quella metrica, indipendentemente dalla risorsa in base alla quale è stata scritta la serie temporale. Poiché non stai limitando le serie temporali a una risorsa specifica, potresti visualizzare più serie temporali in un grafico. Lo screenshot precedente illustra questo comportamento, dato che 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 in quel filtro.

Passaggi successivi