Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Trasforma i dati

Le trasformazioni sono un modo efficace per manipolare i dati restituiti da una query prima che il sistema applichi una visualizzazione. Utilizzando le trasformazioni, è possibile:

Per gli utenti che si affidano a più visualizzazioni dello stesso set di dati, le trasformazioni offrono un metodo efficiente per creare e gestire numerose dashboard.

È inoltre possibile utilizzare l'output di una trasformazione come input per un'altra trasformazione, il che si traduce in un aumento delle prestazioni.

Tipi di trasformazione

Grafana offre diversi modi per trasformare i dati. Di seguito è riportato un elenco completo delle funzioni di trasformazione.

Ordine delle trasformazioni

Quando sono presenti più trasformazioni, Grafana le applica nell'ordine in cui sono elencate. Ogni trasformazione crea un set di risultati che poi passa alla trasformazione successiva nella pipeline di elaborazione.

L'ordine in cui Grafana applica le trasformazioni influisce direttamente sui risultati. Ad esempio, se utilizzi una trasformazione Reduce per condensare tutti i risultati di una colonna in un unico valore, puoi applicare le trasformazioni solo a quel singolo valore.

Aggiungi una funzione di trasformazione ai dati

I seguenti passaggi ti guidano nell'aggiunta di una trasformazione ai dati.

Esegui il debug di una trasformazione

Per visualizzare i set di risultati in ingresso e in uscita della trasformazione, scegliete l'icona del bug sul lato destro della riga di trasformazione.

I set di risultati di input e output possono aiutarti a eseguire il debug di una trasformazione.

Eliminare una trasformazione

Ti consigliamo di rimuovere le trasformazioni che non ti servono. Quando elimini una trasformazione, rimuovi i dati dalla visualizzazione.

Prerequisiti:

Identifica tutte le dashboard che si basano sulla trasformazione e informa gli utenti della dashboard interessati.

Funzioni di trasformazione

È possibile eseguire le seguenti trasformazioni sui dati.

Aggiungi campo dal calcolo

Usa questa trasformazione per aggiungere un nuovo campo calcolato da altri due campi. Ogni trasformazione consente di aggiungere un nuovo campo.

Concatena i campi

Questa trasformazione combina tutti i campi di tutti i frame in un unico risultato. Considerate queste due domande.

Interrogazione A:

Interrogazione B:

Dopo aver concatenato i campi, il frame di dati sarebbe:

Config dai risultati della query

Questa trasformazione consente di selezionare una query e da essa estrarre opzioni standard come Min, Max, Unit e Thresholds e applicarle ad altri risultati della query. Ciò consente una configurazione dinamica della visualizzazione basata sulle query.

Se desideri estrarre una configurazione unica per ogni riga del risultato della query di configurazione, prova la trasformazione da righe a campi.

Opzioni

Converti il tipo di campo

Questa trasformazione modifica il tipo di campo del campo specificato.

Ad esempio, è possibile modificare la seguente query selezionando il campo orario come Ora e il formato della data come YYYY.

Il risultato:

Filtra i dati per nome

Utilizzate questa trasformazione per rimuovere parti dei risultati della query.

Grafana visualizza il campo Identificatore, seguito dai campi restituiti dalla query.

Puoi applicare i filtri in due modi:

Filtra i dati per query

Utilizzate questa trasformazione nei pannelli che hanno più interrogazioni, se volete nascondere una o più interrogazioni.

Grafana visualizza le lettere di identificazione della query in testo grigio scuro. Fai clic su un identificatore di query per attivare il filtro. Se la lettera di interrogazione è bianca, vengono visualizzati i risultati. Se la lettera di interrogazione è scura, i risultati vengono nascosti.

Filtra i dati per valore

Questa trasformazione consente di filtrare i dati direttamente in Grafana e rimuovere alcuni punti dati dai risultati della query. Hai la possibilità di includere o escludere i dati che soddisfano una o più condizioni da te definite. Le condizioni vengono applicate a un campo selezionato.

