

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à.

# Dashboard in Grafana versione 9
<a name="v9-dashboards"></a>

****  
**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)

Una dashboard è un insieme di uno o più [pannelli](v9-panels.md) organizzati e disposti in una o più righe. Grafana viene fornito con una varietà di pannelli che semplificano la creazione delle query giuste e personalizzano la visualizzazione in modo da poter creare la dashboard perfetta per le tue esigenze. Ogni pannello può interagire con i dati di qualsiasi configurazione. [Connessione alle origini dati](AMG-data-sources.md)

Le istantanee del pannello di controllo sono statiche. Le query e le espressioni non possono essere rieseguite dalle istantanee. Di conseguenza, se aggiorni una variabile nella query o nell'espressione, i dati del dashboard non verranno modificati.

**Topics**
+ [Utilizzo dei pannelli di controllo](v9-dash-using-dashboards.md)
+ [Creazione di dashboard](v9-dash-building-dashboards.md)
+ [Gestione dei dashboard](v9-dash-managing-dashboards.md)
+ [Condivisione di dashboard e pannelli](v9-dash-sharing.md)
+ [Gestione delle playlist](v9-dash-managing-playlists.md)
+ [Aggiungere e gestire le variabili del dashboard](v9-dash-variables.md)
+ [Valutazione dell'utilizzo del pannello di controllo](v9-dash-assess-dashboard-usage.md)
+ [Ricerca nelle dashboard in Grafana versione 9](v9-search.md)

# Utilizzo dei pannelli di controllo
<a name="v9-dash-using-dashboards"></a>

****  
**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)

Questo argomento fornisce una panoramica delle funzionalità e delle scorciatoie della dashboard e descrive come utilizzare la ricerca nella dashboard.

## Funzionalità
<a name="v9-dash-features"></a>

Puoi utilizzare le dashboard per personalizzare la presentazione dei dati nei seguenti modi.


|  Funzionalità  |  Description  | 
| --- | --- | 
| **1. Home** | Fai clic sull'icona principale di Grafana per essere reindirizzato alla home page configurata nell'istanza Grafana. | 
| **2. Titolo** | Quando fai clic sul titolo della dashboard, puoi cercare la dashboard contenuta nella cartella corrente. | 
| **3. Condivisione di una dashboard** | Utilizza questa opzione per condividere la dashboard corrente tramite link o istantanea. Puoi anche esportare la definizione della dashboard dalla modalità di condivisione. | 
| **4. Aggiungere un nuovo pannello** | Utilizzate questa opzione per aggiungere un pannello, una riga della dashboard o un pannello della libreria alla dashboard corrente. | 
| **5. Impostazioni del pannello di controllo** | Utilizza questa opzione per modificare il nome, la cartella e i tag della dashboard e gestire le variabili e le query di annotazione. Per ulteriori informazioni sulle impostazioni della dashboard, consulta. [Modifica delle impostazioni del pannello di controllo](v9-dash-modify-settings.md) | 
| **6. Menu a discesa Time Picker** |  Fai clic per selezionare le opzioni relative all'intervallo di tempo e impostare intervalli di tempo assoluti personalizzati. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/v9-dash-using-dashboards.html)  | 
| **7. Intervallo di tempo di zoom indietro**  | Fare clic per ridurre l'intervallo di tempo. Per ulteriori informazioni su come utilizzare i controlli dell'intervallo di tempo, vedere[Impostazione dell'intervallo di tempo della dashboard](#v9-dash-setting-dashboard-time-range).  | 
| **8. Dashboard rinfrescante** | Fai clic per attivare immediatamente le interrogazioni e aggiornare i dati del dashboard. | 
| **9. Aggiornamento dell'intervallo di tempo del dashboard** | Fai clic per selezionare un intervallo di tempo di aggiornamento automatico del pannello di controllo. | 
| **10. Modalità di visualizzazione**  | Fai clic per visualizzare la dashboard su uno schermo di grandi dimensioni, ad esempio una TV o un chiosco. La modalità di visualizzazione nasconde informazioni non pertinenti come i menu di navigazione.  | 
| **11. Pannello del cruscotto** |  L'elemento costitutivo principale di una dashboard è il pannello. Per aggiungere un nuovo pannello, una riga della dashboard o un pannello della libreria, fai clic su **Aggiungi pannello**. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/v9-dash-using-dashboards.html)  | 
| **12. Legenda del grafico** | Modifica i colori delle serie, l'asse y e la visibilità delle serie direttamente dalla legenda. | 
| **13. Ricerca nel pannello di controllo** | Fai clic su **Cerca** per cercare le dashboard per nome o titolo del pannello. | 
| **14. Riga del cruscotto** | Una riga del dashboard è un divisore logico all'interno di un pannello di controllo che raggruppa i pannelli. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/v9-dash-using-dashboards.html)  | 

## Tasti di scelta rapida
<a name="v9-dash-keyboard-shortcuts"></a>

Grafana ha diverse scorciatoie da tastiera disponibili. **Per visualizzare tutte le scorciatoie da tastiera disponibili, premi?** o **h** sulla tastiera.
+ `Ctrl+S`salva la dashboard corrente. 
+ `f`apre il cerca/ricerca del pannello di controllo. 
+  `d+k`attiva la modalità chiosco (nasconde il menu). 
+ `d+e`espande tutte le righe. 
+ `d+s`apre le impostazioni della dashboard. 
+ `Ctrl+K`apre la palette dei comandi.
+ `Esc`esce dal pannello quando è in modalità di visualizzazione a schermo intero o di modifica. Consente inoltre di tornare alla dashboard dalle impostazioni della dashboard.

**Pannello focalizzato**

Per utilizzare le scorciatoie destinate a un pannello specifico, passa il mouse su un pannello con il puntatore del mouse.
+ `e`attiva o disattiva la visualizzazione del pannello 
+ `v`attiva la visualizzazione a schermo intero del pannello 
+ `ps`apre la funzione di condivisione del pannello 
+ `pd`duplica il pannello 
+ `pr`rimuove il pannello 
+ `pl`alterna la legenda del pannello 

## Impostazione dell'intervallo di tempo della dashboard
<a name="v9-dash-setting-dashboard-time-range"></a>

Grafana offre diversi modi per gestire gli intervalli di tempo dei dati visualizzati, per dashboard, pannelli e anche per gli avvisi.

Questa sezione descrive le unità di tempo supportate e gli intervalli relativi, i controlli temporali comuni, le impostazioni temporali a livello di dashboard e le impostazioni temporali specifiche del pannello.

**Unità di tempo e intervalli relativi**

Grafana supporta le seguenti unità di tempo:`s (seconds)`,,`m (minutes)`,`h (hours)`,`d (days)`, `w (weeks)` `M (months)``Q (quarters)`, e. `y (years)` 

L'operatore meno ti consente di tornare indietro nel tempo, rispetto a adesso. Se desideri visualizzare il periodo completo dell'unità (giorno, settimana o mese), aggiungi `/<time unit>` alla fine. Per visualizzare i periodi fiscali, l'uso `fQ (fiscal quarter)` e le unità `fy (fiscal year)` di tempo.

L'operatore plus ti consente di avanzare nel tempo rispetto a adesso. Ad esempio, puoi utilizzare questa funzionalità per esaminare i dati previsti per il futuro.

La tabella seguente fornisce esempi di intervalli relativi.


| Esempio di intervallo relativo | Da | Per | 
| --- | --- | --- | 
| Ultimi 5 minuti |  `now-5m`  |  `now`  | 
| Il giorno finora |  `now/d`  |  `now`  | 
| Questa settimana |  `now/w`  |  `now/w`  | 
| Questa settimana finora |  `now/w`  |  `now`  | 
| Questo mese |  `now/M`  |  `now/M`  | 
| Questo mese finora |  `now/M`  |  `now`  | 
| Mese precedente |  `now-1M/M`  |  `now-1M/M`  | 
| Quest'anno finora |  `now/Y`  |  `now`  | 
| Quest'anno |  `now/Y`  |  `now/Y`  | 
| Anno fiscale precedente |  `now-1y/fy`  |  `now-1y/fy`  | 

**Nota**  
 Grafana Alerting non supporta i timestamp `now+n` futuri e `now-1n/n` l'*inizio di n fino alla fine di n* timestamp. 

**Controlli comuni dell'intervallo di tempo**

I controlli temporali della dashboard e del pannello hanno un'interfaccia utente comune. Di seguito vengono descritti i controlli comuni relativi all'intervallo di tempo.
+ L'intervallo di tempo corrente, chiamato anche *selettore temporale*, mostra l'intervallo di tempo attualmente visualizzato nella dashboard o nel pannello visualizzato. Posiziona il cursore sul campo per visualizzare i timestamp esatti dell'intervallo e la loro origine (ad esempio il browser locale). Fai clic sull'*intervallo di tempo corrente per modificarlo*. È possibile modificare l'ora corrente utilizzando un *intervallo di tempo relativo*, ad esempio gli ultimi 15 minuti, o un intervallo di tempo assoluto, ad esempio `2020-05-14 00:00:00` to`2020-05-15 23:59:59`.
+ L'**intervallo di tempo relativo** può essere selezionato dall'elenco **Intervalli temporali relativi**. Puoi filtrare l'elenco utilizzando il campo di immissione in alto. Alcuni esempi di intervalli di tempo includono *Ultimi 30 minuti*, *Ultime 12 ore*, *Ultimi 7 giorni*, *Ultimi 2 anni*, *Ieri*, *L'*altro ieri*, L'altro ieri, Questo giorno* *la settimana scorsa, *Oggi finora**, Questa settimana finora e *Questo mese finora*.
+ L'**intervallo di tempo assoluto** può essere impostato in due modi: digitando valori temporali esatti o valori temporali relativi nei campi **Da** e **A** e facendo clic su **Applica intervallo di tempo** oppure facendo clic su una data o un intervallo di date dal calendario visualizzato quando si fa clic sul campo **Da** o **A**. Per applicare le selezioni, fai clic su **Applica intervallo di tempo.**

*Altre funzionalità relative all'intervallo di tempo*

1. **Per rimpicciolire, fate clic su **Cmd\$1Z o Ctrl\$1Z**.** Fai clic sull'icona per visualizzare un intervallo di tempo più ampio nella visualizzazione della dashboard o del pannello.

1. Per utilizzare la funzione di ingrandimento, fai clic e trascina per selezionare l'intervallo di tempo nella visualizzazione che desideri visualizzare.

**Nota**  
L'ingrandimento è applicabile solo alle visualizzazioni grafiche. 

*Aggiorna i dashboard*

Fai clic sull'icona **Aggiorna dashboard** per eseguire immediatamente ogni query sulla dashboard e aggiornare le visualizzazioni. Grafana annulla qualsiasi richiesta in sospeso quando attivi un aggiornamento.

Per impostazione predefinita, Grafana non aggiorna automaticamente la dashboard. Le interrogazioni vengono eseguite secondo una propria pianificazione in base alle impostazioni del pannello. Tuttavia, se desideri aggiornare regolarmente la dashboard, fai clic sulla freccia rivolta verso il basso accanto all'icona **Aggiorna dashboard** e seleziona un intervallo di aggiornamento.

**Controlla l'intervallo di tempo utilizzando un URL**

Puoi controllare l'intervallo di tempo di una dashboard fornendo i seguenti parametri di query nell'URL della dashboard.
+ `from`definisce il limite inferiore dell'intervallo di tempo, specificato in ms epoch, o [tempo relativo](#v9-dash-setting-dashboard-time-range).
+ `to`definisce il limite superiore dell'intervallo di tempo, specificato in ms epoch, o tempo relativo.
+ `time`e `time.window` definisce un intervallo di tempo da `time-time.window/2` a. `time+time.window/2` Entrambi i parametri devono essere specificati in ms. Ad esempio, `?time=1500000000000&time.window=10000` restituisce un intervallo di tempo di 10 secondi compreso tra 1499999995000 e 1500000005000.

# Creazione di dashboard
<a name="v9-dash-building-dashboards"></a>

****  
**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)

Dopo aver creato un'area di lavoro Grafana e aver effettuato l'accesso, puoi creare dashboard e modificare le impostazioni in base alle tue esigenze. 

**Topics**
+ [Creazione di dashboard](v9-dash-creating.md)
+ [Aggiungere o modificare pannelli](v9-dash-edit-panels.md)
+ [Modifica delle impostazioni del pannello di controllo](v9-dash-modify-settings.md)
+ [Variabili URL del pannello di controllo](v9-dash-dashboard-url-variables.md)
+ [Aggiungere un pannello della libreria alla dashboard](v9-dash-manage-library-panels.md)
+ [Gestione della cronologia delle versioni del dashboard](v9-dash-manage-version-history.md)
+ [Gestione dei collegamenti al pannello di controllo](v9-dash-manage-dashboard-links.md)
+ [Modello JSON di dashboard](v9-dash-dashboard-json-model.md)

# Creazione di dashboard
<a name="v9-dash-creating"></a>

****  
**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)

**Creazione di una dashboard**

Le dashboard e i pannelli consentono di mostrare i dati in forma visiva utilizzando Grafana. Ogni pannello necessita di almeno una query per visualizzare una visualizzazione. Prima di iniziare, completa i seguenti prerequisiti.
+ Assicurati di disporre delle autorizzazioni appropriate. Per ulteriori informazioni sulle autorizzazioni, consultare [Utenti, team e autorizzazioni](Grafana-administration-authorization.md).
+ Identifica la dashboard a cui desideri aggiungere il pannello.
+ Comprendi il linguaggio di interrogazione della fonte di dati di destinazione.
+ Assicurati che sia stata aggiunta la fonte di dati per la quale stai scrivendo una query.

 Per creare una dashboard:

1. **Accedi a Grafana, posiziona il cursore su Dashboard e fai clic su \$1 Nuova **dashboard**.**

1. Fai clic su **Aggiungi un nuovo pannello**.

1. Nella prima riga della scheda **Query**, fai clic sull'elenco a discesa e seleziona una fonte di dati.

1. Scrivi o costruisci una query nel linguaggio di interrogazione della tua fonte di dati.

1. Nell'elenco delle **visualizzazioni**, seleziona un tipo di visualizzazione. Grafana mostra un'anteprima dei risultati della query con la visualizzazione applicata. Per ulteriori informazioni, consulta Opzioni di [visualizzazione](v9-panels-viz.md).

