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à.
# Interroga e trasforma i dati
****
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.md)
Per le aree di lavoro Grafana che supportano la versione 8.x di Grafana, vedere. [Funzionamento in Grafana versione 8](using-grafana-v8.md)
Amazon Managed Grafana supporta molti tipi di fonti di [dati](AMG-data-sources.md). *Le interrogazioni sulle* fonti di dati restituiscono dati che Grafana *può* trasformare e visualizzare. Ogni fonte di dati utilizza il proprio linguaggio di interrogazione e i plug-in di origine dati implementano ciascuno un'interfaccia utente per la creazione di query chiamata editor di query.
**Topics**
+ [Informazioni sulle interrogazioni](#v10-panels-query-xform-about)
+ [Naviga nella scheda delle interrogazioni](#v10-panels-query-xform-navigate)
+ [Aggiungere una query](#v10-panels-query-xform-add)
+ [Gestisci le interrogazioni](#v10-panels-query-xform-manage)
+ [Opzioni di interrogazione](#v10-panels-query-xform-options)
+ [Scrivere interrogazioni sulle espressioni](v10-panels-query-xform-expressions.md)
+ [Condividi i risultati delle interrogazioni con un altro pannello](v10-panels-query-share.md)
+ [Trasformazione dei dati](v10-panels-xform.md)
+ [Risolvi i problemi relativi alle interrogazioni](v10-panels-query-troubleshoot.md)
+ [Tipi di calcolo](v10-panels-calculation-types.md)
## Informazioni sulle interrogazioni
I pannelli Grafana comunicano con le fonti di dati tramite query, che recuperano i dati per la visualizzazione. Una query è una domanda scritta nel linguaggio di interrogazione utilizzato dalla fonte di dati.
È possibile configurare la frequenza delle interrogazioni e i limiti di raccolta dei dati nelle opzioni di origine dati del pannello. Grafana supporta fino a 26 interrogazioni per pannello.
Puoi trovare ulteriori informazioni sul linguaggio di query di ciascuna fonte di dati nella sezione [Fonti dati](AMG-data-sources.md).
**Editor di query**
L'*editor di query* di ogni fonte di dati fornisce un'interfaccia utente personalizzata che consente di scrivere query che sfruttano le sue funzionalità uniche.
A causa delle differenze tra i linguaggi di interrogazione, ogni editor di query di sorgenti di dati ha un aspetto e un funzionamento diversi. A seconda della fonte di dati, l'editor di query potrebbe fornire funzionalità di completamento automatico, nomi di metriche, suggerimenti di variabili o un'interfaccia visiva per la creazione di query.
Per i dettagli sulle funzionalità esclusive dell'editor di query di una specifica origine dati, incluse informazioni sulle query e sulla sintassi, consulta la documentazione sull'origine dati:
+ Per le fonti di dati incluse in Amazon Managed Grafana, consulta Origini [dati integrate](AMG-data-sources-builtin.md).
+ Per le fonti di dati incluse in Grafana Enterprise, vedere. [Connect a fonti di dati aziendali](AMG-data-sources-enterprise.md)
+ Per altri plugin di sorgenti dati che si installano tramite il[Trova i plugin con il catalogo dei plugin](grafana-plugins.md#plugin-catalog), la documentazione è collegata all'elenco nel catalogo dei plugin.
**Sintassi delle query**
Le fonti di dati utilizzano diversi linguaggi di interrogazione per richiedere dati. Per i dettagli sul linguaggio di interrogazione unico di una fonte di dati specifica, consulta la relativa documentazione.
**Esempio di PostgreSQL:**
```
SELECT hostname FROM host WHERE region IN($region)
```
**Esempio PromQL:**
```
query_result(max_over_time([${__range_s}s]) != )
```
**Fonti di dati speciali**
**Grafana include anche tre fonti di dati speciali: **Grafana**, **Mixed** e Dashboard.** Per ulteriori informazioni, consulta [Connessione alle origini dati](AMG-data-sources.md).
## Naviga nella scheda delle interrogazioni
La scheda **Query** di un pannello è composta dai seguenti elementi:
+ **Selettore di origine dati**: seleziona l'origine dati da interrogare.
+ **Opzioni di interrogazione**: imposta i parametri massimi di recupero dei dati e gli intervalli di tempo di esecuzione delle query.
+ **Pulsante Query Inspector**: apre il pannello Query Inspector, in cui è possibile visualizzare e ottimizzare la query.
+ **Elenco dell'editor di query**: elenca le interrogazioni che hai scritto.
+ **Espressioni**: utilizza il generatore di espressioni per creare espressioni di avviso. Per ulteriori informazioni sulle espressioni, consulta [Scrivere interrogazioni sulle espressioni](v10-panels-query-xform-expressions.md).
## Aggiungere una query
Una query restituisce i dati che Grafana visualizza nei pannelli del dashboard. Quando crei un pannello, Grafana seleziona automaticamente l'origine dati predefinita.
**Per aggiungere una query**
1. Modifica il pannello a cui stai aggiungendo un'interrogazione.
1. Scegli la scheda **Queries** (Query).
1. Scegli il menu a discesa **Origine dati** e seleziona una fonte di dati.
1. Scegli **le opzioni di interrogazione** per configurare il numero massimo di punti dati necessari. Per ulteriori informazioni sulle opzioni di interrogazione, consulta[Opzioni di interrogazione](#v10-panels-query-xform-options).
1. Scrivere la query utilizzando l'editor di query.
1. Scegli **Applica**.
Grafana interroga la fonte di dati e visualizza i dati.
## Gestisci le interrogazioni
Grafana organizza le interrogazioni in righe di interrogazione comprimibili. Ogni riga di query contiene un editor di query ed è identificata da una lettera (A, B, C e così via).
Per gestire le query, è possibile copiare le interrogazioni, nasconderle, rimuoverle, riordinarle e attivare la guida dell'editor di query.
## Opzioni di interrogazione
Scegli **le opzioni di interrogazione** accanto al selettore dell'origine dati per visualizzare le impostazioni per l'origine dati selezionata. Le modifiche che apporti qui influiscono solo sulle interrogazioni effettuate in questo pannello.
Grafana imposta i valori predefiniti che vengono visualizzati nel testo grigio scuro. Le modifiche vengono visualizzate in testo bianco. Per riportare un campo all'impostazione predefinita, elimina il testo bianco dal campo.
Le opzioni di interrogazione delle fonti di dati del pannello includono:
+ **Numero massimo di punti dati**: se l'origine dati lo supporta, imposta il numero massimo di punti dati per ogni serie restituita. Se la query restituisce più punti dati rispetto all'impostazione del numero massimo di punti dati, l'origine dati riduce il numero di punti restituiti aggregandoli per media, max o un'altra funzione.
È possibile limitare il numero di punti per migliorare le prestazioni delle query o rendere più fluida la linea visualizzata. Il valore predefinito è la larghezza (o il numero di pixel) del grafico, poiché è possibile visualizzare solo il numero di punti dati disponibile nel pannello grafico.
Con lo streaming di dati, Grafana utilizza il valore massimo dei punti dati per il rolling buffer. Lo streaming è un flusso continuo di dati e il buffering divide il flusso in blocchi.
+ **Intervallo minimo**: imposta un limite minimo per l'intervallo calcolato automaticamente, che in genere è l'intervallo minimo di scrape. Se un punto dati viene salvato ogni 15 secondi, non trarrai vantaggio dall'avere un intervallo inferiore a quello. Puoi anche impostarlo su un valore minimo superiore all'intervallo di scrape per recuperare interrogazioni più dettagliate e ben funzionanti.
+ Intervallo: imposta un **intervallo** di tempo che è possibile utilizzare per aggregare o raggruppare i punti dati in base al tempo.
Grafana calcola automaticamente un intervallo appropriato che puoi utilizzare come variabile nelle query basate su modelli. La variabile viene misurata in secondi () o millisecondi ()`$__interval`. `$__interval_ms`
Gli intervalli vengono in genere utilizzati in funzioni di aggregazione come somma o media. Ad esempio, questa è una query Prometheus che utilizza la variabile interval:. `rate(http_requests_total[$__interval])`
Questo intervallo automatico viene calcolato in base alla larghezza del grafico. Man mano che l'utente rimpicciolisce una visualizzazione, l'intervallo aumenta, con conseguente aggregazione a grana più grossa. Allo stesso modo, se l'utente ingrandisce, l'intervallo diminuisce, ottenendo un'aggregazione più dettagliata.
Per ulteriori informazioni, consulta [Variabili globali](v10-dash-variable-add.md#v10-dash-variable-add-global).
+ **Tempo relativo**: sostituisce l'intervallo di tempo relativo per i singoli pannelli, il che li rende diversi da quello selezionato nel selettore temporale della dashboard nell'angolo in alto a destra della dashboard. Puoi usarlo per mostrare le metriche relative a periodi di tempo o giorni diversi sulla stessa dashboard.
**Nota**
Le sostituzioni temporali del pannello non hanno effetto quando l'intervallo di tempo della dashboard è assoluto.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/v10-panels-query-xform.html)
+ **Spostamento temporale**: sostituisce l'intervallo di tempo per i singoli pannelli spostandone l'inizio e la fine rispetto al selettore orario. Ad esempio, puoi spostare l'intervallo di tempo per il pannello in modo che sia due ore prima rispetto al selettore orario della dashboard.
**Nota**
Le sostituzioni temporali del pannello non hanno effetto quando l'intervallo di tempo del pannello di controllo è assoluto.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/v10-panels-query-xform.html)
+ **Timeout della cache**: *(visibile solo se disponibile nell'origine dati) Sostituisce il* timeout predefinito della cache se l'archivio delle serie temporali dispone di una cache delle query. Specificate questo valore come valore numerico in secondi.
# Scrivere interrogazioni sulle espressioni
****
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.md)
Per le aree di lavoro Grafana che supportano la versione 8.x di Grafana, vedere. [Funzionamento in Grafana versione 8](using-grafana-v8.md)
Le espressioni lato server consentono di manipolare i dati restituiti dalle query con operazioni matematiche e di altro tipo. Le espressioni creano nuovi dati e non manipolano i dati restituiti dalle fonti di dati.
## Informazioni sulle espressioni
Le espressioni lato server consentono di manipolare i dati restituiti dalle query con operazioni matematiche e di altro tipo. Le espressioni creano nuovi dati e non manipolano i dati restituiti dalle fonti di dati, a parte alcune piccole ristrutturazioni dei dati per rendere i dati accettabili come input per le espressioni.
**Utilizzo delle espressioni**
Le espressioni sono più comunemente utilizzate dagli avvisi [Grafana](v10-alerts.md). L'elaborazione viene eseguita sul lato server, quindi le espressioni possono funzionare senza una sessione del browser. Tuttavia, le espressioni possono essere utilizzate anche con fonti di dati e visualizzazioni di backend.
**Nota**
Le espressioni non funzionano con gli avvisi del dashboard legacy.
Le espressioni hanno lo scopo di aumentare le fonti di dati abilitando la combinazione di query provenienti da diverse fonti di dati o fornendo operazioni non disponibili in un'origine dati.
**Nota**
Quando possibile, è necessario eseguire l'elaborazione dei dati all'interno della fonte dati. La copia dei dati dallo storage al server Grafana per l'elaborazione è inefficiente, quindi le espressioni sono destinate all'elaborazione leggera dei dati.
Le espressioni funzionano con le query relative alle fonti di dati che restituiscono serie temporali o dati numerici. Funzionano anche su dati [multidimensionali](getting-started-grafanaui.md#time-series-dimensions). Ad esempio, una query che restituisce più serie, in cui ogni serie è identificata da etichette o tag.
Una singola espressione accetta una o più query o altre espressioni come input e aggiunge dati al risultato. Ogni singola espressione o query è rappresentata da una variabile che è un identificatore denominato noto come refID (ad esempio, la lettera predefinita o). `A` `B`
Per fare riferimento all'output di una singola espressione o di una query di origine dati in un'altra espressione, questo identificatore viene utilizzato come variabile.
**Tipi di espressioni**
Le espressioni funzionano con due tipi di dati.
+ Una raccolta di serie temporali.
+ Una raccolta di numeri, in cui ogni numero è un elemento.
Ogni raccolta viene restituita da una singola query o espressione di origine dati e rappresentata dal RefID. Ogni raccolta è un insieme, in cui ogni elemento del set è identificato in modo univoco dalle sue dimensioni, memorizzate come [etichette](getting-started-grafanaui.md#labels) o coppie chiave-valore.
**Interrogazioni sull'origine dei dati**
Le espressioni lato server supportano solo le query sulle origini dati per le fonti di dati di backend. Si presume generalmente che i dati siano etichettati come dati di serie temporali.
Le query sulle fonti di dati, se utilizzate con le espressioni, vengono eseguite dal motore delle espressioni. Quando esegue questa operazione, ristruttura i dati in modo che siano costituiti da una serie temporale o da un numero per frame di dati. Quindi, ad esempio, se si utilizza un'origine dati che restituisce più serie su un frame nella visualizzazione per tabella, si potrebbe notare che ha un aspetto diverso quando viene eseguita con espressioni.
Attualmente, l'unico formato non di serie temporale (numero) supportato quando si utilizzano i frame di dati è una risposta in tabella che restituisce un frame di dati senza ora, colonne di stringhe e una colonna numerica:
La seguente tabella di esempio produce un numero che funziona con le espressioni. Le colonne di stringhe diventano etichette e la colonna numerica il valore corrispondente. Ad esempio `{"Loc": "MIA", "Host": "A"}` con un valore pari a 1.
| Loc | Host | AVG\$1CPU |
| --- | --- | --- |
| MIA | A | 1 |
| NYC | B | 2 |
**Operazioni**
È possibile utilizzare le seguenti operazioni nelle espressioni: math, reduce e resample.
**Math** (Matematica)
La matematica serve per formule matematiche in formato libero su serie temporali o dati numerici. Le operazioni matematiche prendono come input numeri e serie temporali e li modificano in numeri e serie temporali diversi.
Ad esempio, ai dati di altre query o espressioni viene fatto riferimento con il RefID preceduto dal simbolo del dollaro. `$A` Se la variabile contiene spazi nel nome, puoi usare una sintassi tra parentesi come. `${my variable}`
Le costanti numeriche possono essere in formato decimale (`2.24`), ottale (con uno zero iniziale come) o esadecimale (con uno 0x iniziale`072`). `0x2A` Sono supportati anche esponenziali e segni (ad esempio,). `-0.8e-2`
**Operatori**
Sono supportati gli operatori aritmetici (`+`binari e unari`-`,`*`,`/`,`%`, esponenti`**`), relazionali (`<`,,,`>`, `==` `!=``>=`,`<=`) e logici (`&&``||`, e unari). `!`
Il comportamento dell'operazione con i dati dipende dal fatto che si tratti di dati numerici o di serie temporali.
Con le operazioni binarie, come `$A + $B` o`$A || $B`, l'operatore viene applicato nei seguenti modi a seconda del tipo di dati:
+ Se entrambi `$A` e `$B` sono numeri, l'operazione viene eseguita tra i due numeri.
+ Se una variabile è un numero e l'altra variabile è una serie temporale, viene eseguita l'operazione tra il valore di ogni punto della serie temporale e il numero.
+ Se entrambe `$A` le serie `$B` sono dati di serie temporali, l'operazione tra ogni valore delle due serie viene eseguita per ogni indicatore temporale presente in entrambe `$A` e`$B`. L'`Resample`operazione può essere utilizzata per allineare i timestamp.
Riepilogo:
+ Numero numero = numero
+ Serie numerica = serie
+ Serie serie = serie
Poiché le espressioni funzionano con più serie o numeri rappresentati da una singola variabile, le operazioni binarie eseguono anche un'unione (unione) tra le due variabili. Questa operazione viene eseguita sulla base delle etichette identificative associate a ogni singola serie o numero.
Quindi, se hai numeri con etichette come `{host=web01}` in `$A` e un altro numero `$B` con le stesse etichette, l'operazione viene eseguita tra questi due elementi all'interno di ciascuna variabile e il risultato condividerà le stesse etichette. Le regole per il comportamento di questa unione sono le seguenti:
+ Un articolo senza etichette si unirà a qualsiasi cosa.
+ Se `$B` entrambi `$A` contengono un solo elemento (una serie o un numero), si uniranno.
+ Se le etichette corrispondono esattamente, si uniranno.
+ Se le etichette sono un sottoinsieme delle altre, ad esempio un elemento in `$A` è etichettato `{host=A,dc=MIA}` e un elemento in `$B` è etichettato, si `{host=A}` uniranno.
+ Se all'interno di una variabile, ad esempio, `$A` ci sono diverse chiavi di tag per ogni elemento, il comportamento di unione non è definito.
Gli operatori relazionali e logici restituiscono 0 per falso, 1 per vero.
**Funzioni matematiche**
Sebbene la maggior parte delle funzioni sia presente nelle operazioni di espressione proprie, l'operazione matematica presenta alcune funzioni simili agli operatori o ai simboli matematici. Quando le funzioni possono accettare numeri o serie, verrà restituito lo stesso tipo dell'argomento. Quando si tratta di una serie, l'operazione viene eseguita per il valore di ogni punto della serie.
*addominali*
abs restituisce il valore assoluto del suo argomento che può essere un numero o una serie. Ad esempio: `abs(-1)` o `abs($A)`.
*is\$1inf*
is\$1inf accetta un numero o una serie e restituisce `1` `Inf` valori (negativi o positivi) e `0` altri valori. Ad esempio, `is_inf($A)`.
**Nota**
Se devi verificare specificamente l'infinito negativo, ad esempio, puoi fare un confronto come. `$A == infn()`
*is\$1nan*
is\$1nan prende un numero o una serie e restituisce valori e `1` altri `NaN` valori. `0` Ad esempio, `is_nan($A)`. Questa funzione è necessaria per questo controllo perché non `NaN` è uguale a. `NaN`
*is\$1null*
is\$1null accetta un numero o una serie e restituisce valori e altri valori`1`. `null` `0` Ad esempio, `is_null($A)`.
*is\$1number*
is\$1number prende un numero o una serie e restituisce tutti `1` i valori numerici reali e `0` gli altri valori (che sono`null`,`Inf+`, `Inf-` e). `NaN` Ad esempio, `is_number($A)`.
*registro*
Log restituisce il logaritmo naturale del suo argomento, che può essere un numero o una serie. Se il valore è inferiore a 0, `NaN` viene restituito. Ad esempio: `log(-1)` o `log($A)`.
*inf, infn, nan e null*
Le funzioni inf, infn, nan e null restituiscono tutte un singolo valore del nome. Esistono principalmente per i test. Esempio: `null()`.
*rotondo*
Round restituisce un valore intero arrotondato. Ad esempio `round(3.123)` o `round($A)`.
*soffitto*
Ceil arrotonda il numero al valore intero più vicino. Ad esempio, `ceil(3.123)` restituisce `4`.
*pavimento*
Floor arrotonda il numero per difetto al valore intero più vicino. Ad esempio,`floor(3.123`) restituisce. `3`
**Ridurre**
Reduce prende una o più serie temporali restituite da una query o un'espressione e trasforma ogni serie in un unico numero. Le etichette delle serie temporali vengono conservate come etichette su ogni numero ridotto emesso.
*Campi:*
+ **Funzione**: la funzione di riduzione da utilizzare
+ **Input**: la variabile (RefID (ad esempio`A`)) da ricampionare
+ **Modalità**: consente il comportamento di controllo della funzione di riduzione quando una serie contiene valori non numerici (null, NaN, \$1-Inf)
**Funzioni di riduzione**
*Conteggio*
Count restituisce il numero di punti in ogni serie.
*Significa*
La media restituisce il totale di tutti i valori di ogni serie diviso per il numero di punti di quella serie. In `strict` modalità se alcuni valori della serie sono null o nan, o se la serie è vuota, viene restituito NaN.
*Min e Max*
Min e Max restituiscono rispettivamente il valore più piccolo o più grande della serie. In `strict` modalità se alcuni valori della serie sono null o nan, o se la serie è vuota, viene restituito NaN.
*Somma*
Sum restituisce il totale di tutti i valori della serie. Se la serie è di lunghezza zero, la somma sarà 0. In `strict` modalità, se nella serie sono presenti valori NaN o Null, viene restituito NaN.
*Ultimo*
Ultimo restituisce l'ultimo numero della serie. Se la serie non ha valori, restituisce NaN.
**Modalità di riduzione**
*Rigido*
In modalità Strict, la serie di input viene elaborata così com'è. Se alcuni valori della serie non sono numerici (null, NaN o \$1-Inf), viene restituito NaN.
*Elimina caratteri non numerici*
In questa modalità tutti i valori non numerici (null, NaN o \$1-Inf) nella serie di input vengono filtrati prima di eseguire la funzione di riduzione.
*Sostituisci valori non numerici*
In questa modalità tutti i valori non numerici vengono sostituiti da un valore predefinito.
**Ricampionamento**
Resample modifica i timestamp di ogni serie temporale per avere un intervallo di tempo coerente. Il caso d'uso principale consiste nel ricampionare serie temporali che non condividono gli stessi timestamp in modo da poter eseguire operazioni matematiche tra di esse. Ciò può essere fatto ricampionando ciascuna delle due serie e quindi eseguendo un'operazione matematica facendo riferimento alle variabili ricampionate.
*Campi:*
+ **Input**: la variabile dei dati delle serie temporali (RefID (ad esempio`A`)) da ricampionare
+ **Ricampionamento** a: la durata del ricampionamento, ad esempio. `10s` Le unità possono essere `s` espresse in secondi, `m` `h` minuti, `d` ore, giorni, `w` settimane e `y` anni.
+ **Downsample**: la funzione di riduzione da utilizzare quando sono presenti più di un punto dati per campione di finestra. Vedi l'operazione di riduzione per i dettagli sul comportamento.
+ **Upsample**: il metodo da utilizzare per riempire un esempio di finestra senza punti dati.
+ il **pad** si riempie con l'ultimo valore noto
+ **riempimento con il successivo** valore noto
+ **fillna** per riempire le finestre di esempio vuote con NaNs
## Scrivere un'espressione
Se la tua fonte di dati li supporta, Grafana visualizza il pulsante **Espressione** e mostra tutte le espressioni esistenti nell'elenco dell'editor di query.
**Per scrivere un'espressione**
1. Aprire il pannello.
1. Sotto l'interrogazione, scegliete **Espressione**.
1. Nel campo **Operazione**, seleziona il tipo di espressione che desideri scrivere.
1. Scrivi l'espressione.
1. Scegli **Applica**.
## Casi speciali
Quando un'origine dati interrogata non restituisce serie o numeri, viene restituito il motore di espressione. `NoData` Ad esempio, se una richiesta contiene due query sull'origine dati che vengono unite da un'espressione, se `NoData` viene restituita da almeno una delle query sull'origine dati, il risultato restituito per l'intera query è. `NoData` Per ulteriori informazioni su come Grafana Alerting elabora i `NoData` risultati, vedere. [Configura le regole di avviso gestite da Grafana](v10-alerting-configure-grafanamanaged.md)
Nel caso di utilizzo di un'espressione su più query, il motore di espressione richiede che tutte le query restituiscano un timestamp identico. Ad esempio, se si utilizza la matematica per combinare il risultato di più query SQL utilizzate da ciascuna`SELECT NOW() AS "time"`, l'espressione funzionerà solo se tutte le query restituiscono un timestamp identico, cosa che non sempre accade. `NOW()` Per risolvere questo problema, è possibile sostituirlo `NOW()` con un orario arbitrario, ad esempio`SELECT 1 AS "time"`, o qualsiasi altro timestamp UNIX valido.
# Condividi i risultati delle interrogazioni con un altro pannello
****
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.md)
Per le aree di lavoro Grafana che supportano la versione 8.x di Grafana, vedere. [Funzionamento in Grafana versione 8](using-grafana-v8.md)
Grafana ti consente di utilizzare il risultato della query di un pannello per qualsiasi altro pannello della dashboard. La condivisione dei risultati delle query tra i pannelli riduce il numero di interrogazioni fatte alla fonte di dati, il che può migliorare le prestazioni della dashboard.
L'origine dati della *dashboard* ti consente di selezionare un pannello nella dashboard che contiene le query per le quali desideri condividere i risultati. Invece di inviare una query separata per ogni pannello, Grafana invia una query e gli altri pannelli utilizzano i risultati dell'interrogazione per creare visualizzazioni.
Questa strategia può ridurre drasticamente il numero di interrogazioni effettuate quando, ad esempio, sono presenti più pannelli che visualizzano gli stessi dati.
**Per condividere i risultati delle interrogazioni**
1. [Crea un pannello di controllo](v10-dash-creating.md).
1. Cambia il titolo in`Source panel`. Utilizzerai questo pannello come fonte per gli altri pannelli.
1. Definite la query o le domande che desiderate condividere.
Se non disponi di un'origine dati disponibile, utilizza l'origine dati **Grafana**, che restituisce una serie temporale casuale che puoi utilizzare per i test.
1. Aggiungi un secondo pannello e seleziona la fonte di dati della **Dashboard** nell'editor di query.
1. Nell'**elenco Usa i risultati del pannello**, seleziona il primo pannello che hai creato.
Tutte le interrogazioni definite nel pannello sorgente sono ora disponibili nel nuovo pannello. Le interrogazioni effettuate nel pannello sorgente possono essere condivise con più pannelli.
È possibile fare clic su una qualsiasi delle interrogazioni per accedere al pannello in cui sono definite.
# Trasformazione dei dati
****
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.md)
Per le aree di lavoro Grafana che supportano la versione 8.x di Grafana, vedere. [Funzionamento in Grafana versione 8](using-grafana-v8.md)
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:
+ Rinominare i campi
+ Unisci i dati delle serie temporali
+ Esegui operazioni matematiche su più query
+ Usa l'output di una trasformazione come input per un'altra trasformazione
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.
**Nota**
A volte il sistema non è in grado di rappresentare graficamente i dati trasformati. Quando ciò accade, fai clic sull'interruttore della **visualizzazione Tabella** sopra la visualizzazione per passare a una visualizzazione tabellare dei dati. Questo può aiutarti a comprendere il risultato finale delle tue trasformazioni.
## 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. Questa documentazione non include i passaggi per ogni tipo di trasformazione.
**Per aggiungere una trasformazione a un pannello**
1. Vai al pannello in cui desideri aggiungere una o più trasformazioni.
1. Passa il mouse su qualsiasi parte del pannello per visualizzare il menu delle azioni nell'angolo in alto a destra.
1. Dal menu delle azioni, scegli **Modifica**.
1. Seleziona la scheda **Trasforma**.
1. Seleziona una trasformazione. Viene visualizzata una riga di trasformazione in cui è possibile configurare le opzioni di trasformazione.
1. Per applicare un'altra trasformazione, scegli **Aggiungi trasformazione**. Questa trasformazione agisce sul set di risultati restituito dalla trasformazione precedente.
## Esegui il debug di una trasformazione
Per visualizzare i set di risultati in ingresso e in uscita della trasformazione, scegliete l'icona di debug (bug) sul lato destro della riga di trasformazione. Verranno visualizzati i dati di input e il risultato della trasformazione come output.
I set di risultati di input e output possono aiutarti a eseguire il debug di una trasformazione.
## Disabilita una trasformazione
Puoi disabilitare o nascondere una trasformazione scegliendo l'icona mostra (occhio) in alto a destra nella riga di trasformazione. Ciò disabilita le azioni applicate a quella specifica trasformazione e può aiutare a identificare i problemi quando si modificano più trasformazioni una dopo l'altra.
## Filtrare una trasformazione
Se la trasformazione utilizza più di una query, è possibile filtrarle e applicare la trasformazione selezionata a una sola delle interrogazioni. Per fare ciò, scegli l'icona del filtro in alto a destra nella riga di trasformazione. Si apre un menu a discesa con un elenco di interrogazioni utilizzate nel pannello. Da qui, puoi selezionare l'interrogazione che desideri trasformare.
Puoi anche filtrare in base alle annotazioni (che includono gli esempi) per applicare loro delle trasformazioni. Quando si esegue questa operazione, l'elenco dei campi cambia per riflettere quelli presenti nell'annotazione o nel tooltip del campione.
L'icona del filtro viene sempre visualizzata se il pannello contiene più di una query o fonte di dati (ovvero dati di pannello o annotazione), ma potrebbe non funzionare se sono state applicate trasformazioni precedenti per l'unione degli output delle query. Questo perché una trasformazione prende l'output di quella precedente.
## 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.
**Per eliminare una trasformazione**
1. Aprire un pannello per modificarlo.
1. Seleziona la scheda **Trasforma**.
1. Scegli l'icona del cestino accanto alla trasformazione che desideri eliminare.
# Funzioni di trasformazione
****
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.md)
Per le aree di lavoro Grafana che supportano la versione 8.x di Grafana, vedere. [Funzionamento in Grafana versione 8](using-grafana-v8.md)
È 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.
+ **Modalità**: seleziona una modalità:
+ **Riduci riga**: applica il calcolo selezionato su ciascuna riga di campi selezionati in modo indipendente.
+ **Operazione binaria**: applica operazioni binarie di base (ad esempio, somma o moltiplica) sui valori in una singola riga da due campi selezionati.
+ **Operazione unaria**: applica le operazioni unarie di base sui valori in una singola riga da un campo selezionato. Le operazioni disponibili sono:
+ **Valore assoluto (abs)**: restituisce il valore assoluto di una determinata espressione. Rappresenta la distanza da zero come numero positivo.
+ **Esponenziale naturale (exp)**: restituisce *e* elevato alla potenza di una determinata espressione.
+ **Logaritmo naturale (ln)**: restituisce il logaritmo naturale di una determinata espressione.
+ **Floor (floor)**: restituisce il numero intero più grande minore o uguale a una determinata espressione.
+ **Ceiling (ceil)**: restituisce il numero intero più piccolo maggiore o uguale a una determinata espressione.
+ Funzioni **cumulative: applica le funzioni** sulla riga corrente e su tutte le righe precedenti.
+ **Totale**: calcola il totale cumulativo fino alla riga corrente inclusa.
+ **Media**: calcola la media fino alla riga corrente inclusa.
+ **Funzioni della finestra**: applica le funzioni della finestra. La finestra può essere *trascinata* o *centrata*. Con una finestra finale, la riga corrente sarà l'ultima riga della finestra. Con una finestra centrata, la finestra sarà centrata sulla riga corrente. Per finestre di dimensioni pari, la finestra sarà centrata tra la riga corrente e la riga precedente.
+ **Media**: calcola la media mobile o la media progressiva.
+ ****— Calcola la deviazione standard mobile.
+ **Varianza**: calcola la varianza mobile.
+ **Indice di riga**: inserisce un campo con l'indice di riga.
+ **Nome campo**: seleziona i nomi dei campi che desideri utilizzare nel calcolo per il nuovo campo.
+ **Calcolo**: se si seleziona **la modalità Riduci righe**, viene visualizzato il campo **Calcolo**. Seleziona il campo per visualizzare un elenco di opzioni di calcolo che puoi utilizzare per creare il nuovo campo. Per informazioni sui calcoli disponibili, consulta [Tipi di calcolo](v10-panels-calculation-types.md).
+ **Operazione**: se si seleziona la modalità **operativa binaria** **o unaria**, vengono visualizzati i campi **Operazione**. Questi campi consentono di eseguire operazioni matematiche di base sui valori in un'unica riga da due campi selezionati. È inoltre possibile utilizzare valori numerici per operazioni binarie.
+ **Come percentile**: se si seleziona la modalità **Indice di riga**, viene visualizzato l'interruttore **Come percentile**. Questo interruttore consente di trasformare l'indice di riga come percentuale del numero totale di righe.
+ **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) Seleziona questa opzione se desideri nascondere tutti gli altri campi e visualizzare solo il campo calcolato nella visualizzazione.
**Nota**
Le funzioni **cumulative e le funzioni** **Window** sono attualmente disponibili nell'anteprima pubblica. Grafana Labs offre un supporto limitato e potrebbero verificarsi modifiche sostanziali prima che la funzionalità venga resa disponibile al pubblico.
## Concatena i campi
**Concatena i campi**
Utilizzate questa trasformazione per combinare tutti i campi di tutti i frame in un unico risultato.
Ad esempio, se avete interrogazioni separate che recuperano dati sulla temperatura e sull'operatività (query A) e sull'indice di qualità dell'aria e informazioni sugli errori (query b), applicando la trasformazione concatenata si ottiene un frame di dati consolidato con tutte le informazioni pertinenti in un'unica vista.
Considerate questi due seguenti.
*Interrogazione A:*
| Temp | Operatività |
| --- | --- |
| 15.4 | 1230233 |
*Interrogazione B:*
| AQI | Errori |
| --- | --- |
| 3.2 | 5 |
Dopo aver concatenato i campi, il frame di dati sarebbe:
| Temp | Operatività | AQI | Errori |
| --- | --- | --- | --- |
| 15,4 | 1230233 | 3.2 | 5 |
Questa trasformazione semplifica il processo di fusione dei dati provenienti da diverse fonti, fornendo una visione completa per l'analisi e la visualizzazione.
## Config dai risultati della query
**Config dai risultati della query**
Utilizzate questa trasformazione per selezionare una query ed estrarre opzioni standard come **Min**, **Max**, **Unit** e **Thresholds** e applicarle ad altri risultati della query. Ciò consente una configurazione dinamica della visualizzazione, basata sui dati restituiti da una query specifica.
**Opzioni**
+ **Interrogazione di configurazione**: seleziona la query che restituisce i dati che desideri utilizzare come configurazione.
+ **Applica a**: seleziona i campi o le serie a cui applicare la configurazione.
+ **Applica alle opzioni**: specifica un tipo di campo o usa un'espressione regolare del nome di campo, a seconda della selezione effettuata in **Applica a**.
**Tabella di mappatura dei campi**
Sotto le opzioni di configurazione, troverai la tabella di mappatura dei campi. Questa tabella elenca tutti i campi trovati nei dati restituiti dalla query di configurazione, insieme alle opzioni **Usa come** e **Seleziona**. Fornisce il controllo sulla mappatura dei campi alle proprietà di configurazione e, per più righe, consente di scegliere il valore da selezionare.
L'esempio seguente mostra una query di input e una query utilizzata come configurazione del campo.
*Query di input*
| Orario | Valore |
| --- | --- |
| 1626178119127 | 10 |
| 1626178119129 | 30 |
*Interrogazione di configurazione*
| Orario | Valore |
| --- | --- |
| 1626178119127 | 100 |
| 1626178119129 | 100 |
*Query di output (uguale a input, ma ora con configurazione nel campo del valore)*
| Orario | Valore (configurazione: Max=100) |
| --- | --- |
| 1626178119127 | 10 |
| 1626178119129 | 30 |
Ogni campo ha ora un set massimo di opzioni di configurazione. Opzioni come **Min**, **Max**, **Unit** e **Thresholds** fanno parte della configurazione del campo. Se impostate, vengono utilizzate dalla visualizzazione anziché dalle opzioni configurate manualmente nel riquadro delle opzioni dell'editor del pannello.
**Mappature dei valori**
È inoltre possibile trasformare il risultato di una query in mappature di valori. Con questa opzione, ogni riga del risultato della query di configurazione definisce una singola riga di mappatura dei valori. Guarda l'esempio seguente.
*Risultato della query di configurazione*
| Valore | Testo | Colore |
| --- | --- | --- |
| L | Bassa | blu |
| M | Media | verde |
| H | Elevata | rosso |
*Nella mappatura del campo, specificare:*
| Campo | Usa come | Select |
| --- | --- | --- |
| Valore | Mappature dei valori/Valore | Tutti i valori |
| Testo | Mappature di valori/ Testo | Tutti i valori |
| Colore | Mappature di valori/ Colore | Tutti i valori |
Grafana crea mappature dei valori dai risultati della query e le applica ai risultati delle query di dati reali. Dovresti vedere i valori mappati e colorati in base ai risultati della query di configurazione.
## Converti il tipo di campo
Usa questa trasformazione per modificare il tipo di campo del campo specificato.
Questa trasformazione ha le seguenti opzioni:
+ **Campo**: seleziona uno dei campi disponibili.
+ **as**: seleziona il formato in cui FieldType convertire.
+ **Numerico**: tenta di rendere numerici i valori.
+ **Stringa**: renderà i valori stringhe.
+ **Ora**: tenta di analizzare i valori come tempo.
+ Mostrerà un'opzione per specificare a DateFormat come input da una stringa, come `yyyy-mm-dd` o`DD MM YYYY hh:mm:ss`.
+ **Booleano**: renderà i valori booleani.
+ **Enum: renderà i valori enumerati**.
+ Mostrerà una tabella per gestire le enumerazioni.
+ **Altro**: tenta di analizzare i valori come json.
Ad esempio, considera la seguente query che potrebbe essere modificata selezionando il campo Time, come **Time** e Date Format as. `YYYY`
| Orario | Segna | Valore |
| --- | --- | --- |
| 01/07/2017 | sopra | 25 |
| 2018-08-02 | sotto | 22 |
| 2019-09-02 | sotto | 29 |
| 2020-10-04 | sopra | 22 |
Il risultato:
| Orario | Mark | Valore |
| --- | --- | --- |
| 2017-01-01 00:00:00 | sopra | 25 |
| 2018-01-01 00:00:00 | sotto | 22 |
| 2019-01-01 00:00:00 | sotto | 29 |
| 2020-01-01 00:00:00 | sopra | 22 |
Questa trasformazione consente di adattare in modo flessibile i tipi di dati, garantendo compatibilità e coerenza nelle visualizzazioni.
## Estrai campi
Usa questa trasformazione per selezionare una fonte di dati ed estrarne il contenuto in diversi formati. Questa trasformazione ha i seguenti campi:
+ **Origine**: seleziona il campo per l'origine dei dati.
+ **Formato**: scegli una delle seguenti opzioni:
+ **JSON**: analizza il contenuto JSON dalla fonte.
+ **Coppie chiave\$1valore**: analizza il contenuto nel formato o dalla fonte. `a=b` `c:d`
+ **Automatico**: scopri automaticamente i campi.
+ **Sostituisci tutti i campi**: (Facoltativo) Seleziona questa opzione per nascondere tutti gli altri campi e visualizzare solo il campo calcolato nella visualizzazione.
+ **Keep Time** - (Facoltativo) Disponibile solo se l'opzione **Sostituisci tutti i campi** è impostata su True. Mantiene il campo temporale nell'output.
Considerate il seguente set di dati:
**Esempio di set di dati**
| Time stamp | json\$1data |
| --- | --- |
| 1636678740000000000 | \$1"valore»: 1\$1 |
| 1636678680000000000 | \$1"valore»: 5\$1 |
| 1636678620000000000 | \$1"valore»: 12\$1 |
È possibile preparare i dati da utilizzare da un [pannello Time series](v10-panels-time-series.md) con questa configurazione:
+ Fonte: json\$1data
+ Formato: JSON
+ Campo: valore
+ Alias: my\$1value
+ Sostituisci tutti i campi: true
+ Mantieni il tempo: vero
Questo genererà il seguente output:
**Dati trasformati**
| Time stamp | my\$1value |
| --- | --- |
| 1636678740000000000 | 1 |
| 1636678680000000000 | 5 |
| 1636678620000000000 | 12 |
Con questa trasformazione, puoi estrarre e formattare i dati in vari modi. È possibile personalizzare il formato di estrazione in base alle esigenze specifiche dei dati.
## Cerca i campi dalla risorsa
Usa questa trasformazione per arricchire il valore di un campo cercando campi aggiuntivi da una fonte esterna.
Questa trasformazione ha i seguenti campi:
+ **Campo**: seleziona un campo di testo dal tuo set di dati.
+ **Ricerca****: scegli tra **Paesi**, **Stati Uniti** e aeroporti.**
**Nota**
Questa trasformazione supporta solo dati spaziali.
Ad esempio, se disponi di questi dati:
**Esempio di set di dati**
| Location (Ubicazione) | Valori |
| --- | --- |
| AL | 0 |
| AK | 10 |
| Arizona | 5 |
| Arkansas | 1 |
| Da qualche parte | 5 |
Con questa configurazione:
+ Campo: posizione
+ Ricerca: Stati Uniti
Otterrai il seguente risultato:
**Dati trasformati**
| Location (Ubicazione) | ID | Name | Lng | Lat | Valori |
| --- | --- | --- | --- | --- | --- |
| AL | AL | Alabama | -80,891064 | 12,448457 | 0 |
| AK | AK | Arkansas | -100,891064 | 24,448457 | 10 |
| Arizona | | | | | 5 |
| Arkansas | | | | | 1 |
| Da qualche parte | | | | | 5 |
Questa trasformazione consente di aumentare i dati recuperando informazioni aggiuntive da fonti esterne, fornendo un set di dati più completo per l'analisi e la visualizzazione.
## Filtra i dati per query RefID
Utilizzate questa trasformazione per nascondere una o più interrogazioni nei pannelli con più interrogazioni.
Grafana visualizza le lettere di identificazione della query in testo grigio scuro. Scegli 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.
**Nota**
Questa trasformazione non è disponibile per Graphite perché questa fonte di dati non supporta la correlazione dei dati restituiti con le query.
## Filtra i dati per valori
Usa questa trasformazione per filtrare selettivamente i punti dati direttamente all'interno della visualizzazione. Questa trasformazione offre opzioni per includere o escludere i dati in base a una o più condizioni applicate a un campo selezionato.
Questa trasformazione è molto 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:
+ **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 aggiuntive disponibili per i campi numerici sono:
+ **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.
+ **Minore o uguale**: corrisponde se il valore è inferiore o uguale.
+ **Intervallo**: corrisponde a un intervallo compreso tra un minimo e un massimo specificati, inclusi minimo e massimo.
Considerate il seguente set di dati:
| Orario | Temperatura | Altitude (Altitudine) |
| --- | --- | --- |
| 2020-07-07 11:34:23 | 32 | 101 |
| 2020-07-07 11:34:22 | 28 | 125 |
| 2020-07-07 11:34:21 | 26 | 110 |
| 2020-07-07 11:34:20 | 23 | 98 |
| 2020-07-07 10:32:24 | 31 | 95 |
| 2020-07-07 10:31:22 | 20 | 85 |
| 2020-07-07 09:30:57 | 19 | 101 |
Se **includi** i punti dati con una temperatura inferiore a 30°C, la configurazione sarà la seguente:
+ Tipo di filtro: 'Includi'
+ Condizione: righe in cui «Temperatura» corrisponde a «Inferiore a» «30"
E otterrai il seguente risultato, in cui sono incluse solo le temperature inferiori a 30 °C:
**Dati trasformati**
| Orario | Temperatura | Altitude (Altitudine) |
| --- | --- | --- |
| 2020-07-07 11:34:22 | 28 | 125 |
| 2020-07-07 11:34:21 | 26 | 110 |
| 2020-07-07 11:34:20 | 23 | 98 |
| 2020-07-07 10:31:22 | 20 | 85 |
| 2020-07-07 09:30:57 | 19 | 101 |
È possibile 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:
+ Tipo di filtro: «Includi» le righe che «corrispondono a tutte le condizioni»
+ Condizione 1: righe in cui «Temperatura» corrisponde a «Inferiore» a «30»
+ Condizione 2: righe in cui «Altitudine» corrisponde a «Maggiore» di «100"
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 corrispondono** **a una delle condizioni che hai** aggiunto.
Nell'esempio precedente, abbiamo scelto **Abbina tutto** perché volevamo includere le righe con una temperatura inferiore a 30°C *E* un'altitudine superiore a 100. Se volessimo includere invece le righe che hanno una temperatura inferiore a 30°C *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.
Questa trasformazione versatile del filtraggio dei dati consente di includere o escludere selettivamente i punti dati in base a condizioni specifiche. Personalizza i criteri per personalizzare la presentazione dei dati in modo da soddisfare le tue esigenze analitiche uniche.
## Filtra i campi per nome
Utilizza questa trasformazione per rimuovere parti dei risultati della query. Esistono tre modi per filtrare i nomi dei campi:
+ Inserisci un'espressione regolare.
+ Seleziona manualmente i campi inclusi.
+ Usa una variabile del dashboard.
*Usa un'espressione regolare*
Quando si filtra utilizzando un'espressione regolare, vengono inclusi i nomi di campo che corrispondono all'espressione regolare. Ad esempio, l'utilizzo dell'espressione regolare `'prod.*'` restituirebbe solo i campi che iniziano con `prod`
L'espressione regolare può includere una variabile di dashboard interpolata utilizzando la `${variableName}` sintassi.
*Seleziona manualmente i campi inclusi*
Seleziona o deseleziona i nomi dei campi per rimuoverli dal risultato. Se è inclusa anche un'espressione regolare, vengono inclusi i campi che corrispondono all'espressione, anche se non sono selezionati.
*Usa una variabile del pannello di controllo*
Seleziona **Dalla variabile** per selezionare una variabile del dashboard utilizzata per includere i campi. Impostando una variabile di dashboard con scelte multiple, gli stessi campi possono essere visualizzati in più visualizzazioni.
Questa trasformazione offre flessibilità nella personalizzazione dei risultati delle query per concentrarsi sui campi specifici necessari per un'analisi e una visualizzazione efficaci.
## Stringa di formato
Utilizzate questa trasformazione per personalizzare l'output di un campo di stringa. Questa trasformazione ha i seguenti campi:
+ **Maiuscolo**: formatta l'intera stringa in caratteri maiuscoli.
+ **Minuscole**: formatta l'intera stringa in caratteri minuscoli.
+ **Frase maiuscola**: formatta il primo carattere della stringa in maiuscolo.
+ **Maiuscole e minuscole**: formatta il primo carattere di ogni parola nella stringa in maiuscolo.
+ **Pascal case** — Formatta il primo carattere di ogni parola nella stringa in maiuscolo e non include spazi tra le parole.
+ **Camel case**: formatta il primo carattere di ogni parola nella stringa in maiuscolo, tranne la prima parola, e non include spazi tra le parole.
+ **Snake case**: formatta tutti i caratteri della stringa in lettere minuscole e utilizza caratteri di sottolineatura anziché spazi tra le parole.
+ **Kebab case**: formatta tutti i caratteri della stringa in lettere minuscole e utilizza trattini anziché spazi tra le parole.
+ **Trim** — Rimuove tutti gli spazi iniziali e finali dalla stringa.
+ **Sottostringa** — Restituisce una sottostringa della stringa, utilizzando le posizioni iniziale e finale specificate.
Questa trasformazione offre un modo conveniente per standardizzare e personalizzare la presentazione dei dati delle stringhe per una migliore visualizzazione e analisi.
**Nota**
Questa trasformazione è attualmente disponibile in anteprima pubblica. Grafana Labs offre un supporto limitato e potrebbero verificarsi modifiche sostanziali prima che la funzionalità venga resa disponibile al pubblico.
## Ora di formattazione
Utilizzate questa trasformazione per personalizzare l'output di un campo temporale. L'output può essere formattato utilizzando [stringhe di formato Moment.js](https://momentjs.com/docs/#/displaying/). Ad esempio, se si desidera visualizzare solo l'anno di un campo orario, è possibile utilizzare la stringa di formato 'YYYY' per mostrare l'anno solare (ad esempio, 1999 o 2012).
**Prima della trasformazione:**
| Time stamp | Event |
| --- | --- |
| 1636678740000000000 | Avvio del sistema |
| 1636678680000000000 | Login utente |
| 1636678620000000000 | Dati aggiornati |
**Dopo aver applicato 'YYYY-MM-DD HH:mm:ss':**
| Time stamp | Event |
| --- | --- |
| 2021-11-12 14:25:40 | Avvio del sistema |
| 2021-11-12 14:24:40 | Login utente |
| 2021-11-12 14:23:40 | Dati aggiornati |
Questa trasformazione consente di personalizzare la rappresentazione del tempo nelle visualizzazioni, offrendo flessibilità e precisione nella visualizzazione dei dati temporali.
**Nota**
Questa trasformazione è disponibile in aree di lavoro compatibili con Grafana v10 come funzionalità alfa.
## Gruppo da
Questa trasformazione raggruppa i dati in base a un valore di campo (colonna) specificato ed elabora i calcoli su ciascun gruppo. Seleziona per visualizzare un elenco di scelte di calcolo.
Ecco un esempio di dati originali.
| Orario | ID del server | Temperatura della CPU | Stato del server |
| --- | --- | --- | --- |
| 07/07/2020 11:34:20AM | server 1 | 80 | Arresto |
| 07/07/2020 11:34:20 | server 3 | 62 | OK |
| 07/07/2020 10:32:20 | server 2 | 90 | Sovraccarico |
| 07/07/2020 10:31:22 | server 3 | 55 | OK |
| 07/07/2020 9:30:57 | server 3 | 62 | Reebooting (Riavvio in corso) |
| 07/07/2020 9:30:05 | server 2 | 88 | OK |
| 07/07/2020 09:28:06 | server 1 | 80 | OK |
| 07/07/2020 09:25:05 | server 2 | 88 | OK |
| 07/07/2020 09:23:07 | server 1 | 86 | OK |
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:
| Orario | ID del server | Temperatura della CPU | Stato del server |
| --- | --- | --- | --- |
| 07/07/2020 11:34:20AM | server 1 | 80 | Arresto |
| 07/07/2020 09:28:06 | server 1 | 80 | OK |
| 07/07/2020 09:23:07 | server 1 | 86 | OK |
| 07/07/2020 10:32:20 | server 2 | 90 | Sovraccarico |
| 07/07/2020 9:30:05 | server 2 | 88 | OK |
| 07/07/2020 09:25:05 | server 2 | 88 | OK |
| 07/07/2020 11:34:20 | server 3 | 62 | OK |
| 07/07/2020 10:31:22 | server 3 | 55 | OK |
| 07/07/2020 9:30:57 | server 3 | 62 | Reebooting (Riavvio in corso) |
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:
| ID del server | Temperatura della CPU (media) |
| --- | --- |
| server 1 | 82 |
| server 2 | 8.6 |
| server 3 | 59,6 |
E possiamo aggiungere più di un calcolo. Per esempio:
+ Per il campo Time, possiamo calcolare l'*ultimo* valore, per sapere quando è stato ricevuto l'ultimo punto dati per ogni server
+ Per il campo Server Status, possiamo calcolare il valore *Last* per sapere qual è l'ultimo valore di stato per ogni server
+ Per il campo Temperature, possiamo anche calcolare l'*ultimo* valore per sapere qual è l'ultima temperatura monitorata per ogni server
Otterremmo quindi:
| ID del server | Temperatura della CPU (media) | Temperatura della CPU (ultima) | Ora (ultima) | Stato del server (ultimo) |
| --- | --- | --- | --- | --- |
| server 1 | 82 | 80 | 07/07/2020 11:34:20 | Arresto |
| server 2 | 8.6 | 90 | 07/07/2020 10:32:20 | Sovraccarico |
| server 3 | 59,6 | 62 | 07/07/2020 11:34:20 | OK |
Questa trasformazione consente di estrarre le informazioni chiave dalle serie temporali e di visualizzarle in modo conveniente.
## Raggruppamento in matrice
Utilizzate questa trasformazione per combinare tre campi, utilizzati come input per i campi dei **valori **Colonna**, **Riga** e Cella** dall'output della query, e generare una matrice. La matrice viene calcolata come segue:
**Dati originali**
| ID del server | Temperatura della CPU | Stato del server |
| --- | --- | --- |
| server 1 | 82 | OK |
| server 2 | 8.6 | OK |
| server 3 | 59,6 | Arresto |
Possiamo generare una matrice usando i valori di `Server Status` come nomi di colonna, i `Server ID` valori come nomi di riga e `CPU Temperature` come contenuto di ogni cella. Il contenuto di ogni cella verrà visualizzato per la combinazione di colonne (`Server Status`) e righe esistente (`Server ID`). Per il resto delle celle, puoi selezionare il valore da visualizzare tra: **Null**, **True**, **False** o **Empty**.
**Output**
| Stato del server IDServer | OK | Arresto |
| --- | --- | --- |
| server 1 | 82 | |
| server 2 | 8.6 | |
| server 3 | | 59,6 |
Utilizzate questa trasformazione per costruire una matrice specificando i campi dai risultati della query. L'output della matrice riflette le relazioni tra i valori univoci in questi campi. Ciò consente di presentare relazioni complesse in un formato a matrice chiaro e strutturato.
## Da gruppo a tabella nidificata
Utilizza questa trasformazione per raggruppare i dati in base a un valore di campo (colonna) specificato ed elaborare il calcolo su ciascun gruppo. Vengono generati record che condividono lo stesso valore del campo raggruppato, da visualizzare in una tabella nidificata.
**Per calcolare una statistica per un campo, seleziona la casella accanto al campo e scegli l'opzione Calcola.** Verrà aggiunta un'altra casella di selezione con le statistiche da selezionare.
La tabella seguente mostra dati di esempio.
| Orario | ID del server | Temperatura della CPU | Stato del server |
| --- | --- | --- | --- |
| 07/07/2020 11:34:20AM | server 1 | 80 | Arresto |
| 07/07/2020 11:34:20 | server 3 | 62 | OK |
| 07/07/2020 10:32:20 | server 2 | 90 | Sovraccarico |
| 07/07/2020 10:31:22 | server 3 | 55 | OK |
| 07/07/2020 9:30:57 | server 3 | 62 | Reebooting (Riavvio in corso) |
| 07/07/2020 9:30:05 | server 2 | 88 | OK |
| 07/07/2020 09:28:06 | server 1 | 80 | OK |
| 07/07/2020 09:25:05 | server 2 | 88 | OK |
| 07/07/2020 09:23:07 | server 1 | 86 | OK |
Questa trasformazione prevede due fasi. Innanzitutto, specifica uno o più campi in base ai quali raggruppare i dati. Questo raggruppa tutti gli stessi valori di quei campi, come se li ordinassi. Ad esempio, se raggruppi per `Server ID` campo, Grafana raggruppa i dati in questo modo:
| ID del server | Dati |
| --- | --- |
| Orario | Temperatura della CPU | Stato del server |
| --- | --- | --- |
| Orario | Temperatura della CPU | Stato del server |
| --- | --- | --- |
| Orario | Temperatura della CPU | Stato del server |
| --- | --- | --- |
| server 1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/v10-panels-xform-functions.html) |
| server 2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/v10-panels-xform-functions.html) |
| server 3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/v10-panels-xform-functions.html) |
| 07/07/2020 11:34:20AM | 80 | Arresto |
| 07/07/2020 9:28:06 | 80 | OK |
| 07/07/2020 9:23:07 | 86 | OK |
| 07/07/2020 10:32:20 | 90 | Sovraccarico |
| 07/07/2020 9:30:05 | 88 | OK |
| 07/07/2020 9:25:05 | 88 | OK |
| 07/07/2020 11:34:20AM | 62 | OK |
| 07/07/2020 10:31:22 | 55 | OK |
| 07/07/2020 9:30:57 | 62 | Reebooting (Riavvio in corso) |
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, potresti voler calcolare la temperatura media della CPU per ciascuno di questi server. A tale scopo, aggiungi il calcolo della media applicato al campo Temperatura della CPU per ottenere il seguente risultato:
| ID del server | Temperatura della CPU (media) | |
| --- | --- | --- |
| Orario | Stato del server |
| --- | --- |
| Orario | Stato del server |
| --- | --- |
| Orario | Stato del server |
| --- | --- |
| server 1 | 82 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/v10-panels-xform-functions.html) |
| server 2 | 8.6 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/v10-panels-xform-functions.html) |
| server 3 | 59,6 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/v10-panels-xform-functions.html) |
| 07/07/2020 11:34:20AM | Arresto |
| 07/07/2020 9:28:06 | OK |
| 07/07/2020 9:23:07 | OK |
| 07/07/2020 10:32:20 | Sovraccarico |
| 07/07/2020 9:30:05 | OK |
| 07/07/2020 9:25:05 | OK |
| 07/07/2020 11:34:20AM | OK |
| 07/07/2020 10:31:22 | OK |
| 07/07/2020 9:30:57 | Reebooting (Riavvio in corso) |
## Crea una mappa termica
Usa questa trasformazione per preparare i dati dell'istogramma per visualizzare le tendenze nel tempo. Simile alla visualizzazione della mappa termica, questa trasformazione converte le metriche degli istogrammi in intervalli temporali.
**X Bucket**
Questa impostazione determina come l'asse x viene suddiviso in secchi.
+ **Dimensione**: specifica un intervallo di tempo nel campo di immissione. Ad esempio, un intervallo di tempo di `1h` crea celle larghe un'ora sull'asse x.
+ **Conteggio**: per le non-time-related serie, utilizzate questa opzione per definire il numero di elementi in un bucket.
**Secchio Y**
Questa impostazione determina come l'asse y viene suddiviso in secchi.
+ **Linear** (Lineare)
+ **Logaritmico**: scegli tra log base 2 o log base 10.
+ **Symlog**: utilizza una scala logaritmica simmetrica. Scegli tra log base 2 o log base 10, tenendo conto dei valori negativi.
Supponiamo di avere il seguente set di dati:
| Time stamp | Valore |
| --- | --- |
| 2023-01-01 12:00:00 | 5 |
| 2023-01-01 12:15:00 | 10 |
| 2023-01-01 12:30:00 | 15 |
| 2023-01-01 12:45:00 | 8 |
+ Con X Bucket impostato su `Size: 15m` e Y Bucket as`Linear`, l'istogramma organizza i valori in intervalli di tempo di 15 minuti sull'asse x e linearmente sull'asse y.
+ Per X Bucket as `Count: 2` e Y Bucket as`Logarithmic (base 10)`, l'istogramma raggruppa i valori in secchi di due sull'asse x e utilizza una scala logaritmica sull'asse y.
## Istogramma
Utilizzate questa trasformazione per generare un istogramma basato sui dati di input, che consente di visualizzare la distribuzione dei valori.
+ **Dimensione del bucket**: l'intervallo tra gli elementi più bassi e più alti in un bucket (da XMin a XMax).
+ Offset del **bucket: l'offset** per i bucket. non-zero-based
+ **Combina serie**: crea un istogramma unificato utilizzando tutte le serie disponibili.
**Dati originali**
Serie 1:
| A | B | C |
| --- | --- | --- |
| 1 | 3 | 5 |
| 2 | 4 | 6 |
| 3 | 5 | 7 |
| 4 | 6 | 8 |
| 5 | 7 | 9 |
Serie 2:
| C |
| --- |
| 5 |
| 6 |
| 7 |
| 8 |
| 9 |
**Output**
| XMin | XMax | A | B | C | C |
| --- | --- | --- | --- | --- | --- |
| 1 | 2 | 1 | 0 | 0 | 0 |
| 2 | 3 | 1 | 0 | 0 | 0 |
| 3 | 4 | 1 | 1 | 0 | 0 |
| 4 | 5 | 1 | 1 | 0 | 0 |
| 5 | 6 | 1 | 1 | 1 | 1 |
| 6 | 7 | 0 | 1 | 1 | 1 |
| 7 | 8 | 0 | 1 | 1 | 1 |
| 8 | 9 | 0 | 0 | 1 | 1 |
| 9 | 10 | 0 | 0 | 1 | 1 |
Visualizza la distribuzione dei valori utilizzando l'istogramma generato, fornendo informazioni sulla diffusione e sulla densità dei dati.
## Partecipa per campo
Usa questa trasformazione per unire più risultati in un'unica tabella, permettendo il consolidamento dei dati provenienti da diverse query.
È particolarmente utile per convertire più risultati di 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:
| Orario | Processo | Operatività |
| --- | --- | --- |
| 07/07/2020 11:34:20 | nodo | 25260122 |
| 07/07/2020 11:24:20 | locandina | 123001233 |
| 07/07/2020 11:14:20 | locandina | 345001233 |
Interrogazione B:
| Orario | Server | Errori |
| --- | --- | --- |
| 07/07/2020 11:34:20 | server 1 | 15 |
| 07/07/2020 11:24:20 | server 2 | 5 |
| 07/07/2020 11:04:20 | server 3 | 10 |
Il risultato dopo l'applicazione della trasformazione inner join è simile al seguente:
| Orario | Processo | Operatività | Server | Errori |
| --- | --- | --- | --- | --- |
| 07/07/2020 11:34:20 | nodo | 25260122 | server 1 | 15 |
| 07/07/2020 11:24:20 | locandina | 123001233 | server 2 | 5 |
*Giunto esterno*
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:
| Orario | Processo | Operatività |
| --- | --- | --- |
| 07/07/2020 11:34:20 | nodo | 25260122 |
| 07/07/2020 11:24:20 | locandina | 123001233 |
| 07/07/2020 11:14:20 | locandina | 345001233 |
Interrogazione B:
| Orario | Server | Errori |
| --- | --- | --- |
| 07/07/2020 11:34:20 | server 1 | 15 |
| 07/07/2020 11:24:20 | server 2 | 5 |
| 07/07/2020 11:04:20 | server 3 | 10 |
Il risultato dopo l'applicazione della trasformazione outer join è simile al seguente:
| Orario | Processo | Operatività | Server | Errori |
| --- | --- | --- | --- | --- |
| 07/07/2020 11:04:20 | | | server 3 | 10 |
| 07/07/2020 11:14:20 | locandina | 345001233 | | |
| 07/07/2020 11:34:20 | nodo | 25260122 | server 1 | 15 |
| 07/07/2020 11:24:20 | locandina | 123001233 | server 2 | 5 |
## Unisciti per etichette
Usa questa trasformazione per unire più risultati in un'unica tabella.
Ciò è particolarmente utile per convertire più risultati di serie temporali in un'unica tabella ampia con un campo **Label** condiviso.
+ **Unisci**: seleziona l'etichetta con cui unirti tra le etichette disponibili o comuni in tutte le serie temporali.
+ **Valore**: il nome del risultato di output.
**Esempio**
Ingresso 1: `series1{what='Temp', cluster='A', job='J1'}`
| Orario | Valore |
| --- | --- |
| 1 | 10 |
| 2 | 200 |
Ingresso 2: `series2{what='Temp', cluster='B', job='J1'}`
| Orario | Valore |
| --- | --- |
| 1 | 10 |
| 2 | 200 |
Ingresso 3: `series3{what='Speed', cluster='B', job='J1'}`
| Orario | Valore |
| --- | --- |
| 22 | 22 |
| 28 | 77 |
Config:
```
value: 'what'
```
Output:
| cluster | job | Temp | Velocità |
| --- | --- | --- | --- |
| A | J1 | 10 | |
| A | J1 | 200 | |
| B | J1 | 10 | 22 |
| B | J1 | 200 | 77 |
Combina e organizza i dati delle serie temporali in modo efficace con questa trasformazione per ottenere informazioni complete.
## Etichette per campi
Usa questa trasformazione per convertire i risultati delle serie temporali con etichette o tag in una tabella, includendo le chiavi e i valori di ogni etichetta nel risultato. Visualizza le etichette come colonne o valori di riga per una migliore visualizzazione dei dati.
Dato il risultato di una query di due serie temporali:
+ Serie 1: etichette`Server=Server A`, `Datacenter=EU`
+ Serie 2 — etichette`Server=Server B`, `Datacenter=EU`
In modalità **Colonne**, il risultato è simile al seguente:
| Orario | Server | Datacenter | Valore |
| --- | --- | --- | --- |
| 07/07/2020 11:34:20 | Server A | UE | 1 |
| 07/07/2020 11:34:20 | Server B | UE | 2 |
In modalità «Righe», il risultato ha una tabella per ogni serie e mostra il valore di ogni etichetta in questo modo:
| etichetta | value |
| --- | --- |
| Server | Server A |
| Datacenter | UE |
| etichetta | value |
| --- | --- |
| Server | Server B |
| Datacenter | UE |
**Nome del campo Valore**
Se hai selezionato Server come **nome del campo Valore**, otterrai un campo per ogni valore dell'etichetta Server.
| Orario | Datacenter | Server A | Server B |
| --- | --- | --- | --- |
| 07/07/2020 11:34:20 | UE | 1 | 2 |
**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.
+ Serie 1 — etichette `Server=ServerA`
+ Serie 2 — etichette `Datacenter=EU`
Ciò risulterà innanzitutto in queste due tabelle:
| Orario | Server | Valore |
| --- | --- | --- |
| 07/07/2020 11:34:20 | Server A | 10 |
| Orario | Datacenter | Valore |
| --- | --- | --- |
| 07/07/2020 11:34:20 | UE | 20 |
Dopo l'unione:
| Orario | Server | Valore | Datacenter |
| --- | --- | --- | --- |
| 07/07/2020 11:34:20 | Server A | 10 | |
| 07/07/2020 11:34:20 | | 20 | UE |
## Limite
Usa questa trasformazione per limitare il numero di righe visualizzate, fornendo una visione più mirata dei tuoi dati. Ciò è particolarmente utile quando si ha a che fare con set di dati di grandi dimensioni.
Di seguito è riportato un esempio che illustra l'impatto della trasformazione **Limit** su una risposta proveniente da una fonte di dati:
| Orario | Metrica | Valore |
| --- | --- | --- |
| 07/07/2020 11:34:20 | Temperatura | 25 |
| 07/07/2020 11:34:20 | Umidità | 22 |
| 07/07/2020 10:32:20AM | Umidità | 29 |
| 07/07/2020 10:31:22 | Temperatura | 22 |
| 07/07/2020 9:30:57 | Umidità | 33 |
| 07/07/2020 09:30:05 | Temperatura | 19 |
Ecco il risultato dopo aver aggiunto una trasformazione Limit con un valore di '3':
| Orario | Metrica | Valore |
| --- | --- | --- |
| 07/07/2020 11:34:20 | Temperatura | 25 |
| 07/07/2020 11:34:20 | Umidità | 22 |
| 07/07/2020 10:32:20AM | Umidità | 29 |
Questa trasformazione ti aiuta a personalizzare la presentazione visiva dei tuoi dati per concentrarti sui dati più pertinenti.
## Unisci serie/tabelle
Utilizzate questa trasformazione per combinare il risultato di più interrogazioni in un unico risultato, il che è particolarmente utile quando si utilizza la visualizzazione del pannello tabellare. La trasformazione unisce i valori nella stessa riga se i campi condivisi contengono gli stessi dati.
Ecco un esempio di illustrazione dell'impatto della trasformazione **Merge series/tables** su due query che restituiscono dati di tabella:
*Interrogazione A:*
| Orario | Processo | Operatività |
| --- | --- | --- |
| 07/07/2020 11:34:20 | nodo | 25260122 |
| 07/07/2020 11:24:20 | locandina | 123001233 |
Interrogazione B:
| Orario | Processo | Errori |
| --- | --- | --- |
| 07/07/2020 11:34:20 | nodo | 15 |
| 07/07/2020 11:24:20 | locandina | 5 |
Ecco il risultato dopo aver applicato la trasformazione Merge:
| Orario | Processo | Errori | Operatività |
| --- | --- | --- | --- |
| 07/07/2020 11:34:20 | nodo | 15 | 25260122 |
| 07/07/2020 11:24:20 | locandina | 5 | 123001233 |
Questa trasformazione combina i valori della Query A e della Query B in una tabella unificata, migliorando la presentazione per una migliore comprensione.
## Organizza i campi per nome
Utilizzate questa trasformazione per rinominare, riordinare o nascondere i campi restituiti da una singola query nel pannello. Questa trasformazione funziona solo nei pannelli con una singola interrogazione. Se il pannello ha più interrogazioni, è necessario applicare una trasformazione *Outer join* o rimuovere le interrogazioni aggiuntive.
**Trasformazione dei campi**
Grafana mostra un elenco di campi restituiti dalla query. Puoi:
+ **Modifica l'ordine dei campi**: trascina un campo in una nuova posizione nell'elenco.
+ **Nascondi o mostra un campo**: utilizza l'icona a forma di occhio accanto al nome del campo per attivare o disattivare la visibilità di un campo.
+ **Rinomina campi****: digita un nuovo nome nella casella Rinomina.**
**Esempio**
Dato questo risultato iniziale della query:
| Orario | Metrica | 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 |
Puoi applicare una modifica del campo di ridenominazione per creare:
| Orario | Sensor | Leggere |
| --- | --- | --- |
| 2020-07-07 11:34:20 | Temperatura | 25 |
| 2020-07-07 11:34:20 | Umidità | 22 |
| 2020-07-07 10:32:20 | Umidità | 29 |
Questa trasformazione consente di personalizzare la visualizzazione dei risultati delle query, garantendo una rappresentazione chiara e approfondita dei dati in Grafana.
## Partizione per valori
Utilizzate questa trasformazione per semplificare il processo di rappresentazione grafica di più serie senza la necessità di più interrogazioni con clausole diverse. `WHERE`
**Nota**
Questa funzione è disponibile in aree di lavoro compatibili con Grafana versione 9 e successive.
Ciò è particolarmente utile quando si utilizza una tabella SQL di metriche, come in questo esempio:
| Orario | Region | Valore |
| --- | --- | --- |
| 20/10/2022 12:00:00 | US | 1520 |
| 20/10/2022 12:00:00 | UE | 2936 |
| 20/10/2022 1:00:00 | US | 1327 |
| 20/10/2022 1:00:00 | UE | 912 |
Con il trasformatore *Partition by values*, puoi emettere una singola query e dividere i risultati per valori univoci in una o più colonne (campi) a tua scelta. Nell'esempio seguente viene utilizzato `Region`.
```
SELECT Time, Region, Value FROM metrics WHERE Time > '2022-10-20'
```
| Orario | Region | Valore |
| --- | --- | --- |
| 20/10/2022 12:00:00 | US | 1520 |
| 20/10/2022 1:00:00 | US | 1327 |
| Orario | Region | Valore |
| --- | --- | --- |
| 20/10/2022 12:00:00 | UE | 2936 |
| 20/10/2022 1:00:00 | UE | 912 |
Questa trasformazione semplifica il processo e migliora la flessibilità di visualizzazione di più serie all'interno della stessa visualizzazione di serie temporali.
## Prepara le serie temporali
Utilizza questa trasformazione per risolvere i problemi quando un'origine dati restituisce dati di serie temporali in un formato non compatibile con la visualizzazione desiderata. Questa trasformazione consente di convertire i dati delle serie temporali tra formati ampi e lunghi.
**Serie temporali a più fotogrammi**
Utilizzate questa opzione per trasformare il frame di dati della serie temporale dal formato ampio al formato lungo. Ciò è particolarmente utile quando la fonte di dati fornisce informazioni sulle serie temporali in un formato che deve essere rimodellato per una compatibilità ottimale con la visualizzazione.
*Esempio*
Questo input:
| Time stamp | Value1 | Value2 |
| --- | --- | --- |
| 2023-01-01 00:00:00 | 10 | 20 |
| 2023-01-01 01:00:00 | 15 | 25 |
Potrebbe essere trasformato in:
| Time stamp | Variabile | Valore |
| --- | --- | --- |
| 2023-01-01 00:00:00 | Value1 | 10 |
| 2023-01-01 00:00:00 | Value2 | 20 |
| 2023-01-01 01:00:00 | Value1 | 15 |
| 2023-01-01 01:00:00 | Value2 | 25 |
**Ampie serie temporali**
Utilizzate questa opzione per trasformare il frame di dati della serie temporale dal formato lungo al formato ampio. Ciò è particolarmente utile quando la fonte di dati fornisce dati di serie temporali in un formato lungo e la visualizzazione richiede un formato ampio.
*Esempio*
Questo input:
| Time stamp | Variabile | Valore |
| --- | --- | --- |
| 2023-01-01 00:00:00 | Value1 | 10 |
| 2023-01-01 00:00:00 | Value2 | 20 |
| 2023-01-01 01:00:00 | Value1 | 15 |
| 2023-01-01 01:00:00 | Value2 | 25 |
Potrebbe essere trasformato in:
| Time stamp | Value1 | Value2 |
| --- | --- | --- |
| 2023-01-01 00:00:00 | 10 | 20 |
| 2023-01-01 01:00:00 | 15 | 25 |
## Ridurre
Usa questa trasformazione applica un calcolo a ciascun campo nel frame di dati e restituisce un singolo valore. Questa trasformazione è particolarmente utile per consolidare più dati di serie temporali in un formato riepilogativo più compatto. I campi temporali vengono rimossi quando si applica questa trasformazione.
Considerate l'input:
Interrogazione A:
| Orario | Temp | Operatività |
| --- | --- | --- |
| 2020-07-07 11:34:20 | 12.3 | 256122 |
| 2020-07-07 11:24:20 | 15,4 | 1230233 |
Interrogazione B:
| Orario | AQI | Errori |
| --- | --- | --- |
| 2020-07-07 11:34:20 | 6,5 | 15 |
| 2020-07-07 11:24:20 | 3.2 | 5 |
Il trasformatore di riduzione ha due modalità:
+ **Da serie a righe**: crea una riga per ogni campo e una colonna per ogni calcolo.
+ **Riduci campi**: mantiene la struttura del frame esistente, ma comprime ogni campo in un unico valore.
Ad esempio, se hai utilizzato il **primo** e **l'ultimo** calcolo con una trasformazione **da serie a righe**, il risultato sarebbe:
| Campo | Primo | Ultimo |
| --- | --- | --- |
| Temp | 12.3 | 15.4 |
| Operatività | 256122 | 1230233 |
| AQI | 6,5 | 3.2 |
| Errori | 15 | 5 |
I **campi Riduci** con l'**ultimo** calcolo restituiscono due frame, ciascuno con una riga:
Interrogazione A:
| Temp | Operatività |
| --- | --- |
| 15.4 | 1230233 |
Interrogazione B:
| AQI | Errori |
| --- | --- |
| 3.2 | 5 |
## 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. Potresti impostare l'espressione regolare su `([^\.]+)\..+` e il pattern sostitutivo su`$1`, `web-01.example.com` diventerebbe. `web-01`
Questa trasformazione consente di personalizzare i dati per soddisfare le esigenze di visualizzazione, rendendo le dashboard più informative e intuitive.
## Da righe a campi
Usa questa trasformazione per convertire le righe in campi separati. Ciò può essere utile perché 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:
+ Un campo da usare come origine dei nomi dei campi.
Per impostazione predefinita, la trasformazione utilizza il primo campo stringa come origine. Puoi sovrascrivere questa impostazione predefinita selezionando **Nome campo** nella colonna **Usa come** per il campo che desideri utilizzare invece.
+ Un campo da usare come fonte di valori.
Per impostazione predefinita, la trasformazione utilizza il primo campo numerico come origine. Tuttavia, puoi ignorare questa impostazione predefinita selezionando **Valore del campo** nella colonna **Usa come** per il campo che desideri utilizzare al suo posto.
Utile per visualizzare i dati in:
+ Gauge
+ Stat
+ Grafico a torta
**Associa campi aggiuntivi alle etichette**
Se un campo non è mappato alla proprietà di configurazione, Grafana lo utilizzerà automaticamente come fonte per un'etichetta sul campo di output.
Esempio:
| Name | DataCenter | Valore |
| --- | --- | --- |
| ServerA | US | 100 |
| Server B | UE | 200 |
Output:
| ServerA (etichette DataCenter: US) | ServerB (etichette: DataCenter: EU) |
| --- | --- |
| 100 | 200 |
Le etichette aggiuntive possono ora essere utilizzate nel nome visualizzato del campo 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:
| Name | Valore | Max |
| --- | --- | --- |
| ServerA | 10 | 100 |
| Server B | 20 | 200 |
| Server C | 30 | 300 |
Output:
| ServerA (configurazione: max=100) | ServerB (configurazione: max=200) | ServerC (configurazione: max=300) |
| --- | --- | --- |
| 10 | 20 | 30 |
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.
Questa trasformazione consente la conversione delle righe in singoli campi, facilita la configurazione dinamica dei campi e associa campi aggiuntivi alle etichette.
## Da serie a righe
Usa questa trasformazione per combinare il risultato 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 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:*
| 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 |
Ecco il risultato dopo aver applicato la trasformazione Series to rows.
| Orario | Metrica | 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 |
Questa trasformazione facilita il consolidamento dei risultati di più interrogazioni su serie temporali, fornendo un set di dati semplificato e unificato per analisi e visualizzazione efficienti in formato tabulare.
## Ordina per
Utilizzate questa trasformazione per ordinare ogni frame all'interno del risultato di una query in base a un campo specifico, semplificando la comprensione e l'analisi dei dati. Configurando il campo desiderato per l'ordinamento, puoi controllare l'ordine in cui i dati vengono presentati nella tabella o nella visualizzazione.
Utilizzate l'interruttore **Reverse** per ordinare inversamente i valori all'interno del campo specificato. Questa funzionalità è particolarmente utile quando si desidera passare rapidamente dall'ordine crescente a quello decrescente per soddisfare le proprie esigenze analitiche.
Ad esempio, in uno scenario in cui i dati di serie temporali vengono recuperati da una fonte di dati, è possibile applicare la trasformazione **Ordina** per disporre i frame di dati in base al timestamp, in ordine crescente o decrescente, a seconda dei requisiti analitici. Questa funzionalità consente di navigare e interpretare facilmente i dati delle serie temporali, ottenendo informazioni preziose dalla presentazione organizzata e visivamente coerente.
## Spatial
Utilizzate questa trasformazione per applicare operazioni spaziali ai risultati delle query.
+ **Azione**: seleziona un'azione:
+ **Prepara campo spaziale**: imposta un campo geometrico basato sui risultati di altri campi.
+ **Modalità di posizione**: seleziona una modalità di localizzazione (queste opzioni sono condivise dalle modalità **Calcola valore** e **Trasforma**):
+ **Automatico**: identifica automaticamente i dati sulla posizione in base ai nomi dei campi predefiniti.
+ **Coordinate:** specifica i campi di latitudine e longitudine.
+ **Geohash: specifica un campo geohash**.
+ **Ricerca: specifica i campi di posizione di** Gazetteer.
+ **Calcola valore**: utilizza la geometria per definire un nuovo campo (). heading/distance/area
+ **Funzione**: scegli un'operazione matematica da applicare alla geometria:
+ **Intestazione**: calcola la direzione tra due punti.
+ **Area**: calcola l'area racchiusa da un poligono definito dalla geometria.
+ **Distanza**: calcola la distanza tra due punti.
+ **Trasforma**: applica le operazioni spaziali alla geometria.
+ **Operazione** — Scegliete un'operazione da applicare alla geometria:
+ **Come linea**: crea una feature a linea singola con un vertice in ogni riga.
+ **Line Builder**: crea una linea tra due punti.
Questa trasformazione consente di manipolare e analizzare i dati geospaziali, abilitando operazioni come la creazione di linee tra i punti, il calcolo delle proprietà spaziali e altro ancora.
## Trasformazione da serie temporale a tabella
Utilizzate questa trasformazione per convertire i risultati delle serie temporali in una tabella, trasformando un frame di dati di serie temporali in un campo di **tendenza**. Il campo **Trend** può quindi essere renderizzato utilizzando il [tipo di cella sparkline](v10-panels-table.md#v10-panels-table-cell-type), generando un grafico sparkline in linea per ogni riga della tabella. Se sono presenti più interrogazioni relative a serie temporali, ciascuna genererà un frame di dati della tabella separato. Questi possono essere uniti utilizzando trasformazioni di unione o unione per produrre un'unica tabella con più sparkline per riga.
Per ogni valore del campo **Trend** generato, è possibile selezionare una funzione di calcolo. L'impostazione predefinita è **Ultimo valore non nullo**. Questo valore viene visualizzato accanto alla linea sparkline e utilizzato per ordinare le righe della tabella.
## Analisi della regressione
Utilizzate questa trasformazione per creare un nuovo frame di dati contenente i valori previsti da un modello statistico. Ciò è utile per individuare una tendenza nei dati caotici. Funziona adattando una funzione matematica ai dati, utilizzando la regressione lineare o polinomiale. Il frame di dati può quindi essere utilizzato in una visualizzazione per visualizzare una linea di tendenza.
Esistono due modelli diversi:
+ **Regressione lineare**: adatta una funzione lineare ai dati.
+ **Regressione polinomiale**: adatta una funzione polinomiale ai dati.
**Nota**
Questa trasformazione è attualmente disponibile in anteprima pubblica. Grafana Labs offre un supporto limitato e potrebbero verificarsi modifiche sostanziali prima che la funzionalità venga resa disponibile al pubblico.
# Risolvi i problemi relativi alle interrogazioni
****
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.md)
Per le aree di lavoro Grafana che supportano la versione 8.x di Grafana, vedere. [Funzionamento in Grafana versione 8](using-grafana-v8.md)
Questa pagina fornisce informazioni per risolvere i problemi più comuni del pannello di controllo.
**Ottengo risultati diversi quando riorganizzo le mie funzioni**
L'ordine delle funzioni è molto importante. Proprio come in matematica, l'ordine in cui vengono posizionate le funzioni può influire sul risultato.
**Esamina la richiesta e la risposta alla tua domanda**
I problemi più comuni riguardano l'interrogazione e la risposta provenienti dalla fonte dei dati. Anche se sembra un bug o un problema di visualizzazione in Grafana, è quasi sempre un problema con la query sulla fonte dei dati o la risposta della fonte dei dati. Inizia esaminando la domanda e la risposta del pannello.
Per ulteriori informazioni, consulta [Ispeziona i dati di richiesta e risposta](v10-panels-panel-inspector.md).
**La mia richiesta è lenta**
Quanti punti dati restituisce la tua query? Una query che restituisce molti punti dati sarà lenta. Prova questo:
+ Nelle **opzioni di query**, limita il **numero massimo di punti dati** restituiti.
+ Nelle **opzioni di interrogazione**, aumentate il tempo **di intervallo minimo**.
+ Nella tua interrogazione, usa una `group by` funzione.
# Tipi di calcolo
****
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.md)
Per le aree di lavoro Grafana che supportano la versione 8.x di Grafana, vedere. [Funzionamento in Grafana versione 8](using-grafana-v8.md)
La tabella seguente contiene un elenco di calcoli che è possibile eseguire in Grafana. Puoi trovare questi calcoli nella scheda **Trasforma** e nelle visualizzazioni degli indicatori a barre, degli indicatori e delle statistiche.
| Calcolo | Description |
| --- | --- |
| Tutti i valori nulli | Vero quando tutti i valori sono nulli |
| Tutti i valori | Array con tutti i valori |
| Tutti valori univoci | Array con tutti i valori univoci |
| Tutti gli zeri | Vero quando tutti i valori sono 0 |
| Numero di modifiche | Numero di volte in cui il valore del campo cambia |
| Conteggio | Numero di valori in un campo |
| Delta | Modifica cumulativa del valore, conta solo gli incrementi |
| Differenza | Differenza tra il primo e l'ultimo valore di un campo |
| Differenza percentuale | Variazione percentuale tra il primo e l'ultimo valore di un campo |
| Conteggio distinto | Numero di valori univoci in un campo |
| Primo | Primo valore in un campo |
| Primo\$1 (non nullo) | Innanzitutto, valore non nullo in un campo (esclude anche) NaNs |
| Ultimo | Ultimo valore in un campo |
| Ultimo\$1 (non nullo) | Ultimo valore non nullo in un campo (esclude anche) NaNs |
| Max | Valore massimo di un campo |
| Media | Valore medio di tutti i valori in un campo |
| Varianza | Varianza di tutti i valori in un campo |
| StdDev | Deviazione standard di tutti i valori in un campo |
| Min | Valore minimo di un campo |
| Min (sopra lo zero) | Valore minimo e positivo di un campo |
| Intervallo | Differenza tra i valori massimi e minimi di un campo |
| Fase | Intervallo minimo tra i valori di un campo |
| Totale | Somma di tutti i valori in un campo |