Questa trasformazione è utile se l'origine dati non filtra nativamente in base ai valori. È inoltre possibile utilizzarla per restringere i valori da visualizzare se si utilizza una query condivisa.

Le condizioni disponibili per tutti i campi sono:

Le condizioni disponibili per i campi numerici sono:

Considerate il seguente set di dati:

Se includi i punti dati con una temperatura inferiore a 30°C, la configurazione sarà la seguente:

E otterrete il seguente risultato, in cui sono incluse solo le temperature inferiori a 30°C:

Puoi aggiungere più di una condizione al filtro. Ad esempio, potresti voler includere i dati solo se l'altitudine è maggiore di 100. A tale scopo, aggiungi tale condizione alla seguente configurazione:

Quando hai più di una condizione, puoi scegliere se desideri che l'azione (includi/escludi) venga applicata alle righe che soddisfano tutte le condizioni o soddisfano una delle condizioni che hai aggiunto.

Nell'esempio precedente abbiamo scelto Abbina tutto perché volevamo includere le righe che hanno una temperatura inferiore a 30 E un'altitudine superiore a 100. Se volessimo invece includere le righe che hanno una temperatura inferiore a 30 O un'altitudine superiore a 100, selezioneremmo Match any. Ciò includerebbe la prima riga dei dati originali, che ha una temperatura di 32°C (non corrisponde alla prima condizione) ma un'altitudine di 101 (che corrisponde alla seconda condizione), quindi è inclusa.

Le condizioni non valide o configurate in modo incompleto vengono ignorate.

Gruppo da

Questa trasformazione raggruppa i dati in base a un valore di campo (colonna) specificato ed elabora i calcoli su ciascun gruppo. Fai clic per visualizzare un elenco di scelte di calcolo.

Ecco un esempio di dati originali.

Questa trasformazione avviene in due fasi. Per prima cosa specificate uno o più campi in base ai quali raggruppare i dati. In questo modo verranno raggruppati tutti gli stessi valori di quei campi, come se li avessi ordinati. Ad esempio, se raggruppiamo i dati in base al campo Server ID, i dati verranno raggruppati in questo modo:

Tutte le righe con lo stesso valore di Server ID vengono raggruppate.

Dopo aver scelto il campo in base al quale raggruppare i dati, puoi aggiungere vari calcoli sugli altri campi e applicare il calcolo a ciascun gruppo di righe. Ad esempio, potremmo voler calcolare la temperatura media della CPU per ciascuno di questi server. Quindi possiamo aggiungere il calcolo medio applicato al campo della temperatura della CPU per ottenere quanto segue:

E possiamo aggiungere più di un calcolo. Per esempio:

Otterremmo quindi:

Questa trasformazione consente di estrarre le informazioni chiave dalle serie temporali e di visualizzarle in modo conveniente.

Partecipa per campo

Usa questa trasformazione per unire più risultati in un'unica tabella. Ciò è particolarmente utile per convertire i risultati di più serie temporali in un'unica tabella ampia con un campo temporale condiviso.

Connessione interna

Un inner join unisce i dati di più tabelle in cui tutte le tabelle condividono lo stesso valore del campo selezionato. Questo tipo di join esclude i dati in cui i valori non corrispondono in tutti i risultati.

Utilizzate questa trasformazione per combinare i risultati di più query (combinati su un campo di join passato o sulla prima colonna time) in un unico risultato e rilasciate le righe in cui un'unione non può avvenire con successo.

Nell'esempio seguente, due query restituiscono i dati della tabella. Viene visualizzato come due tabelle separate prima di applicare la trasformazione Inner Join.

Interrogazione A:

Interrogazione B:

Il risultato dopo l'applicazione della trasformazione inner join è simile al seguente:

Connessione esterna

Un outer join include tutti i dati di un inner join e le righe in cui i valori non corrispondono in tutti gli input. Mentre l'inner join unisce la Query A e la Query B nel campo temporale, l'outer join include tutte le righe che non corrispondono nel campo time.

