Configurazione delle legende

Questo documento descrive come utilizzare le leggende dei grafici. La legenda ha l'aspetto di una tabella posizionata accanto al grafico. Per impostazione predefinita, la legenda di una dashboard è configurata per mostrare solo i punti colorati che corrispondono alle linee nel grafico. Lo screenshot seguente mostra un grafico in una dashboard con la legenda predefinita:

Per i grafici nelle dashboard, puoi anche espandere la legenda per visualizzare ulteriori dettagli, come colonne di dati configurabili e una colonna Valore. La colonna Valore visualizza i valori della metrica rappresentata nel grafico, mentre le altre colonne mostrano i valori delle metriche o delle etichette delle risorse scelte. La barra tratteggiata sul grafico indica il momento in cui vengono visualizzati i valori.

Per accedere alle dashboard specifiche per le risorse o per applicare filtri temporanei a una dashboard, utilizza il menu more_vert Azioni per questa serie temporale in una legenda espansa.

Mostrare e nascondere le leggende

Le legende dei grafici che mostrano più tipi di metriche possono essere difficili da interpretare. Per impostazione predefinita, le colonne della legenda vengono selezionate dalle etichette delle metriche e delle risorse per il tipo di metrica del grafico. Quando un grafico ha più tipi di metriche, una colonna della legenda specifica potrebbe non essere significativa per una serie temporale specifica.

• Esempio: un grafico mostra il numero di byte scritti e il numero di byte letti dalle istanze di macchine virtuali (VM). Supponiamo che i dati relativi ai byte letti siano filtrati in base alla zona us-central1-a. La legenda include una colonna zone e i valori in quella colonna potrebbero essere diversi da us-central1-a. Il motivo è che il tipo di metrica Bytes scritti contiene un'etichetta zone e i dati della metrica non sono stati filtrati per zona.

• Esempio: un grafico mostra il numero di byte scritti nelle istanze VM e l'utilizzo della CPU per queste istanze. La legenda contiene colonne per il tipo di disco e il tipo di archiviazione. Tuttavia, i valori di queste etichette sono vuoti per i campi della legenda del tempo. Il motivo è che il tipo di metrica Utilizzo CPU non supporta queste etichette.

Seleziona le colonne della legenda

Per modificare le colonne visualizzate nella legenda, espandi la legenda, quindi fai clic su view_column Colonne legenda. Se fai clic sul pulsante, viene visualizzato un pannello di configurazione. Questo riquadro elenca le etichette delle metriche e delle risorse disponibili per la visualizzazione come colonne. Le caselle di controllo delle colonne obbligatorie sono disattivate. Lo screenshot seguente mostra il pulsante Colonne e il riquadro di configurazione per una determinata legenda:

Quando il grafico viene creato per la prima volta, il sistema sceglie in modo euristico un insieme di etichette da mostrare per impostazione predefinita. Puoi selezionare o cancellare le colonne etichettate. Le voci per le colonne obbligatorie, in genere Valore, sono disattivate e non possono essere cancellate. Quando modifichi la configurazione, devi avere selezionato almeno una metrica o un'etichetta della risorsa.

La legenda mostra una barra di scorrimento quando sono presenti molte colonne e la legenda viene suddivisa in pagine quando sono presenti molte righe. Lo screenshot seguente mostra una legenda con una barra di scorrimento e frecce per la navigazione tra le pagine:

Ordinare le righe della legenda

Puoi ordinare le righe della legenda in base a una qualsiasi delle colonne. Le righe possono essere ordinate in ordine crescente o decrescente. Per ordinare una riga, fai clic sull'intestazione. Nella colonna ordinata più di recente viene visualizzata una freccia che indica l'ordinamento. Lo screenshot seguente mostra una legenda ordinata per zona in ordine decrescente:

Informazioni sulle leggende in modalità "Confronta con i dati precedenti"

Quando utilizzi la modalità Confronta con i dati precedenti in un grafico, la legenda viene modificata in modo da includere una seconda colonna "Valori". La colonna Valore corrente diventa Oggi e la colonna dei valori passati viene denominata in modo appropriato, ad esempio Settimana scorsa. Lo screenshot seguente mostra una legenda per una tabella che confronta i dati attuali con quelli dell'ultima ora:

Configurare il nome di una colonna della legenda

Il campo Alias legenda consente di personalizzare una descrizione per la serie temporale nel grafico. Queste descrizioni vengono visualizzate nella descrizione comando per il grafico e nella legenda del grafico nella colonna Nome. Per impostazione predefinita, le descrizioni nella legenda vengono create automaticamente a partire dai valori di etichette diverse nella serie temporale. Poiché è il sistema a selezionare le etichette, i risultati potrebbero non essere utili. Per creare un modello per le descrizioni, utilizza questo campo.

Puoi inserire testo normale e modelli nel campo Legend Alias (Alias legenda). Quando aggiungi un modello, aggiungi un'espressione che viene valutata quando viene visualizzata la legenda.

Per aggiungere un modello di legenda a un grafico:

1. Nel riquadro Visualizzazione, espandi expand_more Alias legenda.
2. Fai clic su add Mostra suggerimenti sulle variabili del modello e seleziona una voce dal menu. Ad esempio, se selezioni zone, viene aggiunto il modello ${resource.labels.zone}.

Ad esempio, lo screenshot seguente mostra un modello di legenda contenente testo normale e l'espressione ${resource.labels.zone}:

Nella legenda del grafico, i valori generati dal modello vengono visualizzati in una colonna con l'intestazione Nome e nella descrizione comando:

Puoi configurare il modello della legenda in modo da includere più stringhe di testo e modelli. Tuttavia, lo spazio di visualizzazione disponibile nella descrizione comando è limitato.

Accedere alle dashboard specifiche per risorsa