1. Regola le impostazioni del pannello nei seguenti modi.
   + [Configura le mappature dei valori](v9-panels-configure-value-mappings.md)
   + [Opzioni specifiche per la visualizzazione](v9-panels-viz.md)
   + [Sostituisci i valori dei campi](v9-panels-configure-overrides.md)
   + [Configura le soglie](v9-panels-configure-thresholds.md)
   + [Configura le opzioni standard](v9-panels-configure-standard-options.md)
**Nota**  
La maggior parte delle visualizzazioni necessita di alcune modifiche prima di visualizzare correttamente le informazioni necessarie.

1. Aggiungi una nota per descrivere la visualizzazione (o descrivere le modifiche), quindi fai clic su **Salva** nell'angolo superiore destro della pagina.
**Nota**  
Le note sono utili se devi ripristinare la dashboard a una versione precedente.

**Configurazione delle righe ripetute**

Puoi configurare Grafana per aggiungere dinamicamente pannelli o righe a una dashboard in base al valore di una variabile. Le variabili modificano dinamicamente le tue query su tutte le righe di una dashboard. Per ulteriori informazioni sui pannelli ripetuti, consulta [Configurare]() i pannelli ripetuti.

Puoi anche ripetere le righe se hai delle variabili impostate `Multi-value` o `Include all values` selezionate.

Prima di iniziare, assicurati che la query includa una variabile multivalore, quindi completa i passaggi seguenti.

1. Nella home page della dashboard, fai clic su **Aggiungi pannello**.

1. Nella finestra di dialogo **Aggiungi un pannello**, fai clic su **Aggiungi una nuova riga**.

1. Passa il mouse sul titolo della riga e fai clic sull'icona a forma di ingranaggio.

1. Nella finestra di dialogo **Opzioni riga**, aggiungi un titolo e seleziona la variabile per la quale desideri aggiungere righe ripetute.
**Nota**  
 Per fornire un contesto agli utenti del dashboard, aggiungi la variabile al titolo della riga. 

**Per spostare un pannello**

1. Apri il pannello di controllo .

1. Fate clic sul titolo del pannello e trascinatelo nella nuova posizione. Puoi posizionare un pannello su una dashboard in qualsiasi posizione.

**Per ridimensionare un pannello**

1. Apri il pannello di controllo .

1. Per regolare le dimensioni del pannello, fate clic e trascinate l'angolo inferiore destro del pannello. Puoi ridimensionare un pannello della dashboard in base alle tue esigenze.

# Aggiungere o modificare pannelli
<a name="v9-dash-edit-panels"></a>

****  
**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)

Dopo aver creato una dashboard, puoi aggiungere, modificare o rimuovere pannelli in qualsiasi momento.
+ **Visualizza dashboard**: per visualizzare una dashboard, dal menu **Home**, seleziona **Dashboard**, quindi scegli la dashboard che desideri visualizzare. Potrebbe essere necessario espandere la cartella che contiene la dashboard.
+ **Aggiungi pannello**: per aggiungere un pannello a una dashboard, scegli l'icona **Aggiungi pannello** nella barra dei menu nella parte superiore della pagina.
+ **Pannello** di modifica Per modificare un pannello esistente su una dashboard, scegli l'icona del menu che appare quando passi il mouse sul pannello, quindi scegli **Modifica**.
+ **Rimuovi pannello** **Per rimuovere un pannello esistente su una dashboard, scegli l'icona del menu che appare quando passi il mouse sul pannello, quindi scegli Rimuovi.**

# Modifica delle impostazioni del pannello di controllo
<a name="v9-dash-modify-settings"></a>

****  
**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)

La pagina delle impostazioni della dashboard consente di:
+ Modificare le proprietà generali della dashboard, incluse le impostazioni dell'ora.
+ Aggiungi interrogazioni di annotazione.
+ Aggiungi variabili del pannello di controllo.
+ Aggiungi link.
+ Visualizza il modello JSON del dashboard

Per accedere alla pagina delle impostazioni della dashboard:

1. Apri una dashboard in modalità di modifica.

1. Fai clic su **Impostazioni dashboard** (icona a forma di ingranaggio) situata nella parte superiore della pagina.

**Modifica delle impostazioni relative all'ora della dashboard**

Modifica le impostazioni dell'ora della dashboard quando desideri modificare il fuso orario della dashboard, l'ora locale del browser e specificare gli intervalli di aggiornamento automatico.

**Per modificare le impostazioni dell'ora della dashboard**

1. Nella pagina delle impostazioni della **dashboard**, seleziona **Generale**.

1. Vai alla sezione **Opzioni temporali**.

1. Specificate le impostazioni dell'ora in base alle seguenti descrizioni.

1. Il fuso orario specifica il fuso orario locale del servizio o del sistema che si sta monitorando. Questo può essere utile quando si monitora un sistema o un servizio che opera in diversi fusi orari.
   + Grafana utilizza il fuso orario *predefinito* selezionato per il profilo utente, il team o l'organizzazione. Se non viene specificato alcun fuso orario per il profilo utente, per il team di cui l'utente è membro o per l'organizzazione, Grafana utilizza l'ora locale del browser.
   + Viene utilizzato il fuso orario configurato per il browser dell'utente di visualizzazione, l'*ora locale del browser*. Si tratta in genere dello stesso fuso orario impostato sul computer.
   + Utilizza i fusi [orari standard ISO 8601](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones), incluso UTC.
+ L'**aggiornamento automatico** personalizza le opzioni visualizzate per il tempo relativo e le opzioni di aggiornamento automatico Le voci sono separate da virgole e accettano qualsiasi unità di tempo valida.
+ **Ora il ritardo** sostituisce il tempo inserendo un ritardo. `now` Utilizzate questa opzione per gestire i ritardi noti nell'aggregazione dei dati ed evitare valori nulli.
+ **Nascondi il selettore orario** rimuove la visualizzazione del selettore orario Grafana.

**Nota**  
Per avere controlli temporali, i dati devono includere una colonna temporale. Consulta la documentazione della tua [fonte di dati](AMG-data-sources.md) specifica per ulteriori informazioni sull'inclusione di una colonna temporale.

**Aggiungere una query di annotazione**

Una query di annotazione è una query che richiede gli eventi. Questi eventi possono essere visualizzati in grafici sulla dashboard come linee verticali insieme a una piccola icona su cui passare il mouse per visualizzare le informazioni sull'evento.

**Per aggiungere una query di annotazione**

1. Nella pagina delle **impostazioni della dashboard**, seleziona **Annotazioni**.

1. Seleziona **Aggiungi interrogazione di annotazione.** 

1. Inserisci un nome e seleziona una fonte di dati.

1. Completa il resto del modulo per creare una query e un'annotazione.

L'interfaccia utente dell'editor di query cambia in base all'origine dati selezionata. Consulta la documentazione sull'[origine dei dati](AMG-data-sources.md) per i dettagli su come costruire una query.

**Aggiungere una variabile**

Le variabili consentono di creare dashboard più interattivi e dinamici. Invece di codificare elementi come i nomi di server, applicazioni e sensori nelle query metriche, puoi utilizzare variabili al loro posto. Le variabili vengono visualizzate come elenchi a discesa nella parte superiore della dashboard. Questi menu a discesa semplificano la modifica dei dati visualizzati nella dashboard.

[Per ulteriori informazioni sulle variabili, consulta Variabili.](v9-dash-variables.md)

1. Nella pagina **delle impostazioni della dashboard**, fai clic su **Variabile** nel menu della sezione a sinistra, quindi sul pulsante **Aggiungi variabile**.

1. Nella sezione **Generale**, il nome della variabile. Questo è il nome che verrà utilizzato in seguito nelle query.

1. Seleziona un **tipo** di variabile.
**Nota**  
Il tipo di variabile selezionato influisce sui campi che compili nella pagina.

1. Definite la variabile e fate clic su **Aggiorna**.

**Aggiungere un link**

I link alla dashboard consentono di inserire collegamenti ad altre dashboard e siti Web direttamente sotto l'intestazione della dashboard. I link facilitano la navigazione verso altre dashboard e contenuti correlati. 

1.  Nella pagina **delle impostazioni della dashboard**, fai clic su **Collegamenti** nel menu della sezione a sinistra, quindi sul pulsante **Aggiungi link**. 

1.  Inserisci il titolo e, nel campo **Tipo**, seleziona **Dashboard** o **Link**. 

1.  Per aggiungere un link alla dashboard, aggiungi un tag opzionale, seleziona una delle opzioni del link alla dashboard e fai clic su **Applica**. 
**Nota**  
I tag sono utili per creare un menu a discesa dinamico di dashboard che hanno tutte un tag specifico. 

1.  Per aggiungere un link, aggiungi un URL e un testo del tooltip che appaiono quando l'utente passa il mouse sul link, seleziona un'icona che appare accanto al link e seleziona una delle opzioni del link della dashboard. 

**Visualizza il modello JSON della dashboard** 

Una dashboard in Grafana è rappresentata da un oggetto JSON, che memorizza i metadati della relativa dashboard. I metadati della dashboard includono le proprietà della dashboard, i metadati dei pannelli, le variabili del modello, le interrogazioni dei pannelli e così via. 

**Per visualizzare un modello JSON di dashboard, nella pagina delle **impostazioni della dashboard**, fai clic su JSON.**

[Per ulteriori informazioni sui campi JSON, consulta Campi JSON.](v9-dash-dashboard-json-model.md)

# Variabili URL del pannello di controllo
<a name="v9-dash-dashboard-url-variables"></a>

****  
**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 può applicare valori variabili passati come parametri di query nella dashboard. URLs Per ulteriori informazioni, consulta [Gestire i collegamenti alla dashboard e i](v9-dash-manage-dashboard-links.md) [modelli e le variabili](v9-dash-variables.md).

**Passare le variabili come parametri di interrogazione**

Grafana interpreta i parametri della stringa di query con il prefisso `var-` come variabili nella dashboard fornita.

Ad esempio, in questo URL: 

```
https://${your-domain}/path/to/your/dashboard?var-example=value
```

Il parametro query `var-example=value` rappresenta l'esempio di variabile del dashboard con un valore di`value`.

**Passare più valori per una variabile**

Per passare più valori, ripetete il parametro variabile una volta per ogni valore.

```
https://${your-domain}/path/to/your/dashboard?var-example=value1&var-example=value2
```

Grafana viene interpretata `var-example=value1&var-example=value2` come l'esempio di variabile del dashboard con due valori: e. `value1` `value2`

**Aggiungere variabili ai link del pannello di controllo**

Grafana può aggiungere variabili ai link del dashboard quando li generi dalle impostazioni di una dashboard. Per ulteriori informazioni e passaggi per aggiungere variabili, consulta [Gestire i collegamenti alla dashboard](v9-dash-manage-dashboard-links.md).

**Passaggio di filtri ad hoc**

I filtri ad hoc applicano filtri chiave o di valore a tutte le query metriche che utilizzano una fonte di dati specificata. Per ulteriori informazioni, consulta Filtri [ad hoc.]()

Per passare un filtro ad hoc come parametro di query, utilizzate la sintassi della variabile per passare la variabile di filtro ad hoc e fornite anche la chiave, l'operatore come valore e il valore come elenco separato da un tubo.

Ad esempio, in questo URL:

`https://${your-domain}/path/to/your/dashboard?var-adhoc=example_key|=|example_value` 

Il parametro query `var-adhoc=key|=|value` applica il filtro ad hoc configurato come variabile di dashboard ad hoc utilizzando la `example_key` chiave, l'`=`operatore e il valore. `example_value`

**Nota**  
Quando condividi URLs con filtri ad hoc, ricorda di codificare l'URL. Nell'esempio precedente, sostituite le pipe `(|)` con `%7C` e l'operatore `(=)` di uguaglianza con. ` %3D`

**Controllo dell'intervallo di tempo tramite l'URL**

Per impostare l'intervallo di tempo di una dashboard, utilizza i parametri `from``to`,`time`, e di `time.window` query. Poiché non si tratta di variabili, non richiedono il `var-` prefisso.

# Aggiungere un pannello della libreria alla dashboard
<a name="v9-dash-manage-library-panels"></a>

****  
**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 libreria è un pannello riutilizzabile che puoi usare in qualsiasi dashboard. Quando modificate un pannello della libreria, la modifica si propaga a tutte le istanze in cui viene utilizzato il pannello. I pannelli della libreria semplificano il riutilizzo dei pannelli su più dashboard.

Puoi salvare un pannello della libreria in una cartella insieme ai dashboard salvati.

**Creazione di un pannello della libreria**

Quando create un pannello della libreria, anche il pannello sulla dashboard di origine viene convertito in un pannello della libreria. È necessario salvare la dashboard originale dopo la conversione di un pannello.

1. Apri un pannello in modalità di modifica.

1. Nelle opzioni di visualizzazione del pannello, fai clic sull'opzione freccia giù per apportare modifiche alla visualizzazione.

1. Per aprire la finestra di dialogo **Crea**, fate clic sull'opzione **Pannelli Libreria**, quindi fate clic sul **pannello Crea libreria**.

1. Nel **nome del pannello Libreria**, inserite il nome.

1. In **Salva nella cartella**, selezionate la cartella in cui salvare il pannello della libreria.

1. Per salvare le modifiche, fate clic su **Crea pannello libreria**.

1. Per salvare la dashboard, fai clic su **Salva**.

Dopo aver creato un pannello della libreria, puoi modificare il pannello utilizzando qualsiasi dashboard in cui è visualizzato. Dopo aver salvato le modifiche, tutte le istanze del pannello della libreria riflettono tali modifiche.

**Aggiungere un pannello della libreria a una dashboard**

Aggiungi un pannello della libreria Grafana a una dashboard quando desideri fornire visualizzazioni ad altri utenti della dashboard.

1. Passa il mouse sull'opzione **Dashboards** nel menu a sinistra, quindi seleziona **Nuova dashboard** dalle opzioni a discesa. Si aprirà la finestra **di dialogo Aggiungi pannello**.

1. Fate clic sull'opzione **Aggiungi un pannello** dalla libreria del pannello. Verrà visualizzato un elenco dei pannelli della libreria.

1. Filtra l'elenco o cerca il pannello che desideri aggiungere.

1. Fai clic su un pannello per aggiungerlo alla dashboard.

