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 macchina virtuale (VM) specifica, aggiungi un filtro temporaneo.

I filtri e i raggruppamenti temporanei vengono eliminati automaticamente quando ricarichi la pagina; tuttavia, puoi eliminarli anche 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 configurazione del widget:

• Per i widget che visualizzano dati delle serie temporali, ad esempio i grafici a linee, vengono applicate 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 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 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 delle risorse 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 visualizzano una serie temporale per ogni insieme di serie temporali con gli stessi valori per le etichette di raggruppamento. Per impostazione predefinita, viene visualizzata la media di ogni insieme. Tuttavia, quando il widget definisce una funzione di raggruppamento, viene utilizzata tale funzione.

Supponiamo, ad esempio, che la tua dashboard contenga un grafico che mostra l'utilizzo della CPU da parte delle tue 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, raggruppa temporaneamente la dashboard per zona, quindi visualizza il grafico sull'utilizzo della CPU.

Per creare o modificare i raggruppamenti temporanei:

1. Nel pannello di navigazione della console Google Cloud, seleziona Monitoring, quindi seleziona  Dashboard:

   Vai a Dashboard

2. Espandi il menu Raggruppa per e poi 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 indaghi su un incidente, ti consigliamo di 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 per mostrare i dati che corrispondono al filtro. Ad esempio, per configurare tutti i grafici in modo che mostrino solo le serie temporali per un'istanza VM specifica, 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 in base all'etichetta zone.

Per creare un filtro temporaneo:

1. Nel pannello di navigazione della console Google Cloud, seleziona Monitoring, quindi seleziona  Dashboard:

   Vai a Dashboard

2. Nella barra dei filtri della dashboard, fai clic su Aggiungi filtro, poi 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 mostra zone: *.

3. Per selezionare un valore specifico da associare, fai clic sul filtro, ad esempio 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 che hai creato vengono eliminati.

Aggiungere filtri temporanei che corrispondono a una serie temporale

Se vuoi visualizzare in un grafico ulteriori informazioni su una serie temporale specifica, 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. Queste opzioni vengono descritte in questa sezione.

Dashboard di esempio

Per descrivere il comportamento delle diverse opzioni, puoi usare 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:

Filtrare in base a tutte le etichette di una serie temporale

Se vuoi applicare l'insieme 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, procedi nel seguente modo:

1. Nel pannello di navigazione della console Google Cloud, seleziona Monitoring, quindi seleziona  Dashboard:

   Vai a Dashboard

2. Identifica il grafico ed espandi la legenda per visualizzare maggiori 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, quindi seleziona Filtra dashboard in base a 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 della metrica: instance_name.

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

  • project_id
  • instance_id
  • zone

Il seguente screenshot illustra il risultato:

Nella figura precedente, il grafico che mostra la metrica CPU utilization mostra una singola serie temporale. Questo comportamento è dovuto all'aggiunta di 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, pertanto è 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

Come mostrato nello screenshot precedente, entrambi i grafici ora mostrano un'unica serie temporale.

Filtrare in base alle etichette delle risorse di una serie temporale

Quando filtri in base a tutte le etichette delle risorse, limiti la dashboard in modo da mostrare le serie temporali relative a una risorsa specifica. Ora puoi visualizzare le metriche solo per la risorsa in questione, 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 da un grafico:

1. Nel pannello di navigazione della console Google Cloud, seleziona Monitoring, quindi seleziona  Dashboard:

   Vai a Dashboard

2. Identifica il grafico ed espandi la legenda per visualizzare maggiori 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:

Come illustrato nello screenshot precedente, quando filtri per risorsa, un grafico potrebbe mostrare 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 per le etichette di una metrica. Ad esempio, quando esamini le metriche di bilanciamento del carico, potresti voler visualizzare le serie temporali relative a un protocollo specifico.

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

1. Nel pannello di navigazione della console Google Cloud, seleziona Monitoring, quindi seleziona  Dashboard:

   Vai a Dashboard

2. Identifica il grafico ed espandi la legenda per visualizzare maggiori 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 perché il valore dell'etichetta instance_name è configurabile. Ciò significa che 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 relative a tale 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 vedere più serie temporali su un grafico. Lo screenshot precedente illustra questo comportamento, poiché 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 corrispondenza del filtro in questione.

Passaggi successivi

• Esplorare i dati dei grafici
• Accedi a dashboard specifiche delle risorse
• Aggiungere filtri permanenti alle dashboard personalizzate