Nell'esempio seguente, due query restituiscono i dati della tabella. Viene visualizzato come due tabelle prima di applicare la trasformazione outer join.

Interrogazione A:

Interrogazione B:

Il risultato dopo l'applicazione della trasformazione outer join è simile al seguente:

Etichette per i campi

Questa trasformazione modifica i risultati delle serie temporali che includono etichette o tag in una tabella in cui le chiavi e i valori di ogni etichetta sono inclusi nel risultato della tabella. Le etichette possono essere visualizzate come colonne o come valori di riga.

Dato il risultato di una query di due serie temporali:

In modalità Columns, il risultato è simile al seguente:

In modalità «Righe», il risultato ha una tabella per ogni serie e mostra il valore di ogni etichetta in questo modo:

Nome del campo Valore

Se hai selezionato Server come nome del campo Valore, otterrai un campo per ogni valore dell'etichetta Server.

Comportamento di fusione

Il trasformatore delle etichette per i campi è composto internamente da due trasformazioni separate. Il primo agisce su una singola serie ed estrae le etichette nei campi. La seconda è la trasformazione di fusione che unisce tutti i risultati in un'unica tabella. La trasformazione di unione tenta di unire tutti i campi corrispondenti. Questa fase di unione è obbligatoria e non può essere disattivata.

Per illustrare ciò, ecco un esempio in cui sono presenti due query che restituiscono serie temporali senza etichette sovrapposte.

Ciò risulterà innanzitutto in queste due tabelle:

Dopo l'unione:

Unione

Utilizzate questa trasformazione per combinare il risultato di più interrogazioni in un unico risultato. Ciò è utile quando si utilizza la visualizzazione del pannello tabellare. I valori che possono essere uniti vengono combinati nella stessa riga. I valori sono unibili se i campi condivisi contengono gli stessi dati.

Nell'esempio seguente, abbiamo due query che restituiscono i dati della tabella. Viene visualizzato come due tabelle separate prima di applicare la trasformazione.

Interrogazione A:

Interrogazione B:

Ecco il risultato dopo aver applicato la trasformazione Merge:

Organizza i campi

Utilizzate questa trasformazione per rinominare, riordinare o nascondere i campi restituiti dalla query.

Grafana mostra un elenco di campi restituiti dalla query. È possibile:

Partizione per valori

Questa trasformazione può aiutare a eliminare la necessità di più query sulla stessa origine dati con WHERE clausole diverse quando si rappresentano graficamente più serie. Prendi in considerazione una tabella SQL di metriche con i seguenti dati:

Prima della versione 9.3, se volevi tracciare una linea di tendenza rossa per gli Stati Uniti e una blu per l'UE nello stesso TimeSeries pannello, probabilmente dovevi suddividerla in due domande:

SELECT Time, Value FROM metrics WHERE Time > '2022-10-20' AND Region='US'
SELECT Time, Value FROM metrics WHERE Time > '2022-10-20' AND Region='EU'

Ciò richiede anche che tu sappia in anticipo quali regioni esistono effettivamente nella tabella delle metriche.

Con il trasformatore Partition by values, ora puoi emettere una singola query e dividere i risultati per valori univoci in una o più colonne (fields) a tua scelta. Nell'esempio seguente viene utilizzato Region.

SELECT Time, Region, Value FROM metrics WHERE Time > '2022-10-20'

Ridurre

La trasformazione Reduce applica un calcolo a ogni campo del frame e restituisce un singolo valore. I campi relativi all'ora vengono rimossi quando si applica questa trasformazione.

Considerate l'input:

Interrogazione A:

Interrogazione B:

Il trasformatore di riduzione ha due modalità:

Ad esempio, se hai utilizzato il primo e l'ultimo calcolo con una trasformazione da serie a righe, il risultato sarebbe:

I campi Riduci con l'ultimo calcolo restituiscono due frame, ciascuno con una riga:

Interrogazione A:

Interrogazione B:

Rinomina tramite regex