**Scollegare un pannello della libreria**

Scollegate un pannello della libreria quando desiderate apportare una modifica al pannello e non influire sulle altre istanze del pannello della libreria.

1. **Passa il mouse su **Dashboard** nel menu a sinistra, quindi fai clic su Pannelli Libreria.**

1. Seleziona un pannello della libreria che viene utilizzato in diversi dashboard.

1. Seleziona il pannello che desideri scollegare.

1. Fate clic sul titolo del pannello, quindi su **Modifica**. Il pannello si aprirà in modalità di modifica.

1. Fai clic sull'opzione **Scollega** nell'angolo in alto a destra della pagina.

**Visualizzazione di un elenco di pannelli della libreria**

Scollegate un pannello della libreria quando desiderate apportare una modifica al pannello e non influire sulle altre istanze del pannello della libreria.

1. **Passa il mouse sull'opzione **Dashboard** nel menu a sinistra, quindi fai clic su Pannelli Libreria.** È possibile visualizzare un elenco di pannelli di libreria precedentemente definiti.

1. Cerca uno specifico pannello della libreria se ne conosci il nome. Puoi anche filtrare i pannelli per cartella o tipo.

**Eliminazione di un pannello della libreria**

Eliminate un pannello della libreria quando non vi serve più.

1. Passa il mouse su **Dashboard** nel menu a sinistra e seleziona i **pannelli Libreria**.

1. Seleziona il pannello che desideri eliminare.

1. Fate clic sull'icona di eliminazione accanto al nome della libreria.

# Gestione della cronologia delle versioni del dashboard
<a name="v9-dash-manage-version-history"></a>

****  
**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)

Ogni volta che salvi una versione della dashboard, viene salvata una copia di quella versione in modo che le versioni precedenti non vadano mai perse. Un elenco di queste versioni è disponibile accedendo alle impostazioni della dashboard e selezionando **Versioni** nel menu a sinistra.

La funzionalità di cronologia delle versioni della dashboard consente di confrontare e ripristinare le versioni della dashboard salvate in precedenza.

**Confronto di due versioni della dashboard**

Per confrontare due versioni della dashboard, seleziona le due versioni dall'elenco che desideri confrontare. Fai clic su **Confronta versioni** per visualizzare la differenza tra le due versioni.

Facendo clic sul pulsante, verrai indirizzato alla visualizzazione delle differenze. Per impostazione predefinita, vedrai un riepilogo testuale delle modifiche.

Se desideri visualizzare la differenza del codice JSON non elaborato che rappresenta la tua dashboard, puoi farlo anche facendo clic sul pulsante **Visualizza JSON Diff** in basso.

Se desideri ripristinare la versione con cui ti opponi, puoi farlo facendo clic sul <x>pulsante **Ripristina alla versione in alto a** destra.

**Ripristino a una versione della dashboard salvata in precedenza**

Se devi ripristinare una versione della dashboard salvata in precedenza, puoi fare clic sul pulsante **Ripristina** a destra di una riga nell'elenco delle versioni della dashboard oppure fare clic sul <x>pulsante **Ripristina alla versione** che appare nella vista delle differenze. Facendo clic sul pulsante verrà visualizzato il seguente pop-up che richiede di confermare il ripristino.

Dopo il ripristino a una versione precedente, verrà creata una nuova versione contenente gli stessi dati esatti della versione precedente, solo con un numero di versione diverso. Questo è indicato nella **colonna Note relativa** alla riga della nuova versione del dashboard. Questo viene fatto semplicemente per garantire che le versioni precedenti della dashboard non siano influenzate dalla modifica.

# Gestione dei collegamenti al pannello di controllo
<a name="v9-dash-manage-dashboard-links"></a>

****  
**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)

Puoi utilizzare i link per navigare tra i dashboard di uso comune o per connettere altri utenti alle tue visualizzazioni. I link consentono di creare collegamenti ad altre dashboard, pannelli e persino siti Web esterni.

Grafana supporta collegamenti a dashboard, collegamenti a pannelli e collegamenti dati. I link alla dashboard vengono visualizzati nella parte superiore della dashboard. I collegamenti ai pannelli sono accessibili facendo clic su un'icona nell'angolo superiore sinistro del pannello.

**Scelta del link da utilizzare**

Inizia a capire come stai attualmente navigando tra le dashboard. Se passi spesso da un set di dashboard all'altro e hai difficoltà a trovare lo stesso contesto in ognuna di esse, i link possono aiutarti a ottimizzare il flusso di lavoro.

Il passaggio successivo consiste nel capire quale tipo di link è adatto al tuo flusso di lavoro. Anche se tutti i tipi di link in Grafana vengono utilizzati per creare collegamenti ad altre dashboard o siti Web esterni, funzionano in contesti diversi.
+ Se il link si riferisce alla maggior parte se non a tutti i pannelli della dashboard, utilizza i link della dashboard.
+ Se vuoi approfondire pannelli specifici, usa i link ai pannelli.
+ Se desideri creare un collegamento a un sito esterno, puoi utilizzare un collegamento alla dashboard o un collegamento al pannello.
+ Se desideri approfondire una serie specifica o anche una singola misurazione, utilizza i link dati.

**Controllo dell'intervallo di tempo tramite l'URL**

Per controllare l'intervallo di tempo di un pannello o di una dashboard, puoi fornire i parametri di query nell'URL della dashboard:
+ `from`definisce il limite inferiore dell'intervallo di tempo, specificato in ms epoch.
+ `to`definisce il limite superiore dell'intervallo di tempo, specificato in ms epoch.
+ `time`e `time.window` definisce un intervallo di tempo da `time-time.window/2` a. `time+time.window/2` Entrambi i parametri devono essere specificati in ms. Ad esempio, `?time=1500000000000&time.window=10000` risulterà in un intervallo di tempo di 10 secondi compreso tra 1499999995000 e 1500000005000.

**Collegamenti alla dashboard**

Quando crei un link alla dashboard, puoi includere l'intervallo di tempo e le variabili correnti del modello per passare direttamente allo stesso contesto in un'altra dashboard. In questo modo, non devi preoccuparti che la persona a cui invii il link stia visualizzando i dati giusti. Per altri tipi di link, consulta [Variabili del collegamento dati]().

I link al pannello di controllo possono essere utilizzati anche come collegamenti a sistemi esterni, ad esempio per inviare [un GitHub problema con il nome corrente della dashboard](https://github.com/grafana/grafana/issues/new?title=Dashboard%3A%20HTTP%20Requests).

Dopo aver aggiunto un link alla dashboard, questo verrà visualizzato nell'angolo in alto a destra della dashboard.

**Aggiungere link alle dashboard**

Aggiungi link ad altre dashboard nella parte superiore della dashboard corrente.

1. Durante la visualizzazione della dashboard che desideri collegare, fai clic sull'ingranaggio nella parte superiore dello schermo per aprire **le impostazioni della dashboard**.

1. Fai clic su **Collegamenti**, quindi su **Aggiungi link alla dashboard** o su **Nuovo**.

1. In **Tipo**, seleziona **dashboard**.

1. Seleziona le opzioni di collegamento tra le seguenti.
   + **Con tag**: inserisci i tag per limitare i dashboard collegati solo a quelli con i tag che inserisci. Altrimenti, Grafana include collegamenti a tutte le altre dashboard.
   + **Come menu a discesa**: se stai collegando a molte dashboard, probabilmente vorrai selezionare questa opzione e aggiungere un titolo opzionale al menu a discesa. Altrimenti, Grafana mostra i link del pannello di controllo uno accanto all'altro nella parte superiore della dashboard.
   + **Intervallo di tempo**: seleziona questa opzione per includere l'intervallo di tempo della dashboard nel link. Quando l'utente fa clic sul collegamento, la dashboard collegata si aprirà con l'intervallo di tempo indicato già impostato.
   + **Valori delle variabili**: selezionate questa opzione per includere nel link le variabili del modello attualmente utilizzate come parametri di interrogazione. Quando l'utente fa clic sul link, tutti i modelli corrispondenti nella dashboard collegata vengono impostati sui valori del link. Per ulteriori informazioni, consulta [Variabili URL della dashboard](v9-dash-dashboard-url-variables.md).
   + **Apri in una nuova scheda**: seleziona questa opzione se desideri che il link alla dashboard si apra in una nuova scheda o finestra.

1. Fare clic su **Add (Aggiungi)**.

**Aggiungere un link URL a una dashboard**

Aggiungi un link a un URL nella parte superiore della dashboard corrente. Puoi collegarti a qualsiasi URL disponibile, inclusi dashboard, pannelli o siti esterni. Puoi persino controllare l'intervallo di tempo per assicurarti che l'utente sia ingrandito sui dati giusti in Grafana.

1. **Durante la visualizzazione della dashboard che desideri collegare, fai clic sull'ingranaggio nella parte superiore dello schermo per aprire le impostazioni della dashboard.**

1. Fai clic su **Collegamenti**, quindi su **Aggiungi link alla dashboard** o su **Nuovo**.

1. In Tipo, seleziona **Link**.

1. Seleziona le opzioni di collegamento tra le seguenti.
   + **URL**: inserisci l'URL a cui desideri collegarti. A seconda della destinazione, potresti voler includere i valori dei campi. Per ulteriori informazioni, guarda questo esempio di [Github](https://github.com/grafana/grafana/issues/new?title=Dashboard%3A%20HTTP%20Requests).
   + **Titolo**: inserisci il titolo che desideri venga visualizzato nel link.
   + **Suggerimento**: inserisci il tooltip che desideri venga visualizzato dal link.
   + **Icona**: scegli l'icona che desideri venga visualizzata con il link.
   + **Intervallo di tempo**: seleziona questa opzione per includere l'intervallo di tempo della dashboard nel link. Quando l'utente fa clic sul collegamento, la dashboard collegata si apre con l'intervallo di tempo indicato impostato.
     + `from`definisce il limite inferiore dell'intervallo di tempo, specificato in ms epoch.
     + `to`definisce il limite superiore dell'intervallo di tempo, specificato in ms epoch.
     + `time`e `time.window` definisce un intervallo di tempo da `time-time.window/2` a. `time+time.window/2` Entrambi i parametri devono essere specificati in ms. Ad esempio, `?time=1500000000000&time.window=10000` risulterà in un intervallo di tempo di 10 secondi compreso tra 1499999995000 e 1500000005000.
   + **Valori delle variabili**: selezionate questa opzione per includere nel link le variabili del modello attualmente utilizzate come parametri di interrogazione. Quando l'utente fa clic sul link, tutti i modelli corrispondenti nella dashboard collegata vengono impostati sui valori del link. 

     Il formato della variabile è il seguente: 

     `https://${you-domain}/path/to/your/dashboard?var-${template-varable1}=value1&var-{template-variable2}=value2`
   + **Apri in una nuova scheda**: seleziona questa opzione se desideri che il link alla dashboard si apra in una nuova scheda o finestra

1. Fare clic su **Add (Aggiungi)**.

**Aggiornamento di un link alla dashboard**

Per modificare o aggiornare un link esistente alla dashboard, segui questa procedura.

1. Nelle **impostazioni della dashboard,** nella scheda **Collegamenti**, fai clic sul link esistente che desideri modificare.

1. Modifica le impostazioni, quindi fai clic su **Aggiorna**.

**Duplicazione di un link alla dashboard**

Per duplicare un link esistente alla dashboard, fai clic sull'icona di duplicazione accanto al link esistente che desideri duplicare.

**Eliminazione di un link alla dashboard**

Per eliminare un link esistente alla dashboard, fai clic sull'icona del cestino accanto all'icona duplicata che desideri eliminare.

**Collegamenti al pannello**

Ogni pannello può avere il proprio set di link che vengono visualizzati nell'angolo superiore sinistro del pannello. Puoi collegarti a qualsiasi URL disponibile, inclusi dashboard, pannelli o siti esterni. Puoi persino controllare l'intervallo di tempo per assicurarti che l'utente sia ingrandito sui dati giusti in Grafana.

Per visualizzare i collegamenti disponibili ai pannelli, fai clic sull'icona nell'angolo in alto a sinistra di un pannello.
+ **Aggiungere un collegamento al pannello**: ogni pannello può avere il proprio set di link che vengono visualizzati nell'angolo superiore sinistro del pannello. Puoi collegarti a qualsiasi URL disponibile, inclusi dashboard, pannelli o siti esterni. Puoi persino controllare l'intervallo di tempo per assicurarti che l'utente sia ingrandito sui dati giusti in Grafana. Fai clic sull'icona nell'angolo in alto a sinistra di un pannello per visualizzare i link disponibili.

  1. Passa il cursore sul pannello a cui desideri aggiungere un link, quindi premi. `e` **Oppure fai clic sulla freccia a discesa accanto al titolo del pannello, quindi fai clic su Modifica.**

  1. Nella scheda **Pannello**, scorri verso il basso fino alla sezione **Collegamenti**. 

  1. Espandi **Collegamenti**, quindi fai clic su **Aggiungi collegamento**.

  1. Inserisci un **titolo**. Il **titolo** è un'etichetta leggibile dall'uomo per il collegamento che verrà visualizzato nell'interfaccia utente.

  1. Inserisci l'**URL** a cui desideri collegarti. Puoi anche aggiungere una delle variabili del modello definite nella dashboard. Premi `Ctrl+Space` o `Cmd+Space` e fai clic nel campo URL per visualizzare le variabili disponibili. Aggiungendo variabili modello al link del pannello, il link rimanda l'utente al contesto giusto, con le variabili pertinenti già impostate.

     Puoi anche usare variabili temporali.
     + `from`definisce il limite inferiore dell'intervallo di tempo, specificato in ms epoch.
     + `to`definisce il limite superiore dell'intervallo di tempo, specificato in ms epoch.
     + `time`e `time.window` definisce un intervallo di tempo da `time-time.window/2` a. `time+time.window/2` Entrambi i parametri devono essere specificati in ms. Ad esempio, `?time=1500000000000&time.window=10000` restituisce un intervallo di tempo di 10 secondi compreso tra 1499999995000 e 1500000005000.
+ **Aggiornamento di un collegamento al pannello**

  1. Nella scheda **Pannello**, trova il link a cui desideri apportare modifiche.

  1. Fai clic sull'icona **Modifica** (matita) per aprire la finestra Modifica link.

  1. Apporta le modifiche necessarie:

  1. Fai clic su **Salva** per salvare le modifiche e chiudere la finestra.

  1. Fai clic su **Salva** in alto a destra per salvare le modifiche nella dashboard.
+ **Eliminazione di un collegamento al pannello**

  1. Nella scheda **Pannello**, individuate il link a cui desiderate apportare modifiche.

  1. Fai clic sull'icona **X** accanto al link che desideri eliminare.

  1. Fai clic su **Salva** in alto a destra per salvare le modifiche nella dashboard.

# Modello JSON di dashboard
<a name="v9-dash-dashboard-json-model"></a>

****  
**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)

