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à.
# Creazione di dashboard
****
**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
****
**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
****
**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
****
**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
****
**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
****
**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
****
**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 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 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
****
**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
****
**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"
}
]
}
```