Utilizzate questa trasformazione per rinominare parti dei risultati della query utilizzando un'espressione regolare e un pattern sostitutivo.

È possibile specificare un'espressione regolare, che viene applicata solo alle corrispondenze, insieme a un pattern sostitutivo che supporti i riferimenti a ritroso. Ad esempio, immaginiamo di visualizzare l'utilizzo della CPU per host e di voler rimuovere il nome di dominio. È possibile impostare l'espressione regolare su ([^\.]+)\..+ e il pattern sostitutivo su$1, web-01.example.com diventerebbe. web-01

Da righe a campi

La trasformazione da righe a campi converte le righe in campi separati. Ciò può essere utile in quanto i campi possono essere modificati e configurati individualmente. Può anche utilizzare campi aggiuntivi come fonti per la configurazione dinamica dei campi o mapparli alle etichette dei campi. Le etichette aggiuntive possono quindi essere utilizzate per definire nomi di visualizzazione migliori per i campi risultanti.

Questa trasformazione include una tabella di campi che elenca tutti i campi nei dati restituiti dalla query di configurazione. Questa tabella consente di controllare quale campo deve essere mappato a ciascuna proprietà di configurazione (l'opzione*Usa come**). Puoi anche scegliere quale valore selezionare se ci sono più righe nei dati restituiti.

Questa trasformazione richiede:

Utile per visualizzare i dati in:

Associa campi aggiuntivi alle etichette

Se un campo non è mappato alla proprietà di configurazione, Grafana lo utilizzerà automaticamente come sorgente per un'etichetta sul campo di output-

Esempio:

Output:

Le etichette aggiuntive possono ora essere utilizzate nel campo Nome visualizzato per fornire nomi di campo più completi.

Se vuoi estrarre la configurazione da una query e applicarla a un'altra, dovresti usare la configurazione dalla trasformazione dei risultati della query.

Esempio

Input:

Output:

Come puoi vedere, ogni riga dei dati di origine diventa un campo separato. Ogni campo ora ha anche un set di opzioni di configurazione massimo. Opzioni come Min, Max, Unit e Thresholds fanno tutte parte della configurazione del campo e, se impostate in questo modo, verranno utilizzate dalla visualizzazione al posto delle opzioni configurate manualmente nel riquadro delle opzioni dell'editor del pannello.

Prepara le serie temporali

La preparazione della trasformazione delle serie temporali è utile quando un'origine dati restituisce dati di serie temporali in un formato non supportato dal pannello che si desidera utilizzare.

Questa trasformazione consente di risolvere questo problema convertendo i dati delle serie temporali dal formato ampio al formato lungo o viceversa.

Seleziona l'opzione Serie temporale a più fotogrammi per trasformare l'intervallo di dati delle serie temporali dal formato ampio a quello lungo.

Seleziona l'opzione Wide time series per trasformare il frame di dati delle serie temporali dal formato lungo a quello ampio.

Da serie a righe

Utilizzate questa trasformazione per combinare il risultato di più interrogazioni di dati su serie temporali in un unico risultato. Ciò è utile quando si utilizza la visualizzazione del pannello tabellare.

Il risultato di questa trasformazione conterrà tre colonne: Time, Metric e Value. La colonna Metrica viene aggiunta in modo da poter vedere facilmente da quale query proviene la metrica. Personalizza questo valore definendo Label nella query di origine.

Nell'esempio seguente, abbiamo due query che restituiscono dati di serie temporali. Viene visualizzato come due tabelle separate prima di applicare la trasformazione.

Interrogazione A:

Interrogazione B:

Ecco il risultato dopo aver applicato la trasformazione Series to rows.

Ordina per

Questa trasformazione ordinerà ogni frame in base al campo configurato. Quando reverse è selezionata, i valori verranno restituiti nell'ordine inverso.

Limite

Utilizzate questa trasformazione per limitare il numero di righe visualizzate.

Nell'esempio seguente, abbiamo la seguente risposta dalla fonte di dati:

Ecco il risultato dopo aver aggiunto una trasformazione Limit con un valore di '3':