Una dashboard in Grafana è rappresentata da un oggetto JSON, che memorizza i metadati della relativa dashboard. I metadati della dashboard includono le proprietà della dashboard, i metadati dei pannelli, le variabili del modello e le query dei pannelli.

Per visualizzare il codice JSON di una dashboard.

1. Passa a una dashboard.

1. Nel menu di navigazione in alto, fai clic sull'icona **delle impostazioni della dashboard** (ingranaggio).

1. Fai clic su **Modello JSON**.

**Campi JSON**

Quando un utente crea un nuovo dashboard, viene inizializzato un nuovo oggetto JSON del dashboard con i seguenti campi.

**Nota**  
Nel seguente codice JSON, id viene visualizzato come null, che è il valore predefinito assegnato ad esso fino al salvataggio di un dashboard. Dopo il salvataggio di un pannello di controllo, al campo viene assegnato un valore intero. `id`

```
{
  "id": null,
  "uid": "cLV5GDCkz",
  "title": "New dashboard",
  "tags": [],
  "style": "dark",
  "timezone": "browser",
  "editable": true,
  "graphTooltip": 1,
  "panels": [],
  "time": {
    "from": "now-6h",
    "to": "now"
  },
  "timepicker": {
    "time_options": [],
    "refresh_intervals": []
  },
  "templating": {
    "list": []
  },
  "annotations": {
    "list": []
  },
  "refresh": "5s",
  "schemaVersion": 17,
  "version": 0,
  "links": []
}
```

Di seguito viene descritto ogni campo del dashboard JSON.


| Name | Utilizzo | 
| --- | --- | 
| **id** | identificatore numerico univoco per la dashboard (generato dal db) | 
| **uid** | identificatore univoco del dashboard che può essere generato da chiunque. String (8-40) | 
| **titolo** | titolo attuale del pannello di controllo | 
| **tags** | tag associati alla dashboard, una serie di stringhe | 
| **stile** | tema del cruscotto, ad esempio *scuro* o *chiaro* | 
| **timezone** | *fuso orario della dashboard, ad esempio *utc* o browser* | 
| **modificabile** | se una dashboard è modificabile o meno | 
| **GraphToolTip** | 0 per nessun mirino o tooltip condiviso (impostazione predefinita), 1 per mirino condiviso, 2 per mirino condiviso e tooltip condiviso | 
| **time** | **intervallo di tempo per la dashboard, ad esempio ultime 6 ore o ultimi 7 giorni** | 
| **timepicker** | [metadati timepicker, vedi la sezione timepicker per i dettagli](#v9-dash-dashboard-json-model) | 
| **modellazione** | [creazione di modelli di metadati, consulta la sezione relativa ai modelli per i dettagli](#v9-dash-dashboard-json-model) | 
| **annotations** | [metadati delle annotazioni, vedi le annotazioni per sapere come aggiungerli](v9-panels-annotate-visualizations.md) | 
| **aggiorna** | intervallo di aggiornamento automatico | 
| **schemaVersion** | versione dello schema JSON (intero), incrementata ogni volta che un aggiornamento Grafana apporta modifiche a detto schema | 
| **versione** | versione della dashboard (numero intero), incrementata ogni volta che la dashboard viene aggiornata | 
| **pannelli** | array di pannelli (vedi sotto per i dettagli) | 

**Riquadri**

I pannelli sono gli elementi costitutivi di una dashboard. Consiste in interrogazioni sull'origine dei dati, tipi di grafici, alias e altro. Il pannello JSON è costituito da una serie di oggetti JSON, ognuno dei quali rappresenta un pannello diverso. La maggior parte dei campi è comune a tutti i pannelli, ma alcuni campi dipendono dal tipo di pannello. Quello che segue è un esempio di pannello JSON di un pannello di testo.

```
"panels": [
  {
    "type": "text",
    "title": "Panel Title",
    "gridPos": {
      "x": 0,
      "y": 0,
      "w": 12,
      "h": 9
    },
    "id": 4,
    "mode": "markdown",
    "content": "# title"
  }
```

**Dimensioni e posizione del pannello**

La proprietà gridPos descrive le dimensioni e la posizione del pannello nelle coordinate della griglia.
+ `w`: 1—24 (la larghezza del pannello di controllo è divisa in 24 colonne)
+ `h`: nelle unità di altezza della griglia, ciascuna rappresenta 30 pixel.
+ `x`: La posizione x, nella stessa unità di`w`.
+ `y`: La posizione y, espressa nella stessa unità di`h`.

La griglia ha una gravità negativa che si sposta verso l'alto se c'è spazio vuoto sopra un pannello.

**Timepicker**

```
"timepicker": {
    "collapse": false,
    "enable": true,
    "notice": false,
    "now": true,
    "refresh_intervals": [
      "5s",
      "10s",
      "30s",
      "1m",
      "5m",
      "15m",
      "30m",
      "1h",
      "2h",
      "1d"
    ],
    "status": "Stable",
    "type": "timepicker"
  }
```

**Modellazione**

Il `templating` campo contiene una serie di variabili modello con i relativi valori salvati insieme ad altri metadati.

```
"templating": {
    "enable": true,
    "list": [
       {
        "allFormat": "wildcard",
        "current":  {
          "tags": [],
          "text": "prod",
          "value": "prod"
        },
        "datasource": null,
        "includeAll": true,
        "name": "env",
        "options": [
           {
            "selected": false,
            "text": "All",
            "value": "*"
          },
           {
            "selected": false,
            "text": "stage",
            "value": "stage"
          },
           {
            "selected": false,
            "text": "test",
            "value": "test"
          }
        ],
        "query": "tag_values(cpu.utilization.average,env)",
        "refresh": false,
        "type": "query"
      },
       {
        "allFormat": "wildcard",
        "current":  {
          "text": "apache",
          "value": "apache"
        },
        "datasource": null,
        "includeAll": false,
        "multi": false,
        "multiFormat": "glob",
        "name": "app",
        "options": [
           {
            "selected": true,
            "text": "tomcat",
            "value": "tomcat"
          },
           {
            "selected": false,
            "text": "cassandra",
            "value": "cassandra"
          }
        ],
        "query": "tag_values(cpu.utilization.average,app)",
        "refresh": false,
        "regex": "",
        "type": "query"
      }
    ]
  }
```

# Gestione dei dashboard
<a name="v9-dash-managing-dashboards"></a>

****  
**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)

Una dashboard è un insieme di uno o più [pannelli](v9-panels.md) che presenta visivamente i dati in una o più righe.

Per ulteriori informazioni sulla creazione di dashboard, consulta [Aggiungere e organizzare pannelli]().

## Creazione di cartelle di dashboard
<a name="v9-dash-create-dashboard-folder"></a>

Le cartelle ti aiutano a organizzare e raggruppare le dashboard, il che è utile quando hai molte dashboard o più team che utilizzano la stessa istanza Grafana.

**Prerequisiti**

Assicurati di disporre delle autorizzazioni di amministratore Grafana. [Per ulteriori informazioni sulle autorizzazioni della dashboard, consulta Autorizzazioni della dashboard.](Grafana-administration-authorization.md)

**Per creare una cartella del pannello di controllo**

1. Accedi a Grafana e nel menu laterale, fai clic su **Dashboards** > Nuova cartella

1. **Inserisci un nome univoco e fai clic su Crea.**

**Nota**  
Quando salvi una dashboard, puoi selezionare una cartella in cui salvare la dashboard o creare una nuova cartella.

## Gestione di dashboard e cartelle
<a name="v9-dash-manage-dashboard-folder"></a>

Nella pagina **Gestisci dashboard e cartelle** puoi:
+ Creare una cartella
+ Creazione di un pannello di controllo
+ Sposta i dashboard in cartelle
+ Eliminare più dashboard
+ Accedi a una pagina della cartella in cui puoi assegnare le autorizzazioni per cartelle e dashboard

**Pagina della cartella Dashboard**

È possibile completare le seguenti attività **nella pagina della cartella Dashboard**:
+ Sposta o elimina i dashboard in una cartella.
+ Rinomina una cartella (disponibile nella scheda **Impostazioni**).
+ Assegna le autorizzazioni alle cartelle (che vengono ereditate dai dashboard della cartella).

**Per accedere alla pagina della cartella della dashboard, fai clic sull'ingranaggio che appare quando passi il mouse su una cartella nell'elenco dei risultati di ricerca della dashboard o nella pagina Gestisci dashboard e cartelle.**

**Autorizzazioni della dashboard**

È possibile assegnare autorizzazioni a una cartella. Tutte le autorizzazioni assegnate vengono ereditate dai dashboard della cartella. Viene utilizzata una lista di controllo degli accessi (ACL) in cui è possibile assegnare le autorizzazioni al **ruolo dell'organizzazione**, al **team** e a un **utente**.

Per ulteriori informazioni, consulta [le autorizzazioni](Grafana-permissions.md).

## Esportazione e importazione di dashboard
<a name="v9-dash-export-import-dashboards"></a>

Puoi utilizzare l'interfaccia utente Grafana o l'API HTTP per esportare e importare dashboard.

**Esportazione di un pannello di controllo**

L'azione di esportazione del dashboard crea un file JSON Grafana che contiene tutto ciò di cui hai bisogno, inclusi layout, variabili, stili, fonti di dati, query e così via, in modo da poter importare la dashboard in un secondo momento.

**Nota**  
Grafana scarica un file JSON sul computer locale. 

1. Apri il pannello di controllo che desideri esportare.

1. Seleziona l'icona di condivisione.

1. Scegli **Export** (Esporta).

1. Scegli **Salva su file.**

**Rendere portatile una dashboard**

Se desideri esportare una dashboard per farla usare ad altri, puoi aggiungere variabili modello per cose come un prefisso metrico (usa una variabile costante) e il nome del server.

Una variabile modello di questo tipo `Constant` verrà automaticamente nascosta nella dashboard e verrà aggiunta anche come input obbligatorio quando la dashboard viene importata.

**Importazione di un pannello di controllo**

1. Scegli **Dashboard** nel menu laterale.

1. Scegli **Nuovo**, quindi seleziona **Importa** dal menu a discesa.

1. Eseguire una delle seguenti fasi.
   + Carica un file JSON del pannello di controllo.
   + Incolla l'URL di un [pannello di controllo Grafana.com](https://grafana.com/).
   + Incolla il testo JSON della dashboard direttamente nell'area di testo.

   Il processo di importazione consente di modificare il nome della dashboard, scegliere l'origine dati che si desidera che venga utilizzata dalla dashboard e specificare eventuali prefissi delle metriche (se la dashboard ne utilizza uno).

## Dashboard di risoluzione dei problemi
<a name="v9-dash-troubleshooting"></a>

Questa sezione fornisce informazioni per aiutarti a risolvere i problemi più comuni delle dashboard. 

**La dashboard è lenta**

Se la dashboard è lenta, considera quanto segue:
+ Stai cercando di renderizzare dozzine (o centinaia o migliaia) di serie temporali su un grafico? Ciò può causare ritardi nel browser. Prova a utilizzare funzioni come HighestMax (in Graphite) per ridurre le serie restituite.
+ A volte i nomi delle serie possono essere molto grandi. Ciò causa dimensioni di risposta maggiori. Prova a utilizzare l'alias per ridurre la dimensione dei nomi delle serie restituiti.
+ Stai interrogando molte serie temporali o per un lungo intervallo di tempo? Entrambe queste condizioni possono far sì che Grafana o la tua fonte di dati raccolga molti dati, il che può rallentarli.
+ Potrebbe essere un carico elevato sull'infrastruttura di rete. Se la lentezza non è costante, questo potrebbe essere il problema.

**Problemi relativi alla frequenza di aggiornamento del pannello di controllo**

Per impostazione predefinita, Grafana interroga la tua fonte di dati ogni 30 secondi. L'impostazione di una frequenza di aggiornamento bassa sui dashboard comporta uno stress inutile sul backend. In molti casi, non è necessario interrogarlo frequentemente perché i dati non vengono inviati al sistema in modo tale da consentire la visualizzazione delle modifiche.

Se si verifica questo problema, si consigliano le seguenti soluzioni.
+ Non abilitare l'aggiornamento automatico su dashboard, pannelli o variabili a meno che non sia necessario. Gli utenti possono aggiornare il browser manualmente oppure puoi impostare la frequenza di aggiornamento per un periodo di tempo adeguato (ad esempio ogni dieci minuti o ogni ora).
+ Se necessario, imposta la frequenza di aggiornamento su una volta al minuto. Gli utenti possono sempre aggiornare la dashboard manualmente.
+ Se la dashboard ha un periodo di tempo più lungo (ad esempio una settimana), l'aggiornamento automatico potrebbe non essere necessario.

**La gestione o il rendering di dati nulli sono errati o creano confusione**

Alcune applicazioni pubblicano i dati in modo intermittente. Ad esempio, pubblicano una metrica solo quando si verifica un evento. Per impostazione predefinita, i grafici Grafana collegano le linee tra i punti dati.

# Condivisione di dashboard e pannelli
<a name="v9-dash-sharing"></a>

****  
**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 consente di condividere dashboard e pannelli con altri utenti all'interno di un'organizzazione e, in determinate situazioni, pubblicamente sul Web. Puoi condividere usando:
+ Un link diretto
+ Un'istantanea
+ Un link di esportazione (solo per i dashboard)

È necessario disporre del permesso di visualizzazione autorizzato per visualizzare un'immagine resa da un link diretto.

La stessa autorizzazione è richiesta anche per visualizzare i link incorporati, a meno che tu non abbia abilitato l'autorizzazione di accesso anonimo per la tua istanza Grafana.

Quando condividi un pannello o una dashboard come istantanea, un'istantanea (che è un pannello o una dashboard nel momento in cui scatti l'istantanea) è disponibile pubblicamente sul Web. Chiunque abbia un link ad esso può accedervi. Poiché le istantanee non richiedono alcuna autorizzazione per la visualizzazione, Grafana rimuove le informazioni relative all'account da cui provengono, nonché tutti i dati sensibili dall'istantanea.

