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à.
Trasformazioni
Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 8.x di Grafana.
Per le aree di lavoro Grafana che supportano la versione 10.x di Grafana, vedere. Funzionamento nella versione 10 di Grafana
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. Lavorare nella versione 9 di Grafana
Le trasformazioni elaborano il set di risultati prima che venga passato alla visualizzazione. Puoi accedere alle trasformazioni nella scheda Trasforma dell'editor di pannelli Amazon Managed Grafana.
Puoi utilizzare le trasformazioni per rinominare i campi, unire serie temporali separate, eseguire calcoli matematici tra query e altro ancora. Se disponi di dashboard di grandi dimensioni o di query complesse, la possibilità di riutilizzare i risultati delle query da un pannello all'altro può offrire un enorme miglioramento delle prestazioni.
Nota
Le trasformazioni a volte danno origine a dati che non possono essere rappresentati graficamente. Quando ciò accade, Amazon Managed Grafana mostra un suggerimento sulla visualizzazione. Scegli il suggerimento per passare alla visualizzazione delle tabelle. Questo spesso ti aiuta a capire meglio cosa sta facendo la trasformazione ai tuoi dati.
Amazon Managed Grafana applica le trasformazioni nella sequenza in cui sono elencate sullo schermo. Ogni trasformazione crea un nuovo set di risultati che viene passato alla trasformazione successiva nella pipeline.
L'ordine può fare un'enorme differenza nell'aspetto dei risultati. Ad esempio, se si utilizza la riduzione della trasformazione per condensare tutti i risultati di una colonna in un unico valore, è possibile applicare le trasformazioni solo a quel singolo valore.
Prerequisiti
Prima di applicare le trasformazioni, devono essere soddisfatte tutte le seguenti condizioni:
-
Hai inserito una query e restituito dati da una fonte di dati. Per ulteriori informazioni sulle interrogazioni, vedere Interrogazioni.
-
È stata applicata una visualizzazione che supporta le query, ad esempio una delle seguenti visualizzazioni:
-
Indicatore a barra
-
Gauge
-
Grafico
-
Mappa termica
-
Log
-
Stat
-
Tabella
-
Applicare una trasformazione
Le trasformazioni sono disponibili nella scheda Trasforma nel riquadro inferiore dell'editor del pannello, accanto alla scheda Interrogazioni.
Per applicare una trasformazione
-
Nel pannello a cui desiderate aggiungere le trasformazioni, scegliete il titolo del pannello, quindi scegliete Modifica.
-
Seleziona la scheda Transform (Trasformazione).
-
Seleziona una trasformazione.
Nella riga di trasformazione che appare, puoi configurare le opzioni di trasformazione.
-
Per applicare un'altra trasformazione, scegli Aggiungi trasformazione. Tieni presente che la trasformazione successiva agisce sul set di risultati restituito dalla trasformazione precedente.
In caso di problemi, scegliete l'icona del bug per eseguire il debug delle trasformazioni.
Per rimuovere una trasformazione, scegli l'icona del cestino.
Tipi e opzioni di trasformazione
Le aree di lavoro Grafana includono le seguenti trasformazioni.
Argomenti
Ridurre
Applica una trasformazione Reduce quando desideri semplificare i risultati fino a ridurli a un unico valore. Reduce rimuove fondamentalmente la componente temporale. Se visualizzato come tabella, riduce una colonna a una riga (valore).
Nel campo Calcoli, inserisci uno o più tipi di calcolo. Scegli di visualizzare un elenco di scelte di calcolo. Per informazioni sui calcoli disponibili, vedereElenco dei calcoli.
Dopo aver selezionato almeno un calcolo, Amazon Managed Grafana visualizza un valore utilizzando il calcolo selezionato. Se selezioni più di un calcolo, viene visualizzato più di un valore.
Unione
Utilizzate questa trasformazione per combinare i risultati 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 possono essere uniti se i campi condivisi contengono gli stessi dati.
Nell'esempio seguente, due query restituiscono i dati della tabella. I dati vengono visualizzati come due tabelle separate prima di applicare la trasformazione.
Interrogazione A
Orario | Processo | Operatività |
---|---|---|
2020-07-07 11:34:20 | nodo | 25260122 |
2020-07-07 11:24:20 | locandina | 123001233 |
Interrogazione B
Orario | Processo | Errori |
---|---|---|
2020-07-07 11:34:20 | nodo | 15 |
2020-07-07 11:24:20 | locandina | 5 |
Ecco il risultato dopo aver applicato la trasformazione Merge.
Orario | Processo | Errori | Uptime |
---|---|---|---|
2020-07-07 11:34:20 | nodo | 15 | 25260122 |
2020-07-07 11:24:20 | locandina | 5 | 123001233 |
Filtra per nome
Utilizzate questa trasformazione per rimuovere parti dei risultati della query.
Amazon Managed Grafana visualizza il campo Identifier, seguito dai campi restituiti dalla tua query.
Puoi applicare i filtri in due modi:
-
Immettere un'espressione regex.
-
Scegli un campo per attivare il filtro su quel campo. I campi filtrati vengono visualizzati con testo grigio scuro, i campi non filtrati hanno testo bianco.
Filtra i dati per query
Utilizzate questa trasformazione nei pannelli che hanno più interrogazioni, se volete nascondere una o più interrogazioni.
Amazon Managed Grafana visualizza le lettere identificative della query in testo grigio scuro. Per attivare il filtro, scegli un identificatore di query. Se la lettera di interrogazione è bianca, vengono visualizzati i risultati. Se la lettera di interrogazione è scura, i risultati sono nascosti.
Organizza i campi
Utilizzate questa trasformazione per rinominare, riordinare o nascondere i campi restituiti dalla query.
Nota
Questa trasformazione funziona solo nei pannelli che hanno una sola interrogazione. Se il pannello ha più interrogazioni, è necessario applicare una trasformazione Join by field (outer join) o rimuovere le interrogazioni aggiuntive.
Amazon Managed Grafana visualizza un elenco di campi restituiti dalla query. Puoi apportare una delle seguenti modifiche:
-
Modifica l'ordine dei campi facendo una pausa su un campo. Il cursore si trasforma in una mano, quindi puoi trascinare il campo nella nuova posizione.
-
Nascondi o mostra un campo scegliendo l'icona a forma di occhio accanto al nome del campo.
-
Rinomina i campi digitando un nuovo nome nella casella Rinomina.
Unisci per campo (outer join)
Usa questa trasformazione per unire più serie temporali a partire da un risultato impostato per campo.
Questa trasformazione è utile se desideri combinare le interrogazioni in modo da poter calcolare i risultati dei campi.
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.
-
Modalità: seleziona una modalità:
-
Riduci riga: applica il calcolo selezionato su ogni riga di campi selezionati in modo indipendente.
-
Opzione binaria: applica un'operazione matematica di base (
sum
multiply
, e così via) sui valori in una singola riga da due campi selezionati.
-
-
Nome campo: seleziona i nomi dei campi che desideri utilizzare nel calcolo per il nuovo campo.
-
Calcolo: seleziona un calcolo da utilizzare quando Amazon Managed Grafana crea il nuovo campo. Scegli il campo per visualizzare un elenco di opzioni di calcolo. Per informazioni sui calcoli disponibili, vedereElenco dei calcoli.
-
Alias: (Facoltativo) Inserisci il nome del nuovo campo. Se lasci questo campo vuoto, al campo verrà assegnato un nome corrispondente al calcolo.
-
Sostituisci tutti i campi: (Facoltativo) Utilizza questa opzione se desideri nascondere tutti gli altri campi e visualizzare solo il campo calcolato nella visualizzazione.
Etichette per i campi
Nota
Per applicare questa trasformazione, la tua query deve restituire campi etichettati.
Quando selezioni questa trasformazione, Amazon Managed Grafana trasforma automaticamente tutti i dati etichettati in campi.
Ad esempio, considera il risultato di una query di due serie temporali.
1: etichette Server=Server A, Datacenter=EU 2: etichette Server=Server B, datacenter=EU
Questa trasformazione risulterebbe nella tabella seguente.
Orario | Server | Datacenter | Valore |
---|---|---|---|
2020-07-07 11:34:20 | Server A | UE | 1 |
2020-07-07 11:34:20 | Server B | UE | 2 |
Nome del campo Valore; Se hai selezionato Server
come nome del campo Valore, otterrai un campo per ogni valore dell'Server
etichetta.
Orario | Datacenter | Server A | Server B |
---|---|---|---|
2020-07-07 11:34:20 | UE | 1 | 2 |
Raggruppa per
Questa trasformazione ordina ogni frame in base al campo configurato. Quando reverse
è selezionata, i valori vengono restituiti nell'ordine inverso.
Raggruppa per
Questa trasformazione raggruppa i dati in base a un valore di campo (colonna) specificato ed elabora i calcoli su ciascun gruppo. I calcoli disponibili sono gli stessi della trasformazione Reduce.
Ecco un esempio di dati originali.
Orario | ID del server | Temperatura della CPU | Stato del server |
---|---|---|---|
2020-07-07 11:34:20 | server 1 | 80 | Arresto |
2020-07-07 11:34:20 | server 3 | 62 | OK |
2020-07-07 10:32:20 | server 2 | 90 | Sovraccarico |
2020-07-07 10:31:22 | server 3 | 55 | OK |
2020-07-07 09:30:57 | server 3 | 62 | Reebooting (Riavvio in corso) |
2020-07-07 09:30:05 | server 2 | 88 | OK |
2020-07-07 09:28:06 | server 1 | 80 | OK |
2020-07-07 09:25:05 | server 2 | 88 | OK |
2020-07-07 09:23:07 | server 1 | 86 | OK |
Questa trasformazione avviene in due fasi. Innanzitutto, specifichi 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 raggruppi per Server ID
campo, i dati verranno raggruppati in questo modo:
Orario | ID del server | Temperatura della CPU | Stato del server |
---|---|---|---|
2020-07-07 11:34:20 | server 1 | 80 | Arresto |
2020-07-07 09:28:06 | server 1 | 80 | OK |
2020-07-07 09:23:07 | server 1 | 86 | OK |
2020-07-07 10:32:20 | server 2 | 90 | Overload 2020-07-07 09:30:05 | server 2 | 88 | OK 2020-07-07 09:25:05 | server 2 | 88 | OK 2020-07-07 11:34:20 | server 3 | 62 | OK 2020-07-07 10:31:22 | server 3 | 55 | OK 2020-07-07 09:30:57 | server 3 | 62 | Rebooting
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 il calcolo verrà applicato a ciascun gruppo di righe. Ad esempio, potresti voler calcolare la media CPU
temperature
per ciascuno di questi server. Puoi aggiungere il calcolo della media applicato al CPU
Temperature
campo per ottenere quanto segue.
ID del server | Temperatura della CPU (media) |
---|---|
server 1 | 82 |
server 2 | 8.6 |
server 3 | 59,6 |
E puoi aggiungere più di uno di questi calcoli. Ad esempio, puoi utilizzare i seguenti calcoli.
-
Per il campo
Time
, puoi calcolare l'ultimo valore, per sapere quando è stato ricevuto l'ultimo punto dati per ogni server. -
Per il campo
Server Status
, puoi calcolare l'ultimo valore per conoscere l'ultimo valore di stato per ogni server. -
Per il campo
Temperature
, puoi anche calcolare l'ultimo valore per conoscere l'ultima temperatura monitorata per ogni server.
La trasformazione Group By produce i seguenti risultati.
ID del server | Temperatura della CPU (media) | Temperatura della CPU (ultima) | Ora (ultima) | Stato del server (ultimo) |
---|---|---|---|---|
server 1 | 82 | 80 | 2020-07-07 11:34:20 | Arresto |
server 2 | 8.6 | 90 | 2020-07-07 10:32:20 | Sovraccarico |
server 3 | 59,6 | 62 | 2020-07-07 11:34:20 | OK |
Usando questa trasformazione, puoi estrarre alcune informazioni chiave dalle tue serie temporali e visualizzarle in modo conveniente.
Da serie a righe
Usa questa trasformazione per combinare i risultati di più query 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
, eValue
. La Metric
colonna viene aggiunta in modo da poter vedere da quale query proviene la metrica. Personalizza questo valore definendolo nella Label
query di origine.
Nell'esempio seguente, due query restituiscono dati di serie temporali. Viene visualizzato come due tabelle separate prima dell'applicazione della trasformazione.
Interrogazione A
Orario | Temperatura |
---|---|
2020-07-07 11:34:20 | 25 |
2020-07-07 10:31:22 | 22 |
2020-07-07 09:30:05 | 19 |
Interrogazione B
Orario | Umidità |
---|---|
2020-07-07 11:34:20 | 24 |
2020-07-07 10:32:20 | 29 |
2020-07-07 09:30:57 | 33 |
L'applicazione della trasformazione produce i seguenti risultati. Series to rows
Orario | Parametro | Valore |
---|---|---|
2020-07-07 11:34:20 | Temperatura | 25 |
2020-07-07 11:34:20 | Umidità | 22 |
2020-07-07 10:32:20 | Umidità | 29 |
2020-07-07 10:31:22 | Temperatura | 22 |
2020-07-07 09:30:57 | Umidità | 33 |
2020-07-07 09:30:05 | Temperatura | 19 |
Filtra i dati per valore
Questa trasformazione consente di filtrare i dati direttamente nell'area di lavoro 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 seguenti:
-
Regex: corrisponde a un'espressione regex.
-
Is Null: corrisponde se il valore è nullo.
-
Is Not Null: corrisponde se il valore non è nullo.
-
Uguale: corrisponde se il valore è uguale al valore specificato.
-
Diverso: corrisponde se il valore è diverso dal valore specificato.
Le condizioni disponibili per i campi numerici sono le seguenti:
-
Maggiore: corrisponde se il valore è maggiore del valore specificato.
-
Inferiore: corrisponde se il valore è inferiore al valore specificato.
-
Maggiore o uguale: corrisponde se il valore è maggiore o uguale al valore specificato.
-
Minore o uguale: corrisponde se il valore è inferiore o uguale al valore specificato.
-
Intervallo: corrisponde a un intervallo compreso tra un minimo e un massimo specificati. Il minimo e il massimo sono inclusi nell'intervallo.
È possibile aggiungere più di una condizione al filtro. Quando hai più di una condizione, puoi scegliere se desideri che l'azione di inclusione o esclusione venga applicata alle righe che soddisfano tutte o alcune delle condizioni che hai aggiunto.
Le condizioni non valide o configurate in modo incompleto vengono ignorate.
Trasformazioni di debug
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.
Amazon Managed Grafana mostra la vista di debug della trasformazione sotto la riga di trasformazione.