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à.
# Pannelli e visualizzazioni in Grafana versione 9
****
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 9.x di Grafana.**
Per le aree di lavoro Grafana che supportano la versione 10.x di Grafana, vedere. [Funzionamento nella versione 10 di Grafana](using-grafana-v10.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)
Il *pannello* è l'elemento base della visualizzazione in Grafana. Ogni pannello ha un editor di query specifico per la fonte di dati selezionata nel pannello. L'editor di query consente di creare una query che restituisce i dati che si desidera visualizzare.
Esiste un'ampia varietà di opzioni di stile e formattazione per ogni pannello. I pannelli possono essere trascinati, rilasciati e ridimensionati per riorganizzarli sulla dashboard.
Prima di aggiungere un pannello, assicurati di aver configurato una fonte di dati.
Potrebbero essere disponibili altri tipi di pannelli installando [plugin](grafana-plugins.md) aggiuntivi nell'area di lavoro.
+ Per informazioni dettagliate sull'utilizzo di fonti di dati specifiche, consulta. [Connessione alle origini dati](AMG-data-sources.md)
**Topics**
+ [Panoramica dell'editor di pannelli](v9-panels-editor-overview.md)
+ [Configura le opzioni del pannello](v9-panels-configure-panel-options.md)
+ [Configurazione delle opzioni standard](v9-panels-configure-standard-options.md)
+ [Interroga e trasforma i dati](v9-panels-query-xform.md)
+ [Configurare le soglie](v9-panels-configure-thresholds.md)
+ [Configurare i collegamenti dati](v9-panels-configure-data-links.md)
+ [Configura le sostituzioni dei campi](v9-panels-configure-overrides.md)
+ [Configurare le mappature dei valori](v9-panels-configure-value-mappings.md)
+ [Configurare una legenda](v9-panels-configure-legend.md)
+ [Tipi di calcolo](v9-panels-calculation-types.md)
+ [Annotazione delle visualizzazioni](v9-panels-annotate-visualizations.md)
+ [La vista di ispezione del pannello](v9-panels-panel-inspector.md)
+ [Visualizzazioni disponibili nella versione 9 di Grafana](v9-panels-viz.md)
# Panoramica dell'editor di pannelli
****
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 9.x di Grafana.**
Per le aree di lavoro Grafana che supportano la versione 10.x di Grafana, vedere. [Funzionamento nella versione 10 di Grafana](using-grafana-v10.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 sezione descrive le aree dell'editor del pannello Grafana.
+ Intestazione del pannello: la sezione header elenca la dashboard in cui viene visualizzato il pannello e i seguenti controlli:
+ **Icona delle impostazioni della dashboard (ingranaggio):** fai clic per accedere alle impostazioni della dashboard.
+ **Ignora: elimina** le modifiche apportate al pannello dall'ultima volta che hai salvato la dashboard.
+ **Salva:** salva le modifiche apportate al pannello.
+ **Applica:** applica le modifiche apportate e chiude l'editor del pannello, riportandoti alla dashboard. Dovrai salvare la dashboard per rendere permanenti le modifiche applicate.
+ Anteprima della visualizzazione: la sezione di anteprima della visualizzazione contiene le seguenti opzioni:
+ **Visualizzazione tabella:** converte qualsiasi visualizzazione in una tabella in modo da poter vedere i dati. Le viste tabellari sono utili per la risoluzione dei problemi. Questa vista contiene solo i dati grezzi. Non include le trasformazioni che potresti aver applicato ai dati o le opzioni di formattazione disponibili nella visualizzazione della [tabella](v9-panels-table.md).
+ **Riempimento:** l'anteprima della visualizzazione riempie lo spazio disponibile. Se si modifica la larghezza del riquadro laterale o l'altezza del riquadro inferiore, la visualizzazione cambia per occupare lo spazio disponibile.
+ **Effettiva:** l'anteprima della visualizzazione avrà le dimensioni esatte di quelle sulla dashboard. Se lo spazio disponibile non è sufficiente, la visualizzazione verrà ridimensionata preservando le proporzioni.
+ **Controlli dell'intervallo di tempo:** l'**impostazione predefinita** è il fuso orario locale del browser o il fuso orario selezionato a un livello superiore.
+ Sezione dati: la sezione dati contiene schede in cui è possibile immettere interrogazioni, trasformare i dati e creare regole di avviso (se applicabile).
+ **Scheda Query:** seleziona la tua fonte di dati e inserisci le domande qui.
+ **Scheda Trasforma:** applica le trasformazioni dei dati.
+ **Scheda Avviso:** scrivi le regole di avviso.
+ Opzioni di visualizzazione del pannello: la sezione delle opzioni di visualizzazione contiene schede in cui è possibile configurare quasi ogni aspetto della visualizzazione dei dati.
## Apri il pannello, ispeziona il cassetto
Il cassetto di ispezione consente di comprendere e risolvere i problemi dei pannelli. È possibile visualizzare i dati grezzi di qualsiasi pannello, esportarli in un file con valori separati da virgole (CSV), visualizzare le richieste di interrogazione ed esportare pannelli e dati in formato JSON.
**Nota:** non tutti i tipi di pannello includono tutte le schede. Ad esempio, i pannelli con l'elenco delle dashboard non contengono dati grezzi da esaminare, quindi non visualizzano le schede Statistiche, Dati o Query.
L'ispettore del pannello include le seguenti opzioni:
+ Il pannello Inspect Drawer Display apre un cassetto sul lato destro. Fate clic sulla freccia nell'angolo superiore destro per espandere o ridurre il riquadro del cassetto.
+ **Scheda Dati:** mostra i dati grezzi restituiti dall'interrogazione con le trasformazioni applicate. Le opzioni di campo come le sostituzioni e le mappature dei valori non vengono applicate per impostazione predefinita.
+ **Scheda Statistiche:** mostra quanto tempo impiega la query e quanto restituisce.
+ **Scheda JSON:** consente di visualizzare e copiare il pannello JSON, i dati del pannello JSON e la struttura del frame di dati JSON. Ciò è utile se si esegue il provisioning o la somministrazione di Grafana.
+ **Scheda Query:** mostra le richieste al server inviate quando Grafana interroga l'origine dati.
+ **Scheda Errore:** mostra l'errore. Visibile solo quando la query restituisce un errore.
# Configura le opzioni del pannello
****
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 9.x di Grafana.**
Per le aree di lavoro Grafana che supportano la versione 10.x di Grafana, vedere. [Funzionamento nella versione 10 di Grafana](using-grafana-v10.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)
Un pannello Grafana è l'interfaccia utente utilizzata per definire una query sull'origine dati e trasformare e formattare i dati che appaiono nelle visualizzazioni.
Un editor di pannelli include un generatore di query e una serie di opzioni che potete usare per trasformare i dati e aggiungere informazioni ai pannelli.
Questo argomento descrive come:
+ Aprire un pannello per la modifica
+ Aggiungi un titolo e una descrizione del pannello
+ Visualizza un modello JSON di un pannello
+ Aggiungi righe e pannelli ripetuti
## Modificare un pannello
Dopo aver aggiunto un pannello a una dashboard, puoi aprirlo in qualsiasi momento per modificare, modificare o aggiornare le interrogazioni, aggiungere la trasformazione dei dati e modificare le impostazioni di visualizzazione.
1. Apri la dashboard che contiene il pannello che desideri modificare.
1. Passa il mouse su qualsiasi parte del pannello per visualizzare il menu delle azioni nell'angolo in alto a destra.
1. Fai clic sul menu e seleziona **Modifica**.
**Per usare una scorciatoia da tastiera per aprire il pannello, passa il mouse sul pannello e premi e.**
Il pannello si apre in modalità di modifica.
## Aggiungere un titolo e una descrizione a un pannello
Aggiungi un titolo e una descrizione a un pannello per condividere con gli utenti tutte le informazioni importanti sulla visualizzazione. Ad esempio, utilizza la descrizione per documentare lo scopo della visualizzazione.
1. Modifica un pannello.
1. Nel riquadro delle opzioni di visualizzazione del pannello, individua la sezione **Opzioni del pannello**.
1. Inserisci un **titolo**.
Il testo inserito in questo campo viene visualizzato nella parte superiore del pannello nell'editor dei pannelli e nella dashboard.
1. Scrivi una descrizione del pannello e dei dati che stai visualizzando.
Il testo inserito in questo campo viene visualizzato in un tooltip nell'angolo superiore sinistro del pannello.
[È possibile utilizzare [le variabili definite](v9-dash-variables.md) nel campo **Titolo** e **Descrizione**, ma non variabili globali.](v9-dash-variable-add.md#v9-dash-variable-add-global)
## Visualizza un modello JSON a pannello
Esplora ed esporta modelli JSON di pannelli, pannelli e frame di dati.
1. Apri la dashboard che contiene il pannello.
1. Passa il mouse su qualsiasi parte del pannello per visualizzare il menu delle azioni nell'angolo in alto a destra.
1. Fai clic sul menu e seleziona **Ispeziona > Pannello JSON**.
1. Nel campo **Seleziona sorgente**, seleziona una delle seguenti opzioni:
+ **Pannello JSON:** visualizza un oggetto JSON che rappresenta il pannello.
+ **Dati del pannello:** visualizza un oggetto JSON che rappresenta i dati passati al pannello.
+ **DataFrame struttura:** Visualizza il set di risultati non elaborato con trasformazioni, configurazioni di campo e configurazioni di override applicate.
1. Per esplorare il formato JSON, fate clic su **>** per espandere o comprimere parti del modello JSON.
## Configura i pannelli ripetuti
Puoi configurare Grafana per aggiungere dinamicamente pannelli o righe a una dashboard. Un pannello dinamico è un pannello che il sistema crea in base al valore di una variabile. Le variabili modificano dinamicamente le tue interrogazioni su tutti i pannelli di una dashboard.
**Nota**
I pannelli ripetuti richiedono che le variabili abbiano uno o più elementi selezionati; non è possibile ripetere un pannello zero volte per nasconderlo.
**Prima di iniziare:**
+ Assicurati che l'interrogazione includa una variabile multivalore.
**Per configurare i pannelli ripetuti:**
1. Modifica il pannello che desideri ripetere.
1. Nel riquadro delle opzioni di visualizzazione, fate clic su **Opzioni del pannello > Opzioni di ripetizione**.
1. Seleziona una **direzione**.
+ Scegliete **orizzontale** per disporre i pannelli side-by-side. Grafana regola la larghezza di un pannello ripetuto. Attualmente, non è possibile combinare altri pannelli su una riga con un pannello ripetuto.
+ Scegliete **verticale** per disporre i pannelli in una colonna. La larghezza dei pannelli ripetuti è la stessa del pannello originale ripetuto.
1. Per propagare le modifiche a tutti i pannelli, ricarica la dashboard.
# Configurazione delle opzioni standard
****
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 9.x di Grafana.**
Per le aree di lavoro Grafana che supportano la versione 10.x di Grafana, vedere. [Funzionamento nella versione 10 di Grafana](using-grafana-v10.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)
Il modello di dati utilizzato in Grafana è una struttura tabellare orientata a colonne che unifica sia le serie temporali che i risultati delle query tabellari. *Ogni colonna all'interno di questa struttura è chiamata campo.* Un campo può rappresentare una singola serie temporale o colonna di tabella.
Le opzioni di campo consentono di modificare la modalità di visualizzazione dei dati nelle visualizzazioni. Le opzioni e le sostituzioni applicate non modificano i dati, ma il modo in cui Grafana li visualizza. Quando si modifica un'opzione, questa viene applicata a tutti i campi, ovvero a tutte le serie o colonne. Ad esempio, se si modifica l'unità in percentuale, tutti i campi con valori numerici vengono visualizzati in percentuale.
Per un elenco completo delle opzioni di formattazione dei campi, consulta Definizioni delle opzioni [standard](#v9-panels-standard-options-definitions).
**Nota**
È possibile applicare opzioni standard alla maggior parte dei pannelli Grafana integrati. Ad alcuni vecchi pannelli e pannelli della community che non sono stati aggiornati al nuovo pannello e al nuovo modello di dati mancheranno tutte o alcune di queste opzioni di campo.
1. Apri una dashboard, fai clic sul titolo del pannello e fai clic su **Modifica**.
1. Nel riquadro delle opzioni di visualizzazione del pannello, individua la sezione **Opzioni standard**.
1. Seleziona le opzioni standard che desideri applicare.
1. Per visualizzare l'anteprima della modifica, fai clic all'esterno della casella delle opzioni di campo che stai modificando o premi **Invio**.
## Definizioni delle opzioni standard
Questa sezione spiega tutte le opzioni standard disponibili.
È possibile applicare opzioni standard alla maggior parte dei pannelli Grafana integrati. Ad alcuni vecchi pannelli e pannelli della community che non sono stati aggiornati al nuovo pannello e al nuovo modello di dati mancheranno tutte o alcune di queste opzioni di campo.
La maggior parte delle opzioni di campo non influirà sulla visualizzazione finché non si fa clic all'esterno della casella delle opzioni di campo che si sta modificando o si preme Invio.
**Nota**
Lavoriamo costantemente per aggiungere ed espandere le opzioni per tutte le visualizzazioni, pertanto tutte le opzioni potrebbero non essere disponibili per tutte le visualizzazioni.
### Unità
Consente di scegliere l'unità da utilizzare in un campo. Fai clic nel campo **Unità**, quindi esegui il drill-down fino a trovare l'unità desiderata. L'unità selezionata viene applicata a tutti i campi tranne il tempo.
#### Unità personalizzate
Puoi utilizzare il menu a discesa delle unità per specificare anche unità personalizzate, prefisso o suffisso personalizzati e formati di data e ora.
Per selezionare un'unità personalizzata, inserisci l'unità e seleziona l'ultima opzione **Custom: xxx** nel menu a discesa.
+ **suffisso:** per l'unità personalizzata che deve seguire il valore.
+ **prefisso:** per l'unità personalizzata che deve precedere il valore.
+ **ora:** per formati di data e ora personalizzati, digita ad esempio **time:YYYYY-MM-DD**. [Vedi i formati per la sintassi e le opzioni del formato.](https://momentjs.com/docs/#/displaying/)
+ **si:** per unità SI personalizzate. Ad esempio: **si: mF.** Questo è un po' più avanzato in quanto consente di specificare sia un'unità che la scala dei dati di origine. Quindi, se i dati di origine sono rappresentati come milli (migliaia di) qualcosa, prefiggi l'unità con quel carattere di scala SI.
+ **count:** per un'unità di conteggio personalizzata.
+ **valuta:** per personalizzare un'unità monetaria.
Puoi anche incollare un'emoji nativa nel selettore di unità e sceglierla come unità personalizzata.
#### Unità di stringa
Grafana a volte può essere troppo aggressivo nell'analizzare le stringhe e visualizzarle come numeri. **Per configurare Grafana in modo che mostri il valore della stringa originale, crea un campo override e aggiungi una proprietà di unità con l'unità String.**
### Min
Consente di impostare il valore minimo utilizzato nei calcoli della soglia percentuale. Lascia vuoto per il calcolo automatico basato su tutte le serie e i campi.
### Max
Consente di impostare il valore massimo utilizzato nei calcoli della soglia percentuale. Lascia vuoto per il calcolo automatico basato su tutte le serie e i campi.
### Decimali
Specificate il numero di decimali che Grafana include nel valore renderizzato. Se lasci vuoto questo campo, Grafana tronca automaticamente il numero di decimali in base al valore. Ad esempio 1.1234 verrà visualizzato come 1,12 e 100.456 verrà visualizzato come 100.
**Per visualizzare tutti i decimali, imposta l'unità su String.**
### Display name (Nome visualizzato)
Consente di impostare il titolo di visualizzazione di tutti i campi. È possibile utilizzare [variabili](v9-dash-variables.md).
Quando vengono visualizzate più statistiche, campi o serie, questo campo controlla il titolo di ogni statistica. Puoi usare espressioni come **\$1 \$1\$1\$1field.name\$1 per usare solo il nome** della serie o il nome del campo nel titolo.
Viene fornito un campo con il nome Temp e le etichette \$1"loc"="PBI», «Sensor"="3"\$1
| Sintassi delle espressioni | Esempio | Renderizza su | Spiegazione |
| --- | --- | --- | --- |
| \$1 \$1\$1\$1field.displayName\$1 | Uguale alla sintassi | Temperatura \$1loc="PBI», Sensor="3"\$1 | Visualizza il nome del campo e le etichette in \$1\$1, se presenti. Se nella risposta è presente una sola chiave di etichetta, per la parte dell'etichetta, Grafana visualizza il valore dell'etichetta senza le parentesi racchiuse. |
| \$1 \$1\$1\$1field.name\$1 | Uguale alla sintassi | Temp | Visualizza il nome del campo (senza etichette). |
| \$1 \$1\$1\$1field.labels\$1 | Uguale alla sintassi | loc="PBI», Sensore="3" | Visualizza le etichette senza il nome. |
| \$1 \$1\$1\$1field.labels.x\$1 | \$1 \$1\$1\$1field.labels.loc\$1 | PBI | Visualizza il valore della chiave dell'etichetta specificata. |
| \$1 \$1\$1\$1field.labels. \$1\$1valori\$1 | Uguale alla sintassi | PBI, 3 | Visualizza i valori delle etichette separate da una virgola (senza chiavi di etichetta). |
Se il valore è una stringa vuota dopo il rendering dell'espressione per un determinato campo, viene utilizzato il metodo di visualizzazione predefinito.
### Combinazione di colori
Le opzioni di colore e il relativo effetto sulla visualizzazione dipendono dalla visualizzazione con cui si sta lavorando. Alcune visualizzazioni hanno diverse opzioni di colore.
È possibile specificare un singolo colore o selezionare uno schema di colori continuo (sfumato), in base a un valore. Il colore continuo interpola un colore utilizzando la percentuale di un valore rispetto ai valori min e max.
Selezionate una delle seguenti palette:
| modalità a colori | Description |
| --- | --- |
| Colore singolo | Specificate un solo colore, utile in una regola di override |
| Dalle soglie | Informa Grafana di prendere il colore dalla soglia corrispondente |
| Palette classica | Grafana assegnerà il colore cercando un colore in una tavolozza per indice di serie. Utile per grafici, diagrammi a torta e altre visualizzazioni di dati categoriali |
| Green-Yellow-Red (per valore) | Combinazione di colori continua |
| Blue-Yellow-Red (per valore) | Combinazione di colori continua |
| Blues (per valore) | Combinazione di colori continua (sfondo del pannello in blu) |
| Rossi (per valore) | Combinazione di colori continua (lo sfondo del pannello diventa blu) |
| Verdi (per valore) | Combinazione di colori continua (lo sfondo del pannello diventa blu) |
| Viola (in base al valore) | Combinazione di colori continua (lo sfondo del pannello diventa blu) |
### Nessun valore
Inserisci cosa Grafana deve mostrare se il valore del campo è vuoto o nullo. Il valore predefinito è un trattino (-).
# Interroga e trasforma i dati
****
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 9.x di Grafana.**
Per le aree di lavoro Grafana che supportano la versione 10.x di Grafana, vedere. [Funzionamento nella versione 10 di Grafana](using-grafana-v10.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 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 query e i plug-in di origine dati implementano ciascuno un'interfaccia utente per la creazione di query chiamata editor di query.
## 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 interrogazione 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 fonte di dati, consulta la relativa documentazione:
+ Per le fonti di dati incluse in Grafana, vedi Origini [dati integrate](AMG-data-sources-builtin.md).
+ Per le fonti di dati incluse nell'edizione Grafana Enterprise, vedere. [Connect a fonti di dati aziendali](AMG-data-sources-enterprise.md)
**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 i dettagli, consulta Fonti di dati
## Naviga nella scheda Query
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 domande che hai scritto.
+ **Espressioni:** — Utilizza il generatore di espressioni per creare espressioni di avviso. Per ulteriori informazioni sulle espressioni, consulta [Scrivere interrogazioni sulle espressioni](v9-panels-query-xform-expressions.md).
## Aggiungere un'interrogazione
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](#v9-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, rimuovere una query, riordinare le interrogazioni 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. Ad esempio, Loki trasmette i dati in modalità live tailing.
+ **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](v9-dash-variable-add.md#v9-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/v9-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/v9-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 9.x di Grafana.**
Per le aree di lavoro Grafana che supportano la versione 10.x di Grafana, vedere. [Funzionamento nella versione 10 di Grafana](using-grafana-v10.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 utilizzate principalmente da [Grafana](v9-alerts.md) Alerting. 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 origini dati di backend. Si presume generalmente che i dati siano etichettati come dati di serie temporali. In futuro intendevamo aggiungere un'asserzione del tipo di dati restituito dalla query (numero o serie temporale) in modo che le espressioni possano gestire meglio gli errori.
Le query relative alle 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:
| Loc | Host | AVG\$1CPU |
| --- | --- | --- |
| MIA | A | 1 |
| NYC | B | 2 |
L'esempio precedente produrrà 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 il valore 1.
**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 es.). `-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 OP = numero
+ Numero serie OP = serie
+ Serie OP = 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 sono matematiche esatte, 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` è `{host=A}` etichettato, si 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 hai bisogno di 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 esiste 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. Questa operazione può essere eseguita 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` secondi, `m` minuti, `h` ore, giorni, `d` settimane e `w` anni. `y`
+ **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 conosciuto
+ **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. [Nessuna gestione di dati o casi di errore](v9-alerting-managerules-grafana.md#v9-alerting-rule-no-data-error)
# Condividi i risultati delle query con un altro pannello
****
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 9.x di Grafana.**
Per le aree di lavoro Grafana che supportano la versione 10.x di Grafana, vedere. [Funzionamento nella versione 10 di Grafana](using-grafana-v10.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 una dashboard](v9-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 **TestData**dati, che restituisce una serie temporale casuale che puoi utilizzare per i test.
1. Aggiungi un secondo pannello e seleziona l'origine 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 9.x di Grafana.**
Per le aree di lavoro Grafana che supportano la versione 10.x di Grafana, vedere. [Funzionamento nella versione 10 di Grafana](using-grafana-v10.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.
**Per aggiungere una trasformazione a un pannello**
1. Vai al pannello in cui desideri aggiungere una o più trasformazioni.
1. Scegliete il titolo del pannello e fate clic su **Modifica**.
1. Seleziona la scheda **Transform** (Trasformazione).
1. Scegli 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 del bug sul lato destro della riga di trasformazione.
I set di risultati di input e output possono aiutarti a eseguire il debug di una trasformazione.
## Eliminare una trasformazione
Ti consigliamo di rimuovere le trasformazioni che non ti servono. Quando elimini una trasformazione, rimuovi i dati dalla visualizzazione.
Prerequisiti:
Identifica tutte le dashboard che si basano sulla trasformazione e informa gli utenti della dashboard interessati.
**Per eliminare una trasformazione**
1. Aprire un pannello per modificarlo.
1. Seleziona la scheda **Transform** (Trasformazione).
1. Scegli l'icona del cestino accanto alla trasformazione che desideri eliminare.
## Funzioni di trasformazione
È possibile eseguire le seguenti trasformazioni sui dati.
**Aggiungi campo dal calcolo**
Usa questa trasformazione per aggiungere un nuovo campo calcolato da altri due campi. Ogni trasformazione consente di aggiungere un nuovo campo.
+ **Modalità**: seleziona una modalità:
+ **Riduci riga**: applica il calcolo selezionato su ciascuna riga di campi selezionati in modo indipendente.
+ **Opzione binaria**: applica operazioni matematiche di base (somma, moltiplica, ecc.) 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**: se si seleziona **la modalità Riduci righe**, viene visualizzato il campo **Calcolo**. Fai clic sul campo per visualizzare un elenco di scelte di calcolo che puoi utilizzare per creare il nuovo campo. Per informazioni sui calcoli disponibili, consulta [Tipi di calcolo](v9-panels-calculation-types.md).
+ **Operazione**: se si seleziona la modalità **opzione binaria**, 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.
+ **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.
**Concatena i campi**
Questa trasformazione combina tutti i campi di tutti i frame in un unico risultato. Considerate queste due domande.
Interrogazione A:
| Temp | Tempo di 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 |
**Config dai risultati della query**
Questa trasformazione consente di selezionare una query e da essa estrarre opzioni standard come **Min**, **Max**, **Unit** e **Thresholds** e applicarle ad altri risultati della query. Ciò consente una configurazione dinamica della visualizzazione basata sulle query.
Se desideri estrarre una configurazione unica per ogni riga del risultato della query di configurazione, prova la trasformazione da righe a campi.
**Opzioni**
+ **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**: in genere un tipo di campo o un'espressione regolare del nome di campo a seconda dell'opzione selezionata in **Applica a**.
**Converti il tipo di campo**
Questa trasformazione modifica il tipo di campo del campo specificato.
+ **Campo**: seleziona uno dei campi disponibili
+ **as**: seleziona il formato FieldType in cui 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 un DateFormat come input da una stringa come yyyy-mm-dd o DD MM YYYY hh:mm:ss
+ **Booleano: renderà i valori booleani**
Ad esempio, è possibile modificare la seguente query selezionando il campo orario come Ora e il formato della data come YYYY.
| Orario | Segna | Valore |
| --- | --- | --- |
| 01/07/2017 | sopra | 25 |
| 02/08/2018 | sotto | 22 |
| 02/09/2019 | sotto | 29 |
| 04/10/2020 | sopra | 22 |
Il risultato:
| Orario | Mark | Valore |
| --- | --- | --- |
| 1/1/2017 | sopra | 25 |
| 1/1/2018 | sotto | 22 |
| 1/1/2019 | sotto | 29 |
| 1/1/2020 | sopra | 22 |
**Filtra i dati per nome**
Utilizzate questa trasformazione per rimuovere parti dei risultati della query.
Grafana visualizza il campo **Identificatore**, seguito dai campi restituiti dalla query.
Puoi applicare i filtri in due modi:
+ 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.
Grafana visualizza le lettere di identificazione della query in testo grigio scuro. Fai clic su un identificatore di query per attivare il filtro. Se la lettera di interrogazione è bianca, vengono visualizzati i risultati. Se la lettera di interrogazione è scura, i risultati vengono nascosti.
**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 valore**
Questa trasformazione consente di filtrare i dati direttamente in Grafana e rimuovere alcuni punti dati dai risultati della query. Hai la possibilità di includere o escludere i dati che soddisfano una o più condizioni da te definite. Le condizioni vengono applicate a un campo selezionato.
Questa trasformazione è utile se l'origine dati non filtra nativamente in base ai valori. È inoltre possibile utilizzarla per restringere i valori da visualizzare se si utilizza una query condivisa.
Le condizioni disponibili per tutti i campi sono:
+ **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:
+ **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 il minimo e il massimo
Considerate il seguente set di dati:
| Orario | Temperatura | Altitude (Altitudine) |
| --- | --- | --- |
| 07/07/2020 11:34:23 | 32 | 101 |
| 07/07/2020 11:34:22 | 28 | 125 |
| 07/07/2020 11:34:21 | 26 | 110 |
| 07/07/2020 11:34:20 | 23 | 98 |
| 07/07/2020 10:32:24 | 31 | 95 |
| 07/07/2020 10:31:22 | 20 | 85 |
| 07/07/2020 9:30:57 | 19 | 101 |
Se **includi** i punti dati con una temperatura inferiore a 30°C, la configurazione sarà la seguente:
+ **Tipo di filtro:** `Include`
+ **Condizione**: righe in cui `Temperature` corrispondono `Lower Than 30`
E otterrete il seguente risultato, in cui sono incluse solo le temperature inferiori a 30°C:
| Orario | Temperatura | Altitude (Altitudine) |
| --- | --- | --- |
| 07/07/2020 11:34:22 | 28 | 125 |
| 07/07/2020 11:34:21 | 26 | 110 |
| 07/07/2020 11:34:20 | 23 | 98 |
| 07/07/2020 10:31:22 | 20 | 85 |
| 07/07/2020 9:30:57 | 19 | 101 |
Puoi aggiungere più di una condizione al filtro. Ad esempio, potresti voler includere i dati solo se l'altitudine è maggiore di 100. A tale scopo, aggiungi tale condizione alla seguente configurazione:
+ Tipo di filtro: `Include` righe che `Match All` condizionano
+ Condizione 1: righe in cui `Temperature` corrisponde `Lower` a `30`
+ Condizione 2 - Righe in cui `Altitude` corrisponde `Greater` a `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 **soddisfano** una delle condizioni che hai aggiunto.
Nell'esempio precedente abbiamo scelto **Abbina tutto** perché volevamo includere le righe che hanno una temperatura inferiore a 30 E un'altitudine superiore a 100. Se volessimo invece includere le righe che hanno una temperatura inferiore a 30 O un'altitudine superiore a 100, selezioneremmo **Match any**. Ciò includerebbe la prima riga dei dati originali, che ha una temperatura di 32°C (non corrisponde alla prima condizione) ma un'altitudine di 101 (che corrisponde alla seconda condizione), quindi è inclusa.
Le condizioni non valide o configurate in modo incompleto vengono ignorate.
**Gruppo da**
Questa trasformazione raggruppa i dati in base a un valore di campo (colonna) specificato ed elabora i calcoli su ciascun gruppo. Fai clic per visualizzare un elenco di scelte di calcolo.
Ecco un esempio di dati originali.
| 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.
**Partecipa per campo**
Usa questa trasformazione per unire più risultati in un'unica tabella. Ciò è particolarmente utile per convertire i risultati di più serie temporali in un'unica tabella ampia con un campo temporale condiviso.
*Connessione interna*
Un inner join unisce i dati di più tabelle in cui tutte le tabelle condividono lo stesso valore del campo selezionato. Questo tipo di join esclude i dati in cui i valori non corrispondono in tutti i risultati.
Utilizzate questa trasformazione per combinare i risultati di più query (combinati su un campo di join passato o sulla prima colonna time) in un unico risultato e rilasciate le righe in cui un'unione non può avvenire con successo.
Nell'esempio seguente, due query restituiscono i dati della tabella. Viene visualizzato come due tabelle separate prima di applicare la trasformazione Inner Join.
Interrogazione A:
| Orario | Processo | Tempo di 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 | Tempo di 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 |
**Etichette per i campi**
Questa trasformazione modifica i risultati delle serie temporali che includono etichette o tag in una tabella in cui le chiavi e i valori di ogni etichetta sono inclusi nel risultato della tabella. Le etichette possono essere visualizzate come colonne o come valori di riga.
Dato il risultato di una query di due serie temporali:
+ Serie 1: etichette Server=Server A, Datacenter=EU
+ Serie 2 — etichette Server=Server B, Datacenter=EU
In modalità **Columns**, 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.
**Nota**
La trasformazione di *fusione* può essere utilizzata da sola ed è descritta in dettaglio di seguito.
Per illustrare ciò, ecco un esempio in cui sono presenti due query che restituiscono serie temporali senza etichette sovrapposte.
+ Serie 1 — labels server=Servera
+ Serie 2 — labels datacenter=EU
Ciò risulterà innanzitutto in queste due tabelle:
| Orario | Server | Valore |
| --- | --- | --- |
| 07/07/2020 11:34:20 | Servire 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 | Servire A | 10 | |
| 07/07/2020 11:34:20 | | 20 | UE |
**Unione**
Utilizzate questa trasformazione per combinare il risultato di più interrogazioni in un unico risultato. Ciò è utile quando si utilizza la visualizzazione del pannello tabellare. I valori che possono essere uniti vengono combinati nella stessa riga. I valori sono unibili se i campi condivisi contengono gli stessi dati.
Nell'esempio seguente, abbiamo due query che restituiscono i dati della tabella. Viene visualizzato come due tabelle separate prima di applicare la trasformazione.
Interrogazione A:
| Orario | Processo | Tempo di 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 |
**Organizza i campi**
Utilizzate questa trasformazione per rinominare, riordinare o nascondere i campi restituiti dalla query.
**Nota**
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.
Grafana mostra un elenco di campi restituiti dalla query. Puoi:
+ Modifica l'ordine dei campi posizionando il cursore su un campo. Il cursore si trasforma in una mano e quindi puoi trascinare il campo nella nuova posizione.
+ Nascondi o mostra un campo facendo clic sull'icona a forma di occhio accanto al nome del campo.
+ Rinomina i campi digitando un nuovo nome nella casella Rinomina.
**Partizione per valori**
Questa trasformazione può aiutare a eliminare la necessità di più query sulla stessa origine dati con `WHERE` clausole diverse quando si rappresentano graficamente più serie. Prendi in considerazione una tabella SQL di metriche con i seguenti dati:
| 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 |
Prima della versione 9.3, se volevi tracciare una linea di tendenza rossa per gli Stati Uniti e una blu per l'UE nello stesso TimeSeries pannello, probabilmente dovevi suddividerla in due domande:
```
SELECT Time, Value FROM metrics WHERE Time > '2022-10-20' AND Region='US'
SELECT Time, Value FROM metrics WHERE Time > '2022-10-20' AND Region='EU'
```
Ciò richiede anche che tu sappia in anticipo quali regioni esistono effettivamente nella tabella delle metriche.
Con il trasformatore *Partition by values*, ora puoi emettere una singola query e dividere i risultati per valori univoci in una o più colonne (`fields`) a tua scelta. Nell'esempio seguente viene utilizzato `Region`.
```
SELECT Time, Region, Value FROM metrics WHERE Time > '2022-10-20'
```
| 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 |
**Ridurre**
La trasformazione *Reduce* applica un calcolo a ogni campo del frame e restituisce un singolo valore. I campi relativi all'ora vengono rimossi quando si applica questa trasformazione.
Considerate l'input:
Interrogazione A:
| Orario | Temp | Tempo di operatività |
| --- | --- | --- |
| 07/07/2020 11:34:20 | 12.3 | 256122 |
| 07/07/2020 11:24:20 | 15,4 | 1230233 |
Interrogazione B:
| Orario | AQI | Errori |
| --- | --- | --- |
| 07/07/2020 11:34:20 | 6,5 | 15 |
| 07/07/2020 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 | Tempo di 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. È possibile impostare l'espressione regolare su `([^\.]+)\..+` e il pattern sostitutivo su`$1`, `web-01.example.com` diventerebbe. `web-01`
**Da righe a campi**
La trasformazione da righe a campi converte le righe in campi separati. Ciò può essere utile in quanto i campi possono essere modificati e configurati individualmente. Può anche utilizzare campi aggiuntivi come fonti per la configurazione dinamica dei campi o mapparli alle etichette dei campi. Le etichette aggiuntive possono quindi essere utilizzate per definire nomi di visualizzazione migliori per i campi risultanti.
Questa trasformazione include una tabella di campi che elenca tutti i campi nei dati restituiti dalla query di configurazione. Questa tabella consente di controllare quale campo deve essere mappato a ciascuna proprietà di configurazione (l'opzione\$1Usa come\$1\$1). 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 al suo posto.
+ 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 sorgente 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) |
| --- | --- |
| 10 | 20 |
Le etichette aggiuntive possono ora essere utilizzate nel campo Nome visualizzato per fornire nomi di campo più completi.
Se vuoi estrarre la configurazione da una query e applicarla a un'altra, dovresti usare la configurazione dalla trasformazione dei risultati della query.
*Esempio*
Input:
| 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.
**Prepara le serie temporali**
La preparazione della trasformazione delle serie temporali è utile quando un'origine dati restituisce dati di serie temporali in un formato non supportato dal pannello che si desidera utilizzare.
Questa trasformazione consente di risolvere questo problema convertendo i dati delle serie temporali dal formato ampio al formato lungo o viceversa.
Seleziona l'opzione **Serie temporale a più fotogrammi** per trasformare l'intervallo di dati delle serie temporali dal formato ampio a quello lungo.
Seleziona l'opzione **Wide time series** per trasformare il frame di dati delle serie temporali dal formato lungo a quello ampio.
**Da serie a righe**
Utilizzate questa trasformazione per combinare il risultato di più interrogazioni di dati su serie temporali in un unico risultato. Ciò è utile quando si utilizza la visualizzazione del pannello tabellare.
Il risultato di questa trasformazione conterrà tre colonne: Time, Metric e Value. La colonna Metrica viene aggiunta in modo da poter vedere facilmente da quale query proviene la metrica. Personalizza questo valore definendo Label nella query di origine.
Nell'esempio seguente, abbiamo due query che restituiscono dati di serie temporali. Viene visualizzato come due tabelle separate prima di applicare la trasformazione.
Interrogazione A:
| Orario | Temperatura |
| --- | --- |
| 07/07/2020 11:34:20 | 25 |
| 07/07/2020 10:31:22 | 22 |
| 07/07/2020 9:30:05 | 19 |
Interrogazione B:
| Orario | Umidità |
| --- | --- |
| 07/07/2020 11:34:20AM | 24 |
| 07/07/2020 10:32:20 | 29 |
| 07/07/2020 9:30:57 | 33 |
Ecco il risultato dopo aver applicato la trasformazione Series to rows.
| 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 |
**Ordina per**
Questa trasformazione ordinerà ogni frame in base al campo configurato. Quando `reverse` è selezionata, i valori verranno restituiti nell'ordine inverso.
**Limite**
Utilizzate questa trasformazione per limitare il numero di righe visualizzate.
Nell'esempio seguente, abbiamo la seguente risposta dalla fonte di dati:
| 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 |
# Risolvi i problemi relativi alle interrogazioni
****
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 9.x di Grafana.**
Per le aree di lavoro Grafana che supportano la versione 10.x di Grafana, vedere. [Funzionamento nella versione 10 di Grafana](using-grafana-v10.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](v9-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.
# Configurare le soglie
****
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 9.x di Grafana.**
Per le aree di lavoro Grafana che supportano la versione 10.x di Grafana, vedere. [Funzionamento nella versione 10 di Grafana](using-grafana-v10.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 sezione include informazioni sull'utilizzo delle soglie nelle visualizzazioni. Imparerai a conoscere le soglie e i relativi valori predefiniti, come aggiungere o eliminare una soglia e come aggiungere una soglia a un pannello precedente.
## Informazioni sulle soglie
Una soglia è un valore specificato per una metrica che viene riflessa visivamente in una dashboard quando il valore di soglia viene raggiunto o superato.
Le soglie forniscono un metodo per applicare stili e colori condizionali alle visualizzazioni in base ai risultati delle query. È possibile applicare soglie alla maggior parte delle visualizzazioni, ma non a tutte. [Per ulteriori informazioni sulle visualizzazioni, consulta i pannelli di visualizzazione.](v9-panels.md)
È possibile utilizzare le soglie per:
+ [Le linee della griglia a colori o le aree della griglia nella visualizzazione delle serie temporali](v9-panels-time-series.md)
+ [Linee di colore nella visualizzazione delle serie temporali](v9-panels-time-series.md)
+ [Colora lo sfondo o il testo del valore nella visualizzazione Stat](v9-panels-stat.md)
+ [Colora l'indicatore e gli indicatori di soglia nella visualizzazione Gauge](v9-panels-gauge.md)
+ [Marcatori a colori nella visualizzazione Geomap](v9-panels-geomap.md)
+ [Colora il testo o lo sfondo della cella nella visualizzazione Tabella](v9-panels-table.md)
+ Definisci le regioni e i colori delle regioni nella visualizzazione della [cronologia dello stato](v9-panels-state-timeline.md)
Esistono due tipi di soglie:
+ Le soglie **assolute** sono definite da un numero. Ad esempio, 80 su una scala da 1 a 150.
+ Le soglie **percentuali** sono definite rispetto al minimo o al massimo. Ad esempio, l'80 percento.
### Soglie predefinite
Nelle visualizzazioni che lo supportano, Grafana imposta i valori di soglia predefiniti di:
+ 80 = rosso
+ Base = verde
+ Modalità = Assoluta
Il valore **base** rappresenta l'infinito negativo. In genere è il colore «buono».
## Aggiungere o eliminare una soglia
Puoi aggiungere tutte le soglie che desideri a un pannello. Grafana ordina automaticamente i valori delle soglie dal più alto al più basso.
Eliminate una soglia quando non è più rilevante per le vostre operazioni aziendali. Quando si elimina una soglia, il sistema rimuove la soglia da tutte le visualizzazioni che includono la soglia.
1. Per aggiungere una soglia:
1. Modifica il pannello a cui desideri aggiungere una soglia.
1. Nel riquadro laterale delle opzioni, individua la sezione **Soglie** e fai clic su **\$1 Aggiungi** soglia.
1. Seleziona un colore, un numero e una modalità di soglia. La modalità Soglia si applica a tutte le soglie di questo pannello.
1. Per un pannello con serie temporali, selezionate l'opzione **Mostra** soglie.
1. Per eliminare una soglia, accedi al pannello che contiene la soglia e fai clic sull'icona del cestino accanto alla soglia che desideri rimuovere.
## Aggiungi una soglia a un pannello grafico precedente
Nella visualizzazione del pannello Grafico, le soglie consentono di aggiungere linee o sezioni a un grafico per facilitare il riconoscimento quando il grafico supera una soglia.
1. Passate al pannello grafico a cui desiderate aggiungere una soglia.
1. Nella scheda **Pannello**, fate clic su **Soglie**.
1. Fate clic su **Aggiungi soglia**.
1. Completare i seguenti campi:
+ **T1 -** Entrambi i valori sono necessari per visualizzare una soglia.
+ **lt** o **gt**: seleziona **lt** per meno di o **gt** per maggiore di per indicare a cosa si applica la soglia.
+ **Valore:** immettere un valore di soglia. Grafana traccia una linea di soglia lungo l'asse Y a quel valore.
+ **Colore:** scegli una condizione che corrisponda a un colore o definisci il tuo colore.
+ **personalizzato:** definisci il colore di riempimento e il colore della linea.
+ **critico -** Il colore del riempimento e della linea sono rossi.
+ **avviso -** I colori di riempimento e linea sono gialli.
+ **ok -** I colori di riempimento e linea sono verdi.
+ **Riempimento:** controlla se viene visualizzato il riempimento della soglia.
+ **Linea:** controlla se viene visualizzata la linea di soglia.
+ **Asse Y:** scegli **sinistra** o **destra**.
1. Fai clic su **Salva** per salvare le modifiche nella dashboard.
# Configurare i collegamenti dati
****
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 9.x di Grafana.**
Per le aree di lavoro Grafana che supportano la versione 10.x di Grafana, vedere. [Funzionamento nella versione 10 di Grafana](using-grafana-v10.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 utilizzare variabili di collegamento dati o collegamenti dati per creare collegamenti tra i pannelli.
## Variabili di collegamento dati
È possibile utilizzare le variabili nei collegamenti dati per fare riferimento a campi, etichette e valori delle serie. Per ulteriori informazioni sui collegamenti dati, consulta[Collegamenti dati](#v9-panels-data-links).
Per visualizzare un elenco di variabili disponibili, digita **\$1** nel campo **URL del** collegamento dati per visualizzare un elenco di variabili che puoi utilizzare.
**Nota**
Queste variabili sono cambiate nella versione 6.4, quindi se hai una versione precedente di Grafana, usa il selettore di versione per selezionare i documenti per una versione precedente di Grafana.
Puoi anche usare variabili modello nei tuoi link dati, vedi. URLs [Aggiungere e gestire le variabili del dashboard](v9-dash-variables.md)
## Variabili del pannello dell'intervallo di tempo
Queste variabili consentono di includere l'intervallo di tempo corrente nell'URL del collegamento dati.
+ **\$1\$1url\$1time\$1range - intervallo di** **tempo della dashboard corrente (ad es.? da=ora-6h&a=adesso**)
+ \$1\$1\$1from e **\$1\$1\$1to** - Per ulteriori informazioni, vedi. [Variabili globali](v9-dash-variable-add.md#v9-dash-variable-add-global)
## Variabili di serie
Le variabili specifiche della serie sono disponibili nello spazio dei nomi **\$1\$1series**:
+ **\$1\$1series.name** - nome della serie all'URL
## Variabili di campo
Le variabili specifiche del campo sono disponibili nello spazio dei nomi **\$1\$1field**:
+ **\$1\$1field.name: il nome del campo**
+ **\$1\$1field.labels. **