## Condivisione di una dashboard
<a name="v9-dash-share-dashboard"></a>

Puoi condividere una dashboard come collegamento diretto o come istantanea. Puoi anche esportare una dashboard.

**Nota**  
Se modifichi una dashboard, assicurati di salvare le modifiche prima di condividerle.

1. Vai alla home page dell'istanza Grafana.

1. Fai clic sull'icona di condivisione nella barra di navigazione in alto.

   La finestra di dialogo di condivisione si aprirà e mostrerà la scheda **Link**.

**Condivisione di un link diretto**

La scheda **Link** mostra l'intervallo di tempo corrente, le variabili del modello e il tema predefinito. Puoi anche condividere un URL abbreviato.

1. Fare clic su **Copy (Copia)**. Questa azione copia l'URL predefinito o abbreviato negli Appunti.

1. Invia l'URL copiato a un utente Grafana con l'autorizzazione a visualizzare il link.

**Pubblicazione di un'istantanea**

Un'istantanea della dashboard condivide pubblicamente una dashboard interattiva. Grafana rimuove i dati sensibili come le query (metriche, template e annotazioni) e i collegamenti ai pannelli, lasciando solo i dati metrici visibili e i nomi delle serie incorporati nella dashboard. Le istantanee della dashboard sono accessibili a chiunque disponga del link.

Puoi pubblicare istantanee sulla tua istanza locale.

1. Fate clic su **Istantanea locale**.

1. Grafana genera un link dell'istantanea. Copia il link all'istantanea e condividilo all'interno della tua organizzazione o pubblicamente sul Web.

**Esportazione di una dashboard**

Le dashboard Grafana possono essere facilmente esportate e importate. Per ulteriori informazioni, [consulta Esportazione e](v9-dash-managing-dashboards.md#v9-dash-export-import-dashboards) importazione di dashboard.

## Condivisione di un pannello
<a name="v9-dash-share-panel"></a>

Puoi condividere un pannello come collegamento diretto o come istantanea. Puoi anche creare pannelli di libreria usando l'opzione **Condividi** su qualsiasi pannello.

1. Fate clic sul titolo di un pannello per aprire il menu del pannello.

1. Fate clic su **Condividi**. La finestra di dialogo di condivisione si aprirà e mostrerà la scheda **Link**.

**Utilizzando un link diretto**

La scheda **Link** mostra l'intervallo di tempo corrente, le variabili del modello e il tema predefinito. Facoltativamente, puoi abilitare un URL abbreviato da condividere. 

1. Fai clic su **Copia** per copiare l'URL predefinito o abbreviato negli appunti. 

1. Invia l'URL copiato a un utente Grafana con l'autorizzazione a visualizzare il link.

1. Facoltativamente, puoi anche fare clic su **Immagine renderizzata con collegamento diretto** per condividere un'immagine del pannello.

**Interrogazione dei parametri delle stringhe per le immagini renderizzate lato server**
+ **larghezza: larghezza** in pixel. L'impostazione predefinita è 800.
+ **altezza**: altezza in pixel. Il valore predefinito è 400.
+ **tz**: fuso orario nel formato in `UTC%2BHH%3AMM` cui HH e MM sono sfalsati in ore e minuti dopo l'UTC.
+ **timeout: numero di secondi**. Il timeout può essere aumentato se la query per il pannello richiede più dei 30 secondi predefiniti.
+ **scala**: valore numerico per configurare il fattore di scala del dispositivo. Il valore predefinito è 1. Usa un valore più alto per produrre immagini più dettagliate (DPI più alti). Supportato in Grafana v7.0\$1.

**Pubblicazione di un'istantanea**

Un'istantanea del pannello condivide pubblicamente un pannello interattivo. Grafana rimuove i dati sensibili lasciando solo i dati metrici visibili e i nomi delle serie incorporati nella dashboard. Le istantanee del pannello sono accessibili a chiunque disponga del link

Puoi pubblicare istantanee sulla tua istanza locale.

1. Nella finestra di dialogo **Share Panel**, fate clic su **Istantanea** per aprire la scheda.

1. Fate clic su **Istantanea locale**. Grafana genera il link dell'istantanea.

1. Copia il link all'istantanea e condividilo all'interno della tua organizzazione o pubblicamente sul Web.

Se hai creato un'istantanea per errore, fai clic su **Elimina istantanea** per rimuovere l'istantanea dall'istanza Grafana.

**Creazione di un pannello della libreria**

Per creare un pannello della libreria dalla finestra di dialogo **Share Panel**.

1. Fate clic sul **pannello Libreria**.

1. Nel **nome del pannello Libreria**, inserite il nome.

1. In **Salva nella cartella**, selezionate la cartella in cui salvare il pannello della libreria. Per impostazione predefinita, è selezionata la cartella **Generale**.

1. Fate clic sul pannello **Crea libreria** per salvare le modifiche.

1. Fai clic su **Salva** per salvare la dashboard.

# Gestione delle playlist
<a name="v9-dash-managing-playlists"></a>

****  
**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)

Una *playlist* è un elenco di dashboard che vengono visualizzate in sequenza. Puoi usare una playlist per aumentare la consapevolezza della situazione o per presentare le tue metriche al tuo team o ai visitatori. Grafana ridimensiona automaticamente le dashboard a qualsiasi risoluzione, il che le rende perfette per schermi di grandi dimensioni. **Puoi accedere alla funzione playlist dal menu laterale di Grafana nel sottomenu Dashboards.**

## Accesso, condivisione e controllo di una playlist
<a name="v9-dash-access-share-control-playlist"></a>

Utilizza le informazioni in questa sezione per accedere alle playlist esistenti. Avvia e controlla la visualizzazione di una playlist utilizzando una delle cinque modalità disponibili.

**Accedere a una playlist**

1. Passa il cursore sul menu laterale di Grafana.

1. **Fai clic su Playlist.**

   Verrà visualizzato un elenco di playlist esistenti.

**Avvio di una playlist**

È possibile avviare una playlist in cinque diverse modalità di visualizzazione. La modalità di visualizzazione determina la modalità di visualizzazione dei menu e della barra di navigazione nei dashboard.

Per impostazione predefinita, ogni dashboard viene visualizzata per il periodo di tempo immesso nel campo **Intervallo**, che viene impostato quando si crea o si modifica una playlist. Dopo aver avviato una playlist, puoi controllarla con la barra di navigazione nella parte superiore della pagina.

La playlist mostra ogni dashboard per il tempo specificato nel `Interval` campo, impostato durante la creazione o la modifica di una playlist. Dopo l'avvio di una playlist, puoi controllarla utilizzando la barra di navigazione nella parte superiore dello schermo.

1. Accedi alla pagina della playlist per visualizzare un elenco di playlist esistenti.

1. Trova la playlist che desideri avviare, quindi fai clic su **Avvia playlist**.

   Si aprirà la finestra di dialogo di avvio della playlist.

1. Seleziona una delle cinque modalità di playlist disponibili in base alle informazioni riportate nella tabella seguente.

1. Fate clic su Avvia.


| Modalità | Description | 
| --- | --- | 
| Modalità normale |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/v9-dash-managing-playlists.html)  | 
| modalità TV |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/v9-dash-managing-playlists.html)  | 
| modalità TV (con pannelli ad adattamento automatico) |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/v9-dash-managing-playlists.html)  | 
| modalità Kiosk |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/v9-dash-managing-playlists.html)  | 
| Modalità Kiosk (con pannelli ad adattamento automatico) |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/v9-dash-managing-playlists.html)  | 

**Controllo di una playlist**

Puoi controllare una playlist in modalità **Normale** o **TV** dopo l'avvio, utilizzando la barra di navigazione nella parte superiore dello schermo. Premi il `Esc` tasto della tastiera per interrompere la playlist.


| Button | Azione | 
| --- | --- | 
| Avanti (doppia freccia destra) | Passa alla dashboard successiva. | 
| Indietro (freccia sinistra) | Torna alla dashboard precedente. | 
| Stop (quadrato) | Termina la playlist e passa alla dashboard corrente. | 
| modalità di visualizzazione ciclica (icona del monitor) | Ruota la visualizzazione dei dashboard in diverse modalità di visualizzazione. | 
| Intervallo temporale | Visualizza i dati entro un intervallo di tempo. Può essere impostato per visualizzare gli ultimi 5 minuti fino a 5 anni fa o un intervallo di tempo personalizzato, utilizzando la freccia rivolta verso il basso. | 
| Aggiorna (freccia circolare) | Ricarica la dashboard per visualizzare i dati correnti. Può essere impostato per ricaricarsi automaticamente ogni 5 secondi o 1 giorno, utilizzando la freccia a discesa. | 

## Creare una playlist
<a name="v9-dash-create-playlist"></a>

Puoi creare una playlist per presentare le dashboard in una sequenza con un ordine e un intervallo di tempo prestabiliti tra le dashboard.

1. Fai clic su **Nuova playlist** nella pagina della playlist.

1. Inserisci un nome descrittivo nella casella di testo **Nome**.

1. Immettete un intervallo di tempo nella casella di testo **Intervallo.**
**Nota**  
I dashboard aggiunti sono elencati in ordine sequenziale.

1. Nelle **dashboard**, aggiungi le dashboard esistenti alla playlist utilizzando le opzioni a discesa **Aggiungi per titolo** e **Aggiungi per tag**.

1. Facoltativamente:
   + Cerca una dashboard in base al nome, a un'espressione regolare o a un tag.
   + Filtra i risultati in base allo stato o ai tag contrassegnati con una stella.
   + Riorganizza l'ordine della dashboard che hai aggiunto utilizzando l'icona a forma di freccia su e giù.
   + Rimuovi una dashboard dalla playlist facendo clic sull'icona **X** accanto alla dashboard.

1. Fare clic su **Save (Salva)** per salvare le modifiche.

## Salvare una playlist
<a name="v9-dash-save-playlist"></a>

Puoi salvare una playlist e aggiungerla alla tua pagina **Playlist**, dove puoi avviarla.

**Importante**  
Assicurati che tutte le dashboard che desideri vengano aggiunte nella playlist quando crei o modifichi la playlist prima di salvarla.

1. Per accedere alla funzione playlist, posiziona il cursore sul menu laterale di Grafana.

1. Fai clic su **Playlist** per visualizzare le playlist disponibili.

1. Fai clic sulla playlist che preferisci.

1. Modifica la playlist.

1. Verifica che la playlist abbia un **nome**, un **intervallo** e almeno una **dashboard** aggiunta.

1. Fare clic su **Save (Salva)** per salvare le modifiche.

## Modificare o eliminare una playlist
<a name="v9-dash-edit-delete-playlist"></a>

Puoi modificare una playlist aggiornandone il nome, l'intervallo di tempo e aggiungendo, rimuovendo e riorganizzando l'ordine delle dashboard.

**Modificare una playlist**

1. Fai clic su **Modifica playlist** nella pagina della playlist.

1. Aggiorna il nome e l'intervallo di tempo, quindi aggiungi o rimuovi dashboard dalla playlist seguendo le istruzioni riportate nella sezione Crea una playlist, sopra.

1. Fare clic su **Save (Salva)** per salvare le modifiche.

**Eliminazione di una playlist**

1. Fai clic su **Playlist**.

1. Fai clic su **Rimuovi** accanto alla playlist che desideri eliminare.

**Riorganizzazione dell'ordine della dashboard**

1. Accanto alla dashboard che desideri spostare, fai clic sulla freccia rivolta verso l'alto o verso il basso.

1. Fare clic su **Save (Salva)** per salvare le modifiche.

**Rimuovere un pannello di controllo**

1. Fai clic su **Rimuovi** per rimuovere una dashboard dalla playlist.

1. Fare clic su **Save (Salva)** per salvare le modifiche.

## Condivisione di una playlist in modalità di visualizzazione
<a name="v9-dash-share-playlist-view-mode"></a>

Puoi condividere una playlist copiando l'indirizzo del link nella modalità di visualizzazione che preferisci e incollando l'URL nella destinazione.

1. **Dal sottomenu **Dashboards**, fai clic su Playlist.**

1. Fai clic su **Avvia playlist** accanto alla playlist che desideri condividere.

1. Nel menu a discesa, fai clic con il pulsante destro del mouse sulla modalità di visualizzazione che preferisci.

1. Fai clic su **Copia l'indirizzo del link** per copiare l'URL negli appunti.

1. Incolla l'URL nella tua destinazione.

# Aggiungere e gestire le variabili del dashboard
<a name="v9-dash-variables"></a>

****  
**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)

Una variabile è un segnaposto per un valore. È possibile utilizzare le variabili nelle query metriche e nei titoli dei pannelli. Pertanto, quando modifichi il valore, utilizzando il menu a discesa nella parte superiore della dashboard, le query metriche del pannello cambieranno per riflettere il nuovo valore.

Le variabili ti consentono di creare dashboard più interattive e dinamiche. Invece di codificare elementi come i nomi di server, applicazioni e sensori nelle query metriche, puoi utilizzare variabili al loro posto. Le variabili vengono visualizzate come elenchi a discesa nella parte superiore della dashboard. Questi menu a discesa semplificano la modifica dei dati visualizzati nella dashboard.

Questi possono essere particolarmente utili per gli amministratori che desiderano consentire agli utenti di Grafana di regolare rapidamente le visualizzazioni ma non vogliono concedere loro autorizzazioni di modifica complete. I visualizzatori Grafana possono utilizzare variabili.

Le variabili e i modelli consentono inoltre di creare dashboard a fonte singola. Se disponi di più sorgenti di dati o server identici, puoi creare un'unica dashboard e utilizzare le variabili per modificare ciò che stai visualizzando. Ciò semplifica enormemente la manutenzione e la manutenzione.

**Modelli**

Un modello è qualsiasi interrogazione che contiene una variabile. Ad esempio, se si amministra una dashboard per monitorare diversi server, è possibile creare una dashboard per ogni server oppure creare una dashboard e utilizzare pannelli con query di modello, come le seguenti.

```
wmi_system_threads{instance=~"$server"}
```

I valori delle variabili vengono sempre sincronizzati con l'URL utilizzando la sintassi var- =value. <varname>

**Esempi**

Le variabili sono elencate in elenchi a discesa nella parte superiore dello schermo. Seleziona diverse variabili per vedere come cambiano le visualizzazioni.

Per visualizzare le impostazioni delle variabili, accedi a Impostazioni della **dashboard >** Variabili. Fai clic su una variabile nell'elenco per visualizzarne le impostazioni. 

Le variabili possono essere utilizzate nei titoli, nelle descrizioni, nei pannelli di testo e nelle interrogazioni. Le interrogazioni con testo che inizia con `$` sono modelli. Non tutti i pannelli avranno interrogazioni basate sui modelli.

**Procedure ottimali variabili**
+ Gli elenchi a discesa delle variabili vengono visualizzati nell'ordine in cui sono elencati nell'elenco delle variabili nelle **impostazioni della dashboard**.
+ Metti le variabili che cambierai spesso in alto, in modo che vengano mostrate per prime (all'estrema sinistra sulla dashboard).

# Aggiungere e gestire variabili
<a name="v9-dash-variable-add"></a>

****  
**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)

La tabella seguente elenca i tipi di variabili forniti con Grafana.


| Tipo della variabile | Description | 
| --- | --- | 
|  Query  |  Elenco di valori generato da query come nomi di metriche, nomi di server, sensori IDs, data center e così via. Aggiungere una variabile di interrogazione.  | 
|  Personalizzato  |  Definite manualmente le opzioni della variabile utilizzando un elenco separato da virgole. Aggiungi una variabile personalizzata.  | 
|  Text box (Casella di testo)  |  Visualizza un campo di immissione di testo libero con un valore predefinito opzionale. Aggiungi una variabile per la casella di testo.  | 
|  Costante  |  Definire una costante nascosta. Aggiungi una variabile costante.  | 
|  Origine dati  |  Cambia rapidamente la fonte di dati per un'intera dashboard. Aggiungi una variabile di origine dati.  | 
|  Interval  |  Le variabili di intervallo rappresentano intervalli di tempo. Aggiungere una variabile di intervallo.  | 
|  Filtri ad hoc  |  Filtri chiave-valore che vengono aggiunti automaticamente a tutte le query metriche per un'origine dati (solo Prometheus, Loki, InfluxDB ed Elasticsearch). Aggiungi filtri ad hoc.  | 
|  Variabili globali  |  Variabili integrate che possono essere utilizzate nelle espressioni dell'editor di query. Fare riferimento a Variabili globali.  | 
|  Variabili concatenate  |  Le interrogazioni variabili possono contenere altre variabili. Fare riferimento a Variabili concatenate.  | 

## Inserimento delle opzioni generali
<a name="v9-dash-variable-options"></a>

È necessario immettere opzioni generali per qualsiasi tipo di variabile creata.

**Per inserire opzioni generali**

1. Vai alla dashboard per cui desideri creare una variabile e seleziona l'icona **delle impostazioni della dashboard** (a forma di ingranaggio) nella parte superiore della pagina.

1. Nella scheda **Variabili**, seleziona **Nuovo**.

1. Immettete un **nome** per la variabile.

1. Nell'elenco **Tipo**, selezionare **Interrogazione**.

1. (Facoltativo) In **Etichetta**, inserite il nome visualizzato del menu a discesa della variabile.

   Se non inserisci un nome visualizzato, l'etichetta del menu a discesa è il nome della variabile.

1. Scegli un'opzione **Nascondi**:
   + **Nessuna selezione (vuota):** l'elenco a discesa della variabile mostra il **nome** o il valore dell'**etichetta** della variabile.
   + **Etichetta:** l'elenco a discesa della variabile mostra solo il valore della variabile selezionata e una freccia rivolta verso il basso.
   + **Variabile:** nella dashboard non viene visualizzato alcun menu a discesa delle variabili.

## Aggiungere una variabile di query
<a name="v9-dash-variable-add-query"></a>

Le variabili di query consentono di scrivere una query sull'origine dati in grado di restituire un elenco di nomi di metriche, valori di tag o chiavi. Ad esempio, una variabile di query potrebbe restituire un elenco di nomi di server IDs, sensori o data center. I valori delle variabili cambiano man mano che recuperano dinamicamente le opzioni con una query sull'origine dei dati.

Le variabili di query sono generalmente supportate solo per le stringhe. Se la query restituisce numeri o qualsiasi altro tipo di dati, potrebbe essere necessario convertirli in stringhe per utilizzarli come variabili. Per l'origine dati di Azure, ad esempio, puoi usare la funzione [tostring](https://docs.microsoft.com/en-us/azure/data-explorer/kusto/query/tostringfunction) per questo scopo.

Le espressioni di query possono contenere riferimenti ad altre variabili e in effetti creare variabili collegate. Grafana lo rileva e aggiorna automaticamente una variabile quando una delle sue variabili collegate cambia.

**Nota**  
Le espressioni di query sono diverse per ogni fonte di dati. Per ulteriori informazioni, consulta la documentazione relativa all'[origine dati](AMG-data-sources.md).

**Per aggiungere una variabile di query**

1. Inserisci le opzioni generali, come sopra.

1. Nell'elenco **Origine dati**, seleziona l'origine dati di destinazione per la query.

1. Nell'elenco **Aggiorna**, selezionate quando la variabile deve aggiornare le opzioni.
   + **Al caricamento del dashboard:** interroga l'origine dei dati ogni volta che viene caricato il dashboard. Ciò rallenta il caricamento della dashboard, poiché la query variabile deve essere completata prima di poter inizializzare la dashboard.
   + **In caso di modifica dell'intervallo di tempo:** interroga l'origine dati quando l'intervallo di tempo del dashboard cambia. Utilizza questa opzione solo se la tua query sulle opzioni variabili contiene un filtro per intervallo di tempo o dipende dall'intervallo di tempo del dashboard.

1. Nel campo **Query**, inserisci una query.
   + Il campo di interrogazione varia in base alla fonte di dati. Alcune fonti di dati dispongono di editor di query personalizzati.
   + Se hai bisogno di più spazio in un unico editor di interrogazioni con campo di input, posiziona il cursore sulle linee nell'angolo inferiore destro del campo e trascina verso il basso per espandere.

1. (Facoltativo) Nel campo **Regex**, digita un'espressione regex per filtrare o acquisire parti specifiche dei nomi restituiti dalla query sull'origine dati. Per vedere degli esempi, consulta [Filtrare le variabili con regex](#v9-dash-variable-add-filter).

1. Nell'elenco **Ordinamento**, seleziona il tipo di ordinamento dei valori da visualizzare nell'elenco a discesa. L'opzione predefinita, **Disabilitata**, indica che verrà utilizzato l'ordine delle opzioni restituite dalla query sull'origine dei dati.

1. (Facoltativo) Inserite [le opzioni di selezione](#v9-dash-variable-add-selection).

1. In **Anteprima dei valori**, Grafana mostra un elenco dei valori delle variabili correnti. Controllali per assicurarti che corrispondano a ciò che ti aspetti.

1. Seleziona **Aggiungi** per aggiungere la variabile alla dashboard.

## Aggiungere una variabile personalizzata
<a name="v9-dash-variable-add-custom"></a>

Usa una variabile *personalizzata* per un valore che non cambia, ad esempio un numero o una stringa.

Ad esempio, se hai nomi di server o nomi di regioni che non cambiano mai, potresti volerli creare come variabili personalizzate anziché variabili di query. Poiché non vengono modificate, è possibile utilizzarle in [variabili concatenate](#v9-dash-variable-add-chained) anziché in altre variabili di query. Ciò ridurrebbe il numero di query che Grafana deve inviare quando le variabili concatenate vengono aggiornate.

**Per aggiungere una variabile personalizzata**

1. Inserisci le opzioni generali, come sopra.

1. Nel 

   **Valori separati da virgole**, immettete i valori di questa variabile in un elenco separato da virgole. È possibile includere numeri, stringhe o coppie chiave-valore separate da uno spazio e due punti. Ad esempio, `key1 : value1,key2 : value2`.

1. [(Facoltativo) Inserite le opzioni di selezione.](#v9-dash-variable-add-selection)

1. In **Anteprima dei valori**, Grafana mostra un elenco dei valori delle variabili correnti. Controllali per assicurarti che corrispondano a ciò che ti aspetti.

1. Seleziona **Aggiungi** per aggiungere la variabile alla dashboard.

## Aggiungere una variabile alla casella di testo
<a name="v9-dash-variable-add-text"></a>

Le variabili delle *caselle* di testo visualizzano un campo di immissione di testo libero con un valore predefinito opzionale. Questa è la variabile più flessibile, in quanto è possibile inserire qualsiasi valore. Utilizza questo tipo di variabile se disponi di metriche con cardinalità elevata o se desideri aggiornare più pannelli in una dashboard contemporaneamente.

**Per aggiungere una variabile di casella di testo**

1. Inserisci le opzioni generali, come sopra.

1. (Facoltativo) Nel campo **Valore predefinito**, selezionate il valore predefinito per la variabile. Se non si inserisce nulla in questo campo, Grafana visualizza una casella di testo vuota in cui gli utenti possono digitare il testo.

1. In **Anteprima dei valori**, Grafana mostra un elenco dei valori delle variabili correnti. Controllali per assicurarti che corrispondano a ciò che ti aspetti.

1. Seleziona **Aggiungi** per aggiungere la variabile alla dashboard.

## Aggiungere una variabile costante
<a name="v9-dash-variable-add-constant"></a>

Le variabili *costanti* consentono di definire una costante nascosta. Ciò è utile per i prefissi dei percorsi metrici per i dashboard che desideri condividere. Quando esporti una dashboard, le variabili costanti vengono convertite in opzioni di importazione.

Le variabili costanti *non* sono flessibili. Ogni variabile costante contiene solo un valore e non può essere aggiornata a meno che non si aggiornino le impostazioni della variabile.

Le variabili costanti sono utili quando si hanno valori complessi da includere nelle query ma non si desidera digitare nuovamente in ogni query. Ad esempio, se hai chiamato un percorso del server`i-0b6a61efe2ab843gg`, puoi sostituirlo con una variabile chiamata. `$path_gg`

**Per aggiungere una variabile costante**

1. Inserisci le opzioni generali, come sopra.

1. Nel campo **Valore**, inserisci il valore della variabile. È possibile inserire lettere, numeri e simboli. Puoi anche usare i caratteri jolly se usi il [formato raw](https://grafana.com/docs/grafana/latest/dashboards/variables/variable-syntax/#raw).

1. In **Anteprima dei valori**, Grafana mostra un elenco dei valori delle variabili correnti. Controllali per assicurarti che corrispondano a ciò che ti aspetti.

1. Seleziona **Aggiungi** per aggiungere la variabile alla dashboard.

## Aggiungere una variabile di origine dati
<a name="v9-dash-variable-add-datasource"></a>

Le variabili di *origine dati* consentono di modificare rapidamente l'origine dati per un intero dashboard. Sono utili se disponi di più istanze di un'origine dati, magari in ambienti diversi.

**Per aggiungere una variabile di origine dati**

1. Inserisci le opzioni generali, come sopra.

1. Nell'elenco **Tipo**, selezionate l'origine dati di destinazione per la variabile.

1. (Facoltativo) In **Filtro del nome dell'istanza**, inserisci un filtro regex per le istanze di origine dati tra cui scegliere nell'elenco a discesa dei valori delle variabili. Lascia vuoto questo campo per visualizzare tutte le istanze.

1. (Facoltativo) Inserite [le opzioni di selezione](#v9-dash-variable-add-selection).

1. In **Anteprima dei valori**, Grafana mostra un elenco dei valori delle variabili correnti. Controllali per assicurarti che corrispondano a ciò che ti aspetti.

1. Seleziona **Aggiungi** per aggiungere la variabile alla dashboard.

## Aggiungere una variabile di intervallo
<a name="v9-dash-variable-add-internal"></a>

Utilizzate una variabile di *intervallo* per rappresentare intervalli di tempo come`1m`, `1h` o. `1d` *Puoi considerarli come un gruppo a livello di dashboard basato su un comando temporale.* Le variabili di intervallo modificano il modo in cui i dati vengono raggruppati nella visualizzazione. È inoltre possibile utilizzare l'opzione Auto per restituire un determinato numero di punti dati per intervallo di tempo.

È possibile utilizzare una variabile di intervallo come parametro per raggruppare per ora (per InfluxDB), intervallo di data e istogramma (per Elasticsearch) o come parametro della funzione di riepilogo (per Graphite).

**Per aggiungere una variabile di intervallo**

1. Inserisci le opzioni generali, come sopra.

1. Nel campo **Valori**, inserisci gli intervalli di tempo che desideri vengano visualizzati nell'elenco a discesa delle variabili. Sono supportate le seguenti unità di tempo:`s (seconds)`,`m (minutes)`,`h (hours)`,`d (days)`, `w (weeks)``M (months)`, e. `y (years)` Puoi anche accettare o modificare i valori predefiniti:`1m,10m,30m,1h,6h,12h,1d,7d,14d,30d`.

1. (Facoltativo) Attiva **l'opzione Auto** se desideri aggiungere l'`auto`opzione all'elenco. Questa opzione consente di specificare quante volte l'intervallo di tempo corrente deve essere diviso per calcolare l'intervallo di `auto` tempo corrente. Se lo accendi, vengono visualizzate altre due opzioni:
   + **Conteggio dei passaggi:** seleziona il numero di volte in cui l'intervallo di tempo corrente verrà diviso per calcolare il valore, in modo simile all'opzione di interrogazione **Max data points**. Ad esempio, se l'intervallo di tempo visibile corrente è di 30 minuti, l'`auto`intervallo raggruppa i dati in 30 incrementi di un minuto. Il valore predefinito è 30 passaggi.
   + **Intervallo minimo: la soglia minima al** di sotto della quale gli intervalli di conteggio dei passi non divideranno il tempo. Per continuare con l'esempio di 30 minuti, se l'intervallo minimo è impostato su 2 m, Grafana raggrupperà i dati in 15 incrementi di due minuti.

1. In **Anteprima dei valori**, Grafana mostra un elenco dei valori delle variabili correnti. Controllali per assicurarti che corrispondano a ciò che ti aspetti.

1. Seleziona **Aggiungi** per aggiungere la variabile alla dashboard.

**Esempi di variabili a intervallo**

L'esempio seguente mostra una variabile modello `myinterval` in una funzione Graphite:

```
summarize($myinterval, sum, false)
```

## Aggiungere filtri ad hoc
<a name="v9-dash-variable-add-adhoc"></a>

*I filtri ad hoc* consentono di aggiungere filtri chiave-valore che vengono aggiunti automaticamente a tutte le query metriche che utilizzano l'origine dati specificata. A differenza di altre variabili, non si utilizzano filtri ad hoc nelle query. Utilizzate invece filtri ad hoc per scrivere filtri per le query esistenti.

**Nota**  
Le variabili di filtro ad hoc funzionano solo con le fonti di dati Prometheus, Loki, InfluxDB ed Elasticsearch.

1. Inserisci le opzioni generali, come sopra.

1. Nell'elenco **Origine dati**, seleziona l'origine dati di destinazione.

1. Seleziona **Aggiungi** per aggiungere la variabile alla dashboard.

**Crea filtri ad hoc**

I filtri ad hoc sono una delle opzioni variabili più complesse e flessibili disponibili. Invece di un normale elenco di opzioni variabili, questa variabile consente di creare una query ad hoc a livello di dashboard. I filtri applicati in questo modo vengono applicati a tutti i pannelli della dashboard.

## Configura le opzioni di selezione delle variabili
<a name="v9-dash-variable-add-selection"></a>

**Le opzioni di selezione** sono una funzionalità che è possibile utilizzare per gestire le selezioni di opzioni variabili. Tutte le opzioni di selezione sono opzionali e sono disattivate per impostazione predefinita.

### Variabili multivalore
<a name="v9-dash-variable-add-selection-multi"></a>

L'interpolazione di una variabile con più valori selezionati è complicata in quanto non è semplice formattare i valori multipli in una stringa valida nel contesto dato in cui viene utilizzata la variabile. Grafana cerca di risolvere questo problema consentendo a ciascun plug-in di origine dati di comunicare al motore di interpolazione dei modelli quale formato utilizzare per più valori.

**Nota**  
L'opzione **Personalizza tutti i valori** sulla variabile deve essere vuota affinché Grafana formatti tutti i valori in un'unica stringa. Se viene lasciato vuoto, Grafana concatena (somma) tutti i valori della query. Ad esempio, `value1,value2,value3`. Se viene utilizzato un `all` valore personalizzato, il valore sarà invece o. `*` `all`

**Variabili multivalore con una fonte di dati Graphite**

Graphite utilizza espressioni globulari. **Una variabile con più valori, in questo caso, verrebbe interpolata come `{host1,host2,host3}` se il valore della variabile corrente fosse *host1, host2 e host3*.**

**Variabili multivalore con un'origine dati Prometheus o InfluxDB**

InfluxDB e Prometheus utilizzano espressioni regex, quindi la stessa variabile verrebbe interpolata di. `(host1|host2|host3)` Ogni valore verrebbe inoltre escluso dall'espressione regolare. In caso contrario, un valore con un carattere di controllo regex interromperebbe l'espressione regex.

**Variabili multivalore con un'origine dati elastica**

Elasticsearch utilizza la sintassi delle query lucene, quindi la stessa variabile verrebbe formattata come. `("host1" OR "host2" OR "host3")` In questo caso, è necessario escludere ogni valore in modo che il valore contenga solo le parole di controllo Lucene e le virgolette.

**Risolvi i problemi relativi alle variabili multivalore**

L'escape e la formattazione automatici possono causare problemi e può essere difficile comprenderne la logica alla base. Soprattutto per InfluxDB e Prometheus, dove l'uso della sintassi regex richiede che la variabile venga utilizzata nel contesto dell'operatore regex.

Se non vuoi che Grafana esegua l'escape e la formattazione automatica delle espressioni regolari, devi eseguire una delle seguenti operazioni:
+ **Disattiva le opzioni **Multivalore** o Includi tutto.**
+ Usa il [formato variabile non elaborato](https://grafana.com/docs/grafana/latest/dashboards/variables/variable-syntax/#raw).

### Opzione Includi tutto
<a name="v9-dash-variable-add-multi-all"></a>

Grafana aggiunge un'`All`opzione all'elenco a discesa delle variabili. Se un utente seleziona questa opzione, vengono selezionate tutte le opzioni variabili.

### Personalizza tutti i valori
<a name="v9-dash-variable-add-multi-custom"></a>

Questa opzione è visibile solo se è selezionata l'**opzione Includi tutto**.

Immettete la sintassi regex, globs o lucene nel campo **Custom all value** per definire il valore dell'opzione. `All`

Per impostazione predefinita, il `All` valore include tutte le opzioni in un'espressione combinata. Questa operazione può diventare molto lunga e causare problemi di prestazioni. A volte può essere meglio specificare un valore all personalizzato, ad esempio un'espressione regolare con caratteri jolly.

Per avere una sintassi regex, globs o lucene personalizzata nell'opzione **Custom all value**, questa opzione non viene mai evitata, quindi dovrai pensare a quale sia un valore valido per la tua fonte di dati.

## Variabili globali
<a name="v9-dash-variable-add-global"></a>

Grafana ha variabili globali integrate che possono essere utilizzate nelle espressioni dell'editor di query. Questo argomento le elenca in ordine alfabetico e le definisce. Queste variabili sono utili nelle query, nei collegamenti alla dashboard, nei collegamenti ai pannelli e nei collegamenti dati.

**\$1\$1\$1dashboard**

Questa variabile è il nome della dashboard corrente.

**\$1\$1\$1from e \$1\$1\$1to**

Grafana ha due variabili di intervallo temporale integrate: `$__from` e. `$__to` Attualmente sono sempre interpolati come millisecondi di epoca per impostazione predefinita, ma puoi controllare la formattazione della data.


| Sintassi | Risultato dell’esempio | Description | 
| --- | --- | --- | 
|  `${__from}`  |  1594671549254  |  Epoca Unix in millisecondi  | 
|  `${__from:date}`  |  2020-07-13T 20:19:09.254 Z  |  Nessun args, il valore predefinito è ISO 8601/RFC 3339  | 
|  `${__from:date:iso}`  |  2020-07-13T 20:19:09.254 Z  |  ISO 8601/RFC 3339  | 
|  `${__from:date:seconds}`  |  1594671549  |  Epoca dei secondi di Unix  | 
|  `${__from:date:YYYY-MM}`  |  2020-07  |  Qualsiasi formato di data personalizzato che non includa il carattere:  | 

La sintassi precedente funziona anche con`${__to}`.

**\$1\$1\$1interval**

*È possibile utilizzare la `$__interval` variabile come parametro per raggruppare per ora (per InfluxDB, MySQL, Postgres, MSSQL), intervallo di istogramma di data (per Elasticsearch) o come parametro della funzione di riepilogo (per Graphite).*

Grafana calcola automaticamente un intervallo che può essere utilizzato per raggruppare per tempo nelle query. Quando ci sono più punti dati di quelli che possono essere visualizzati su un grafico, le interrogazioni possono essere rese più efficienti raggruppandole in base a un intervallo più ampio. Ad esempio, se stai guardando un grafico con dati relativi a 3 mesi, potresti non essere in grado di visualizzare i dettagli al minuto. Il raggruppamento per ora o giorno rende l'interrogazione più efficiente senza influire su ciò che mostra il grafico. `$__interval`Viene calcolato utilizzando l'intervallo di tempo e la larghezza del grafico (il numero di pixel).

Calcolo approssimativo: `(to - from) / resolution`

Ad esempio, quando l'intervallo di tempo è di 1 ora e il grafico è a schermo intero, l'intervallo potrebbe essere calcolato in`2m`: i punti sono raggruppati in intervalli di 2 minuti. Se l'intervallo di tempo è di 6 mesi e il grafico è a schermo intero, l'intervallo potrebbe essere `1d` (1 giorno). I punti vengono raggruppati per giorno.

Nell'origine dati InfluxDB, la variabile legacy `$interval` è la stessa variabile. `$__interval`dovrebbe essere usato invece.

Le fonti di dati InfluxDB ed Elasticsearch dispongono di `Group by time interval` campi che vengono utilizzati per codificare l'intervallo o per impostare il limite minimo per la `$__interval` variabile (utilizzando la sintassi ->). `>` `>10m`

**\$1\$1\$1interval\$1ms**

Questa variabile è la `$__interval` variabile in millisecondi, non una stringa formattata con intervallo di tempo. Ad esempio, se è allora è. `$__interval` `20m` `$__interval_ms` `1200000`

**\$1\$1\$1org**

Questa variabile è l'ID dell'organizzazione corrente. `${__org.name}`è il nome dell'organizzazione corrente.

**\$1\$1\$1user**

`${__user.id}`è l'ID dell'utente corrente. `${__user.login}`è l'handle di accesso dell'utente corrente. `${__user.email}`è l'e-mail dell'utente corrente.

**\$1\$1\$1range**

Attualmente è supportato solo per le fonti di dati Prometheus e Loki. Questa variabile rappresenta l'intervallo per la dashboard corrente. Viene calcolata da`to - from`. Ha una rappresentazione in millisecondi e una seconda denominata e. `$__range_ms` `$__range_s`

**\$1\$1\$1rate\$1interval**

Attualmente è supportato solo per le fonti di dati Prometheus. La `$__rate_interval` variabile è pensata per essere utilizzata nella funzione rate.

**\$1timeFilter o \$1\$1\$1timeFilter**

La `$timeFilter` variabile restituisce l'intervallo di tempo attualmente selezionato come espressione. Ad esempio, l'`Last 7 days`espressione dell'intervallo di tempo è`time > now() - 7d`.

Viene utilizzata in diversi luoghi, tra cui:
+ La clausola WHERE per l'origine dati InfluxDB. Grafana lo aggiunge automaticamente alle query InfluxDB in modalità Query Editor. Puoi aggiungerlo manualmente in modalità Editor di testo:. `WHERE $timeFilter`
+ Registra le query di Analytics nella fonte di dati di Azure Monitor.
+ Query SQL in MySQL, Postgres e MSSQL.
+ La `$__timeFilter` variabile viene utilizzata nell'origine dati MySQL.

## Variabili concatenate
<a name="v9-dash-variable-add-chained"></a>

*Le variabili concatenate*, chiamate anche *variabili collegate o variabili* *annidate*, sono variabili di query con una o più altre variabili nella relativa query variabile. Questa sezione spiega come funzionano le variabili concatenate e fornisce collegamenti a dashboard di esempio che utilizzano variabili concatenate.

Le query con variabili concatenate sono diverse per ogni fonte di dati, ma la premessa è la stessa per tutte. È possibile utilizzare le query con variabili concatenate in qualsiasi fonte di dati che le consenta.

Sono possibili dashboard con modelli collegati estremamente complessi, con 5 o 10 livelli di profondità. Tecnicamente, non ci sono limiti alla profondità o alla complessità che puoi raggiungere, ma più link hai, maggiore è il carico di query.

**Buone pratiche e suggerimenti**

Le seguenti pratiche semplificheranno l'utilizzo delle dashboard e delle variabili.

**Creazione di nuove variabili collegate**
+ Le variabili concatenate creano parent/child dipendenze. Puoi immaginarle come una scala o un albero.
+ Il modo più semplice per creare una nuova variabile concatenata è copiare la variabile su cui si desidera basare quella nuova. Nell'elenco delle variabili, fate clic sull'icona **Duplica variabile** a destra della voce della variabile per crearne una copia. È quindi possibile aggiungerlo alla query per la variabile principale.
+ Le nuove variabili create in questo modo vengono visualizzate in fondo all'elenco. Potrebbe essere necessario trascinarla in una posizione diversa nell'elenco per inserirla in un ordine logico.

**Ordine variabile**

Puoi modificare l'ordine delle variabili nell'elenco delle variabili del dashboard facendo clic sulle frecce su e giù sul lato destro di ogni voce. Grafana elenca i menu a discesa delle variabili da sinistra a destra in base a questo elenco, con la variabile in alto all'estrema sinistra.
+ Elenca le variabili che non hanno dipendenze in alto, prima delle variabili secondarie.
+ Ogni variabile deve seguire quella da cui dipende.
+ Ricorda che nell'interfaccia utente non è indicato quali variabili abbiano relazioni di dipendenza. Elenca le variabili in ordine logico per semplificare le cose agli altri utenti (e a te stesso).

**Considerazione della complessità**

Maggiore è il numero di livelli di dipendenza nelle variabili, maggiore sarà il tempo necessario per aggiornare le dashboard dopo aver modificato le variabili.

Ad esempio, se disponi di una serie di quattro variabili collegate (country, Region, server, metric) e modifichi il valore di una variabile radice (country), Grafana deve eseguire le query per tutte le variabili dipendenti prima di aggiornare le visualizzazioni nella dashboard.

## Gestisci le variabili
<a name="v9-dash-variable-add-manage"></a>

La pagina delle variabili consente di [aggiungere](https://grafana.com/docs/grafana/latest/dashboards/variables/add-template-variables/) variabili e gestire le variabili esistenti. Consente inoltre di [esaminare](https://grafana.com/docs/grafana/latest/dashboards/variables/inspect-variable/) le variabili e identificare se una variabile viene referenziata (o utilizzata) in altre variabili o dashboard.

**Sposta:** puoi spostare una variabile verso l'alto o verso il basso nell'elenco trascinandola.

**Clona:** per clonare una variabile, fai clic sull'icona del clone dal set di icone a destra. In questo modo viene creata una copia della variabile con il nome della variabile originale preceduto da. `copy_of_`

**Elimina:** per eliminare una variabile, fai clic sull'icona del cestino dal set di icone a destra.

## Filtra le variabili con regex
<a name="v9-dash-variable-add-filter"></a>

Utilizzando l'opzione Regex Query, si filtra l'elenco di opzioni restituite dalla variabile query o si modificano le opzioni restituite.

Questa pagina mostra come utilizzare regex per filter/modify i valori nel menu a discesa delle variabili.

Utilizzando l'opzione Regex Query, si filtra l'elenco di opzioni restituite dalla query Variable o si modificano le opzioni restituite. Per ulteriori informazioni, consulta la guida di Mozilla sulle espressioni [regolari](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions).

Gli esempi seguenti mostrano il filtraggio in base al seguente elenco di opzioni

```
backend_01
backend_02
backend_03
backend_04
```

**Filtra in modo che vengano restituite solo le opzioni che `02` terminano con `01` o**

Regex:

```
/
(
01|02 
) 
$/
```

Risultato:

```
backend_01
backend_02
```

**Filtra e modifica le opzioni utilizzando un gruppo di acquisizione regex per restituire parte del testo**

Regex:

```
/.* 
(
01|02 
)
/
```

Risultato:

```
01
02
```

**Filtrare e modificare - Esempio di Prometheus**

Elenco di opzioni:

```
up{instance="demo.robustperception.io:9090",job="prometheus"} 1 1521630638000
up{instance="demo.robustperception.io:9093",job="alertmanager"} 1 1521630638000
up{instance="demo.robustperception.io:9100",job="node"} 1 1521630638000
```

Regex:

```
/. *instance="
(
[^"]*
)
.*/
```

Risultato:

```
demo.robustperception.io:9090
demo.robustperception.io:9093
demo.robustperception.io:9100
```

**Filtra e modifica utilizzando gruppi di acquisizione di testo e valori denominati**

Utilizzando gruppi di acquisizione denominati, è possibile acquisire parti separate di «testo» e «valore» dalle opzioni restituite dalla query variabile. Ciò consente all'elenco a discesa delle variabili di contenere un nome descrittivo per ogni valore che può essere selezionato.

Ad esempio, quando si esegue una query sulla metrica `node_hwmon_chip_names` Prometheus, è molto più intuitiva `chip_name` del valore. `chip` Quindi il seguente risultato della query variabile:

```
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_0",chip_name="enp216s0f0np0"} 1
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_1",chip_name="enp216s0f0np1"} 1
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_2",chip_name="enp216s0f0np2"} 1
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_3",chip_name="enp216s0f0np3"} 1
```

Passato attraverso la seguente Regex:

```
/chip_name="(?<text>[ ^ " ] + ) |chip=" (?<value >[ ^ " ] + )/g
```

Produrrebbe il seguente elenco a discesa:

```
Display Name          Value
------------          -------------------------
enp216s0f0np0         0000:d7:00_0_0000:d8:00_0
enp216s0f0np1         0000:d7:00_0_0000:d8:00_1
enp216s0f0np2         0000:d7:00_0_0000:d8:00_2
enp216s0f0np3         0000:d7:00_0_0000:d8:00_3
```

Sono supportati solo `text` i nomi dei gruppi di `value` acquisizione.

## 
<a name="v9-dash-variable-add-inspect"></a>

La pagina delle variabili consente di identificare facilmente se una variabile viene referenziata (o utilizzata) in altre variabili o nella dashboard.

Ogni variabile referenziata o utilizzata presenta un segno di spunta verde accanto ad essa, mentre le variabili non referenziate hanno un'icona di avvertenza arancione accanto ad esse. Inoltre, tutte le variabili referenziate hanno un'icona di dipendenza accanto al segno di spunta verde. È possibile selezionare l'icona per visualizzare la mappa delle dipendenze. La mappa delle dipendenze può essere spostata. È possibile ingrandire o ridurre con la rotellina del mouse o uno strumento equivalente.

# Sintassi variabile
<a name="v9-dash-variable-syntax"></a>

****  
**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)

I titoli dei pannelli e le query metriche possono fare riferimento a variabili utilizzando due sintassi diverse.
+ `$varname`— Questa sintassi è facile da leggere, ma non consente di utilizzare una variabile al centro di una parola.

  **Esempio**: `apps.frontend.$server.requests.count`
+ `${var_name}`— Utilizzate questa sintassi quando desiderate utilizzare una variabile al centro di un'espressione.
+ `${var_name:<format>}`— Questo formato offre un maggiore controllo su come Grafana interpreta i valori. Per ulteriori informazioni, consulta Opzioni *avanzate di formato variabile*.
+ `[[varname]]`— Non utilizzare. Questa sintassi è vecchia ed è obsoleta. Verrà rimosso in una versione futura.

Prima che le query vengano inviate alla fonte dati, la query viene *interpolata*, il che significa che la variabile viene sostituita con il valore corrente. Durante l'interpolazione, è possibile che il valore della variabile venga *ignorato per* conformarsi alla sintassi del linguaggio di interrogazione e del luogo in cui viene utilizzato. Ad esempio, una variabile utilizzata in un'espressione regex in una query InfluxDB o Prometheus verrà escapitata con regex.

**Opzioni avanzate di formato variabile**

La formattazione dell'interpolazione delle variabili dipende dall'origine dei dati, ma ci sono alcune situazioni in cui potresti voler modificare la formattazione predefinita.

Ad esempio, l'impostazione predefinita per l'origine dati MySQL consiste nell'unire più valori separati da virgole da virgole:. `'server01','server02'` In alcuni casi, potresti voler avere una stringa separata da virgole senza virgolette:. `server01,server02` Puoi farlo accadere con le opzioni avanzate di formattazione delle variabili elencate di seguito.

**Sintassi generale**

Sintassi: `${var_name:option}`

Se viene specificata un'opzione di formattazione non valida, allora `glob` è l'opzione. default/fallback 

**CSV**

Formatta le variabili con più valori come una stringa separata da virgole.

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:csv}'
Interpolation result:  'test1,test2'
```

**Distribuito - OpenTSDB**

Formatta le variabili con più valori in formato personalizzato per OpenTSDB.

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:distributed}'
Interpolation result:  'test1,servers=test2'
```

**Virgolette doppie**

Formatta le variabili a valore singolo e multivalore in una stringa separata da virgole, scade `"` in ogni valore per e cita ogni valore con. `\"` `"`

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:doublequote}'
Interpolation result:  '"test1","test2"'
```

**Glob - Grafite**

Formatta le variabili con più valori in un glob (per le query Graphite).

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:glob}'
Interpolation result:  '{test1,test2}'
```

**JSON**

Formatta le variabili con più valori come una stringa separata da virgole.

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:json}'
Interpolation result:  '["test1", "test2"]'
```

**Lucene - Elasticsearch**

Formatta le variabili con più valori in formato Lucene per Elasticsearch.

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:lucene}'
Interpolation result:  '("test1" OR "test2")'
```

**Codice percentuale**

Formatta variabili singole e multivalore da utilizzare nei parametri URL.

```
servers = [ 'foo()bar BAZ',  'test2' ]
String to interpolate:  '${servers:percentencode}'
Interpolation result:  'foo%28%29bar%20BAZ%2Ctest2'
```

**Tubo**

Formatta le variabili con più valori in una stringa separata da pipe.

```
servers = [ 'test1.',  'test2' ]
String to interpolate:  '${servers:pipe}'
Interpolation result:  'test1.|test2'
```

**Raw**

Disattiva la formattazione specifica dell'origine dati, ad esempio le virgolette singole in una query SQL.

```
servers = [ 'test.1',  'test2' ]
String to interpolate:  '${var_name:raw}'
Interpolation result:  'test.1,test2'
```

**Espressione regolare**

Formatta le variabili con più valori in una stringa regex.

```
servers = [ 'test1.',  'test2' ]
String to interpolate:  '${servers:regex}'
Interpolation result:  '(test1\.|test2)'
```

**Citazione singola**

Formatta le variabili a valore singolo e multivalore in una stringa separata da virgole, scade `'` in ogni valore per e cita ogni valore con. `\'` `'`

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:singlequote}'
Interpolation result:  "'test1','test2'"
```

**Sqlstring**

Formatta le variabili a valore singolo e multivalore in una stringa separata da virgole, scade `'` in ogni valore per e cita ogni valore con. `''` `'`

```
servers = [ "test'1",  "test2" ]
String to interpolate:  '${servers:sqlstring}'
Interpolation result:  "'test''1','test2'"
```

**Text (Testo)**

Formatta le variabili a valore singolo e multivalore nella loro rappresentazione testuale. Per una singola variabile, restituirà solo la rappresentazione del testo. Per le variabili multivalore, restituirà la rappresentazione del testo combinata con. `+`

```
servers = [ "test1",  "test2" ]
String to interpolate:  '${servers:text}'
Interpolation result:  "test1 + test2"
```

**Parametri di query**

Formatta le variabili a valore singolo e multivalore nella loro rappresentazione dei parametri di interrogazione. Ad esempio: `var-foo=value1&var-foo=value2`

```
servers = [ "test1",  "test2" ]
String to interpolate:  '${servers:queryparam}'
Interpolation result:  "var-servers=test1&var-servers=test2"
```

# Valutazione dell'utilizzo del pannello di controllo
<a name="v9-dash-assess-dashboard-usage"></a>

****  
**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 informazioni sull'utilizzo consentono di comprendere meglio come viene utilizzata l'istanza Grafana.

La funzione di analisi sull'utilizzo raccoglie una serie di dati aggregati e li archivia nel database.
+ Visualizzazioni del pannello di controllo (aggregate e per utente)
+ Errori nell'origine dei dati
+ Interrogazioni sulle fonti di dati

I dati aggregati consentono di accedere a diverse funzionalità, tra cui approfondimenti sulla dashboard e sulle fonti di dati, l'indicatore di presenza, l'ordinamento dei dashboard utilizzando i dati di analisi e la visualizzazione dei dati di analisi sull'utilizzo in una dashboard.

Questa funzione genera anche registri dettagliati che possono essere esportati in Loki.

## Dashboard e approfondimenti sulle fonti di dati
<a name="v9-dash-insights"></a>

Per ogni dashboard e fonte di dati, puoi accedere alle informazioni sull'utilizzo.

**Informazioni dettagliate sulla dashboard**

Per visualizzare le informazioni sull'utilizzo della dashboard, fai clic su **Dashboard insights** nella barra in alto.

Dashboard Insights mostra le seguenti informazioni.
+ **Statistiche**: il numero di domande ed errori giornalieri negli ultimi 30 giorni.
+ **Utenti e attività**: il conteggio delle visualizzazioni giornaliere degli ultimi 30 giorni, delle ultime attività sulla dashboard e degli utenti recenti (con un limite di 20).

**Informazioni sulle fonti di dati**

Gli approfondimenti sulle fonti di dati forniscono informazioni su come è stata utilizzata un'origine dati negli ultimi 30 giorni, ad esempio:
+ Interrogazioni al giorno
+ Errori al giorno
+ Tempo di caricamento giornaliero delle query (media in ms)

Per trovare informazioni approfondite sulle fonti di dati:

1. Vai alla visualizzazione dell'elenco delle **fonti di dati**.

1. Fai clic su **Origine dati**.

1. Fai clic sulla scheda **Insights**.

## Indicatore di presenza
<a name="v9-dash-presence-indicator"></a>

Quando accedi e guardi una dashboard, puoi sapere chi sta guardando la tua stessa dashboard tramite un indicatore di presenza, che mostra gli avatar degli utenti che hanno interagito di recente con la dashboard. L'intervallo di tempo predefinito è di 10 minuti. Per vedere il nome dell'utente, passa il mouse sull'avatar dell'utente. Gli avatar provengono da [Gravatar](https://gravatar.com/) in base all'e-mail dell'utente.

**Quando ci sono più utenti attivi su una dashboard di quanti ne possano rientrare nell'indicatore di presenza, fai clic sull'icona \$1X.** In questo modo si apriranno le informazioni sulla dashboard, che contengono maggiori dettagli sulle attività recenti degli utenti.

## Ordinamento delle dashboard utilizzando i dati di approfondimento
<a name="v9-dash-sort-dashboards"></a>

Nella visualizzazione di ricerca, puoi utilizzare i dati di Insights per aiutarti a trovare le dashboard più utilizzate, non funzionanti e inutilizzate.
+ Errori totali
+ Errori 30 giorni
+ Visualizzazioni totali
+ Visualizzazioni 30 giorni

# Ricerca nelle dashboard in Grafana versione 9
<a name="v9-search"></a>

****  
**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)

Puoi cercare le dashboard in base al nome della dashboard e al titolo del pannello. Quando cerchi dashboard, il sistema restituisce tutti i dashboard disponibili all'interno dell'istanza Grafana, anche se non disponi dell'autorizzazione per visualizzare il contenuto del pannello di controllo.

## Cerca nelle dashboard utilizzando il nome della dashboard
<a name="v9-search-by-name"></a>

Inserisci qualsiasi parte del nome della dashboard nella barra di ricerca. La ricerca restituisce i risultati per qualsiasi corrispondenza parziale di stringhe in tempo reale, durante la digitazione.

La ricerca nella dashboard è:
+ Real-time
+ *Nessuna* distinzione tra maiuscole
+ Funzionale su dashboard archiviate e basate su file.

**Suggerimento**  
Puoi usare i tasti freccia della tastiera per navigare tra i risultati e premere `Enter` per aprire la dashboard selezionata.

## Cerca nelle dashboard utilizzando il titolo del pannello
<a name="v9-search-by-title"></a>

Puoi cercare una dashboard in base al titolo di un pannello che appare in una dashboard. Se il titolo di un pannello corrisponde alla query di ricerca, la dashboard viene visualizzata nei risultati di ricerca.

## Filtra i risultati di ricerca della dashboard per tag
<a name="v9-search-by-tag"></a>

I tag sono un ottimo modo per organizzare le dashboard, soprattutto con l'aumentare del numero di dashboard. **Puoi aggiungere e gestire i tag nelle Impostazioni della dashboard.**

Quando si selezionano più tag, Grafana mostra dashboard che includono tutti i tag selezionati.

Per filtrare i risultati di ricerca della dashboard in base a un tag, completa uno dei seguenti passaggi:
+ Per filtrare i risultati di ricerca della dashboard per tag, scegli un tag che appare nella colonna destra dei risultati della ricerca.

  Puoi continuare a filtrare scegliendo tag aggiuntivi.
+ Per visualizzare un elenco di tutti i tag disponibili, fai clic sul menu a discesa **Filtra per tag** e seleziona un tag.

  Verranno visualizzati tutti i tag e, quando selezioni un tag, la ricerca nella dashboard verrà immediatamente filtrata.

**Suggerimento**  
Se usi solo una tastiera, premi il `tab` tasto e vai al menu a discesa **Filtra per tag**, premi il tasto freccia giù per attivare il menu e individuare un tag e premi `Enter` per selezionare il tag.