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 10.x di Grafana.** Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.md) Per le aree di lavoro Grafana che supportano la versione 8.x di Grafana, vedere. [Funzionamento in Grafana versione 8](using-grafana-v8.md) 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. Una dashboard è composta da [pannelli](v10-panels-viz.md) con visualizzazioni. A ogni pannello è associata una query per estrarre i dati da uno dei tuoi. [Connessione alle origini dati](AMG-data-sources.md) Puoi creare dashboard più interattivi e dinamici aggiungendo e utilizzando [variabili](v10-dash-variables.md). Invece di codificare il server, l'applicazione o altri nomi nelle query metriche, puoi utilizzare variabili al loro posto. **Topics** + [Creazione di dashboard](v10-dash-creating.md) + [Importazione di dashboard](v10-dash-importing.md) + [Esportazione di pannelli di controllo](v10-dash-exporting.md) + [Modifica delle impostazioni del pannello di controllo](v10-dash-modify-settings.md) + [Variabili URL del pannello di controllo](v10-dash-dashboard-url-variables.md) + [Gestione dei pannelli della libreria](v10-dash-manage-library-panels.md) + [Gestione della cronologia delle versioni del dashboard](v10-dash-manage-version-history.md) + [Gestione dei collegamenti alla dashboard](v10-dash-manage-dashboard-links.md) + [Annota le visualizzazioni](v10-dash-annotations.md) + [Modello JSON del pannello di controllo](v10-dash-dashboard-json-model.md) + [Procedure consigliate per i dashboard](v10-dash-bestpractices.md) # Creazione di dashboard **** **Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.** Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.md) Per le aree di lavoro Grafana che supportano la versione 8.x di Grafana, vedere. [Funzionamento in Grafana versione 8](using-grafana-v8.md) **Creazione di un pannello di controllo** 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 ulteriori informazioni, consulta [Connessione alle origini dati](AMG-data-sources.md). Per creare una dashboard: 1. Accedi a Grafana e seleziona **Dashboards** dal menu a sinistra. 1. Seleziona **Nuovo, quindi **Nuovo**** pannello di controllo. 1. Nella dashboard vuota, seleziona **\$1 Aggiungi visualizzazione**. Si apre la nuova finestra di dialogo di visualizzazione. 1. Seleziona una fonte di dati. Puoi scegliere una fonte di dati esistente, una delle fonti di dati integrate di Grafana per i test, oppure scegliere **Configura una nuova origine dati** per configurarne una nuova (solo gli utenti con autorizzazioni di amministratore possono configurare nuove fonti di dati). Si apre la visualizzazione **del pannello Modifica**, con l'origine dati selezionata. È possibile modificare la fonte di dati per il pannello in un secondo momento, utilizzando la scheda **Query** dell'editor del pannello, se necessario. 1. Scrivi o costruisci una query nel linguaggio di interrogazione della tua fonte di dati. Scegli l'icona Aggiorna dashboard per eseguire una query sull'origine dati, visualizzando i risultati man mano che procedi. 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](v10-panels-viz.md). 1. In **Opzioni del pannello**, puoi inserire un titolo e una descrizione per il pannello. 1. La maggior parte delle visualizzazioni necessita di alcune modifiche prima di visualizzare le informazioni esatte di cui hai bisogno. È possibile regolare le impostazioni del pannello nei seguenti modi. + [Configura le mappature dei valori](v10-panels-configure-value-mappings.md) + [Opzioni specifiche per la visualizzazione](v10-panels-viz.md) + [Sostituisci i valori dei campi](v10-panels-configure-overrides.md) + [Configura le soglie](v10-panels-configure-thresholds.md) + [Configura le opzioni standard](v10-panels-configure-standard-options.md) 1. Quando hai finito di configurare il pannello, scegli **Salva** per salvare la dashboard. In alternativa, seleziona **Applica** per visualizzare le modifiche senza uscire dall'editor del pannello. 1. Aggiungi una nota per descrivere la visualizzazione (o descrivere le modifiche), quindi fai clic su **Salva** nell'angolo in alto a destra della pagina. **Nota** Le note sono utili se devi ripristinare la dashboard a una versione precedente. 1. Scegli **Save** (Salva). 1. Facoltativamente, puoi aggiungere altri pannelli alla dashboard scegliendo **Aggiungi** nell'intestazione della dashboard e selezionando **Visualization** dal menu a discesa. **Copiare una dashboard esistente** Puoi copiare rapidamente una dashboard esistente per iniziare subito a crearne una nuova. **Per copiare una dashboard esistente** 1. Seleziona **Dashboard** dal menu a sinistra. 1. Scegli la dashboard che desideri copiare per aprirla. 1. Seleziona **Impostazioni** (icona a forma di ingranaggio) in alto a destra della dashboard. 1. Seleziona **Salva** con nome nell'angolo in alto a destra della dashboard. 1. (Facoltativo) Specificate il nome, la cartella, la descrizione e se copiare o meno i tag originali della dashboard per la dashboard copiata. 1. Seleziona **Salva**. **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. **Per configurare le righe ripetute** 1. Seleziona **Dashboard** dal menu a sinistra, quindi scegli la dashboard che desideri modificare. 1. Nella parte superiore della dashboard, seleziona **Aggiungi**, quindi seleziona **Riga** dal menu a discesa. Se la dashboard è vuota, puoi selezionare alternativamente il pulsante **\$1 Aggiungi riga** al centro della dashboard. 1. Passa il mouse sul titolo della riga e seleziona l'icona **Impostazioni** (ingranaggio) che appare. 1. Nella finestra di dialogo **Opzioni di 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. 1. Selezionare **Update (Aggiorna)**. **Righe ripetute e fonte di dati speciale del pannello di controllo** Se una riga include pannelli che utilizzano la speciale origine dati [Dashboard](AMG-data-sources.md#AMG-data-sources-special), l'origine dati che utilizza un set di risultati di un altro pannello nella stessa dashboard, i pannelli corrispondenti nelle righe ripetute faranno riferimento al pannello nella riga originale, non a quelli nelle righe ripetute. Ad esempio, in una dashboard: + `Row 1`include `Panel 1A` e`Panel 1B`. + `Panel 1B`utilizza i risultati di `Panel 1A` utilizzando la fonte di `Dashboard` dati. + La ripetizione `Row 2` include `Panel 2A` e. `Panel 2B` + `Panel 2B`riferimenti`Panel 1A`, no`Panel 2A`. **Per spostare un pannello** 1. Apri il pannello di controllo . 1. Selezionate il 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, trascinate l'angolo inferiore destro del pannello. Puoi ridimensionare un pannello della dashboard in base alle tue esigenze. # Importazione di dashboard **** **Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.** Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.md) Per le aree di lavoro Grafana che supportano la versione 8.x di Grafana, vedere. [Funzionamento in Grafana versione 8](using-grafana-v8.md) Puoi importare dashboard preconfigurate nel tuo spazio di lavoro Amazon Managed Grafana. **Per importare un pannello di controllo** 1. Accedi al tuo spazio di lavoro Amazon Managed Grafana. 1. Seleziona **Dashboard** dal menu a sinistra. 1. Seleziona **Nuovo** e scegli **Importa** nel menu a discesa. 1. Successivamente devi scegliere la definizione JSON della dashboard da importare. Hai tre scelte su come importare JSON: + Carica un file contenente il pannello di controllo JSON. + Copia direttamente il testo JSON nell'area di testo. + Incolla l'URL o l'ID di un pannello di controllo Grafana Labs nel campo. Per ulteriori informazioni sulla dashboard di grafana.com URLs, consulta la sezione successiva. + (Facoltativo) Modifica i dettagli del pannello di controllo che desideri modificare. + Seleziona una fonte di dati, se necessario. + Scegli **Importa**. + Salva la dashboard. ## Ricerca di dashboard su grafana.com La pagina [Dashboards](https://grafana.com/grafana/dashboards/) su grafana.com fornisce dashboard per le applicazioni server più comuni. Sfoglia una libreria di dashboard ufficiali e create dalla community e importale per iniziare rapidamente a funzionare. **Nota** Per importare dashboard da grafana.com, il tuo spazio di lavoro Amazon Managed Grafana deve avere accesso a Internet. # Esportazione di pannelli di controllo **** **Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.** Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.md) Per le aree di lavoro Grafana che supportano la versione 8.x di Grafana, vedere. [Funzionamento in Grafana versione 8](using-grafana-v8.md) Puoi utilizzare l'interfaccia utente Grafana o l'API HTTP per esportare i dashboard. 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. **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. **Per esportare una dashboard** 1. Apri il pannello di controllo che desideri esportare. 1. Seleziona l'icona di condivisione. 1. Scegli **Export** (Esporta). 1. Scegli **Salva su file.** **Nota** Grafana scarica un file JSON sul computer locale. # Modifica delle impostazioni del pannello di controllo **** **Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.** Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.md) Per le aree di lavoro Grafana che supportano la versione 8.x di Grafana, vedere. [Funzionamento in Grafana versione 8](using-grafana-v8.md) La 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. + **Fuso orario**: specifica il fuso orario locale del servizio o del sistema che stai monitorando. Questo può essere utile quando si monitora un sistema o un servizio che opera in diversi fusi orari. + **Predefinito**: 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. + **Ora locale del browser**: viene utilizzato il fuso orario configurato per il browser dell'utente di visualizzazione. 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. + **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 ritardo**: sostituisci l'`now`ora inserendo un ritardo. Utilizzate questa opzione per gestire i ritardi noti nell'aggregazione dei dati ed evitare valori nulli. + **Nascondi selettore orario**: seleziona questa opzione se non desideri che il pannello di controllo visualizzi il selettore orario. **Nota** Per avere il controllo dell'ora, i dati devono includere una colonna temporale. Consulta la documentazione relativa alla 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. In alternativa, per i plug-in di origine dati che installi da[Trova i plugin con il catalogo dei plugin](grafana-plugins.md#plugin-catalog), puoi utilizzare la [documentazione sul sito Web di Grafana](https://grafana.com/docs/grafana/v10.3/datasources/) Labs. **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.](v10-dash-variables.md) **Per aggiungere una variabile** 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**, aggiungi il nome della variabile. Questo è il nome che utilizzerai 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. **Per aggiungere un link** 1. Nella pagina **delle impostazioni della dashboard**, scegli **Collegamenti** dal menu della sezione a sinistra e poi il pulsante **Aggiungi link**. 1. Inserisci un 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** L'utilizzo dei tag crea un menu a discesa dinamico di dashboard, tutte dotate di un tag specifico. 1. Per aggiungere un link web, 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 di una 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. I metadati JSON definiscono la dashboard. **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.](v10-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 10.x di Grafana.** Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.md) Per le aree di lavoro Grafana che supportano la versione 8.x di Grafana, vedere. [Funzionamento in Grafana versione 8](using-grafana-v8.md) Grafana può applicare valori variabili passati come parametri di query nella dashboard. URLs Per ulteriori informazioni, consulta [Gestire i collegamenti alla dashboard e i](v10-dash-manage-dashboard-links.md) [modelli e le variabili](v10-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 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](v10-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.](v10-dash-variable-add.md#v10-dash-variable-add-adhoc) 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, sostituisci 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. # Gestione dei pannelli della libreria **** **Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.** Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.md) Per le aree di lavoro Grafana che supportano la versione 8.x di Grafana, vedere. [Funzionamento in Grafana versione 8](using-grafana-v8.md) 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. **Per creare un pannello della libreria** 1. Apri il pannello che desideri convertire in un pannello della libreria in modalità di modifica. 1. Nelle opzioni di visualizzazione del pannello, fate clic sull'opzione freccia rivolta verso il basso per avviare le modifiche alla visualizzazione. 1. Seleziona **i pannelli Libreria**, quindi **\$1 Crea pannello Libreria**. Si apre la finestra di dialogo di creazione. 1. Nel **nome del pannello Libreria**, inserite il nome desiderato per il pannello. 1. In **Salva nella cartella**, selezionate la cartella in cui salvare il pannello della libreria. 1. Selezionate il **pannello Crea libreria** per salvare le modifiche apportate alla libreria. 1. Salva la dashboard. 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. **Puoi anche creare un pannello della libreria direttamente dal menu di modifica di qualsiasi pannello, selezionando Altro...** quindi **Crea pannello libreria**. **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. **Per aggiungere un pannello della libreria a una dashboard** 1. Seleziona **Dashboard** nel menu a sinistra. 1. Seleziona **Nuovo**, quindi scegli **Nuova dashboard** dal menu a discesa. 1. Nella dashboard vuota, seleziona **\$1 Importa il pannello della libreria**. Vedrai un elenco dei pannelli della tua 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. **Per scollegare un pannello della libreria** 1. Seleziona **Dashboard** nel menu a sinistra. 1. Seleziona i **pannelli Libreria**. 1. Seleziona un pannello della libreria che viene utilizzato in diversi dashboard. 1. Seleziona il pannello che desideri scollegare. 1. Seleziona il titolo del pannello (o posiziona il puntatore del mouse in un punto qualsiasi del pannello) per visualizzare il menu delle azioni nell'angolo superiore destro del pannello. 1. Seleziona **Edit (Modifica)**. Il pannello si aprirà in modalità di modifica. 1. Seleziona **Scollega** nell'angolo in alto a destra della pagina. 1. Scegli **Sì, scollega**. **Visualizzazione di un elenco di pannelli della libreria** È possibile visualizzare un elenco dei pannelli della libreria disponibili e cercare un pannello della libreria. **Per visualizzare un elenco dei pannelli della libreria** 1. Seleziona **Dashboard** nel menu a sinistra. 1. Seleziona i **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ù. **Per eliminare un pannello della libreria** 1. Seleziona **Dashboard** nel menu a sinistra. 1. Seleziona i **pannelli Libreria**. 1. Selezionate l'icona di eliminazione accanto al nome del pannello della libreria per il pannello che desiderate eliminare. # Gestione della cronologia delle versioni del dashboard **** **Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.** Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.md) Per le aree di lavoro Grafana che supportano la versione 8.x di Grafana, vedere. [Funzionamento in Grafana versione 8](using-grafana-v8.md) Ogni volta che salvi una versione della dashboard, viene salvata una copia di quella versione in modo da non perdere le versioni precedenti della dashboard. Un elenco di queste versioni è disponibile accedendo alle impostazioni della dashboard e selezionando **Versioni** nel menu a sinistra. **Nota** Vengono salvate le 20 versioni più recenti di una dashboard. 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. Viene visualizzata la visualizzazione delle differenze tra le versioni. 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 facendo clic sul pulsante **Visualizza JSON Diff** in basso. **Ripristino a una versione della dashboard salvata in precedenza** Se devi ripristinare una versione della dashboard salvata in precedenza, puoi selezionare il pulsante **Ripristina** a destra di una riga nell'elenco delle versioni della dashboard oppure selezionare il** pulsante **Ripristina alla versione** nella vista delle differenze. Selezionando una di queste opzioni ti verrà richiesto 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. Ciò garantisce che le versioni precedenti della dashboard non siano influenzate dalla modifica. # Gestione dei collegamenti alla dashboard **** **Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.** Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.md) Per le aree di lavoro Grafana che supportano la versione 8.x di Grafana, vedere. [Funzionamento in Grafana versione 8](using-grafana-v8.md) 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 un 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. 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. **Per aggiungere un link a una dashboard** 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. Seleziona **Collegamenti**, quindi **Aggiungi link alla dashboard** o **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 ti colleghi a molte dashboard, per impostazione predefinita, Grafana le visualizza side-by-side tutte nella parte superiore della dashboard. Selezionando questa opzione e aggiungendo un titolo opzionale, i link verranno visualizzati in un menu a discesa. + **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 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](v10-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. **Per aggiungere un collegamento URL a una dashboard** 1. Durante la visualizzazione della dashboard che desideri collegare, seleziona l'ingranaggio nella parte superiore dello schermo per aprire **le impostazioni della dashboard**. 1. Seleziona **Collegamenti**, quindi **Aggiungi link alla dashboard** o **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. + **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` — Definire 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 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. Selezionare **Aggiungi**. **Aggiornamento di un link alla dashboard** Per modificare o aggiornare un link esistente alla dashboard, segui questa procedura. **Per aggiornare un link alla dashboard** 1. Nelle **impostazioni della dashboard,** nella scheda **Collegamenti**, seleziona il link esistente che desideri modificare. 1. Modifica le impostazioni, quindi scegli **Aggiorna**. **Duplicazione di un link alla dashboard** Per duplicare un link esistente alla dashboard, seleziona l'icona di duplicazione accanto al link esistente che desideri duplicare. **Eliminazione di un link alla dashboard** Per eliminare un link esistente alla dashboard, seleziona l'icona del cestino accanto al link 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 vedere i link disponibili ai pannelli, seleziona l'icona a destra del titolo del 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. Posiziona il cursore sul pannello a cui desideri aggiungere un link. 1. Seleziona il menu e scegli **Modifica** oppure puoi usare la scorciatoia da tastiera. `e` 1. Espandi la sezione **delle opzioni del pannello** e scorri verso il basso fino a **Collegamenti del pannello**. 1. Seleziona **Aggiungi link**. 1. Inserisci un **titolo**. Questa è un'etichetta leggibile dall'uomo per il collegamento che verrà visualizzato nell'interfaccia utente. 1. Inserisci l'**URL** a cui desideri collegarti. Premi `Ctrl+Space` (o`Cmd+Space`) e seleziona il 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. Seleziona un pannello (o posiziona il cursore sul pannello) per visualizzare un menu delle azioni in alto a destra del pannello. 1. Dal menu, seleziona **Modifica**. Puoi anche usare la scorciatoia da tastiera,`e`. 1. Espandi la sezione **delle opzioni del pannello** e scorri verso il basso fino a **Collegamenti del pannello**. 1. Trova il link che desideri modificare e seleziona l'icona **Modifica** (matita) accanto ad esso. 1. Apporta le modifiche necessarie: 1. Seleziona **Salva** per salvare le modifiche e chiudere la finestra. 1. Salva le modifiche alla dashboard selezionando **Salva** in alto a destra. + **Eliminazione di un collegamento al pannello** 1. Seleziona un pannello (o posiziona il cursore sul pannello) per visualizzare un menu delle azioni in alto a destra del pannello. 1. Dal menu, seleziona **Modifica**. Puoi anche usare la scorciatoia da tastiera,`e`. 1. Espandi la sezione **delle opzioni del pannello** e scorri verso il basso fino a **Collegamenti del pannello**. 1. Trova il link che desideri eliminare e seleziona l'icona **X** accanto ad esso. 1. Seleziona **Salva** in alto a destra per salvare le modifiche alla dashboard. # Annota le visualizzazioni **** **Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.** Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.md) Per le aree di lavoro Grafana che supportano la versione 8.x di Grafana, vedere. [Funzionamento in Grafana versione 8](using-grafana-v8.md) Le annotazioni consentono di contrassegnare punti su una visualizzazione con eventi complessi. Vengono visualizzate come linee verticali e icone su tutti i pannelli grafici. Quando passi il mouse su un'annotazione, puoi ottenere la descrizione e i tag dell'evento. Il campo di testo può includere collegamenti ad altri sistemi con maggiori dettagli. È possibile annotare le visualizzazioni in tre modi: + Direttamente nel pannello, utilizzando la query di annotazioni [integrata](#v10-dash-built-in-query). + Utilizzando l'API HTTP Grafana. + Configurazione delle interrogazioni di annotazione nelle impostazioni della dashboard. Nei primi due casi, stai creando nuove annotazioni, mentre nell'ultimo stai interrogando le annotazioni esistenti provenienti da fonti di dati. Anche la query di annotazione integrata supporta questa funzionalità. Questa sezione spiega la prima e la terza opzione; per informazioni sull'utilizzo dell'API HTTP Grafana, fare riferimento a. [API per le annotazioni](Grafana-API-Annotations.md) Le annotazioni sono supportate per i seguenti tipi di visualizzazione: + Serie temporali + Cronologia dello stato + Candelabro ## Crea annotazioni nei pannelli Grafana offre la possibilità di aggiungere eventi di annotazione direttamente da un pannello utilizzando la [query di annotazioni integrata](#v10-dash-built-in-query) presente in tutte le dashboard. Le annotazioni create in questo modo vengono archiviate in Grafana. Per aggiungere annotazioni direttamente nel pannello: + La dashboard deve essere già stata salvata. + La query integrata deve essere abilitata. **Per aggiungere un'annotazione** 1. Nella dashboard, seleziona il pannello a cui stai aggiungendo l'annotazione. Apparirà un menu contestuale. 1. Nel menu contestuale, seleziona **Aggiungi annotazione.** 1. (Facoltativo) Aggiungi una descrizione e dei tag dell'annotazione. 1. Seleziona **Salva**. In alternativa, per aggiungere un'annotazione, premi `Ctrl` (o`Cmd`) mentre selezioni il pannello e verrà visualizzato il **popover Aggiungi annotazione**. **Annotazioni regionali** Puoi anche creare annotazioni che coprono un'area o un periodo di tempo in una visualizzazione. **Per aggiungere un'annotazione regionale** 1. Nella dashboard, premete `Ctrl` (o`Cmd`) mentre selezionate un'area del pannello. 1. Aggiungi una descrizione dell'annotazione e dei tag (opzionale). 1. Fai clic su **Salva**. **Per modificare un'annotazione** 1. Nella dashboard, posiziona il mouse su un indicatore di annotazione su un pannello. 1. Seleziona l'icona **Modifica** (matita) nel tooltip di annotazione. 1. Modifica i tag descrittivi and/or . 1. Seleziona **Salva**. **Per eliminare un'annotazione** 1. Nella dashboard, posiziona il mouse su un indicatore di annotazione su un pannello. 1. Seleziona l'icona **Elimina** (cestino) nel tooltip di annotazione. ## Recupera le annotazioni tramite le impostazioni della dashboard Nelle impostazioni della dashboard, in **Annotazioni**, puoi aggiungere nuove query per recuperare le annotazioni utilizzando qualsiasi fonte di dati, inclusa la fonte di dati di annotazione dati integrata. Le query di annotazione restituiscono eventi che possono essere visualizzati come marcatori di eventi nei grafici della dashboard. **Per aggiungere una nuova interrogazione di annotazione** 1. Seleziona l'icona **Impostazioni** (ingranaggio) nell'intestazione della dashboard per aprire il menu delle impostazioni. 1. Seleziona **Annotazioni**. 1. Fai clic su **Aggiungi interrogazione di annotazione.** 1. Immettete un nome per la query di annotazione. Questo nome viene assegnato all'interruttore (casella di controllo) che consente di abilitare la visualizzazione degli eventi di annotazione derivanti da questa query. 1. Seleziona la fonte di dati per le annotazioni. Puoi anche scegliere **Open advanced data source picker** per visualizzare altre opzioni, inclusa l'aggiunta di una nuova origine dati (disponibile solo per gli amministratori). 1. **Se non desideri utilizzare subito la query di annotazione, deseleziona la casella di controllo Abilitato.** 1. **Se non desideri che l'interruttore della query di annotazione venga visualizzato nella dashboard, seleziona la casella di controllo Nascosto.** 1. Seleziona un colore per i marker degli eventi. 1. Nel menu **a discesa Mostra in**, scegli una delle seguenti opzioni: + **Tutti i pannelli**: le annotazioni vengono visualizzate su tutti i pannelli che supportano le annotazioni. + **Pannelli selezionati**: le annotazioni vengono visualizzate su tutti i pannelli selezionati. + **Tutti i pannelli tranne**: le annotazioni vengono visualizzate su tutti i pannelli tranne quelli selezionati. 1. Configura l'interrogazione. Le opzioni di interrogazione delle annotazioni sono diverse per ogni fonte di dati. Per informazioni sulle annotazioni in una fonte di dati specifica, consulta. [Connessione alle origini dati](AMG-data-sources.md) ## Interrogazione integrata Dopo aver aggiunto un'annotazione, sarà ancora visibile. Ciò è dovuto alla query di annotazione integrata presente in tutti i dashboard. Questa query di annotazione recupererà tutti gli eventi di annotazione che provengono dalla dashboard corrente, che sono archiviati in Grafana, e li mostrerà nel pannello in cui sono stati creati. Ciò include le annotazioni della cronologia dello stato di avviso. Per impostazione predefinita, la query di annotazione integrata utilizza l'origine dati `Grafana` speciale e le annotazioni manuali sono supportate solo utilizzando questa fonte di dati. È possibile utilizzare un'altra origine dati nella query di annotazione incorporata, ma sarà possibile creare annotazioni automatiche solo utilizzando l'editor di query per tale origine dati. Per aggiungere annotazioni direttamente alla dashboard, questa query deve essere abilitata. **Per confermare che la query integrata è abilitata** 1. Seleziona l'icona **delle impostazioni** della dashboard (ingranaggio) nell'intestazione della dashboard per aprire il menu delle impostazioni della dashboard. 1. Seleziona **Annotazioni**. 1. Trova la query **Annotazioni e avvisi (integrata)**. Se mostra **Disabilitato** prima del nome della query, dovrai selezionare il nome della query per aprirla e aggiornare l'impostazione. **Per impedire che le annotazioni vengano recuperate e disegnate** 1. Seleziona l'icona **delle impostazioni** della dashboard (ingranaggio) nell'intestazione della dashboard per aprire il menu delle impostazioni della dashboard. 1. Seleziona **Annotazioni**. 1. Seleziona la query **Annotazioni e avvisi (integrata)**. 1. Seleziona l'interruttore **Abilitato** per disattivarlo. Quando copi una dashboard utilizzando la funzione **Salva** con nome, riceverà un nuovo ID dashboard, quindi le annotazioni create sulla dashboard di origine non saranno più visibili nella copia. Puoi comunque mostrarle se aggiungi una nuova **Annotation Query** e filtra per tag. Tuttavia, questo funziona solo se le annotazioni nella dashboard di origine avevano tag in base ai quali filtrare. **Filtraggio delle query per tag** **È possibile creare nuove query per recuperare le annotazioni dalla query di annotazione incorporata utilizzando l'origine `Grafana` dati impostando Filter by to.** `Tags` Ad esempio, create il nome `outages` di una query di annotazione e specificate un tag. `outage` Questa query mostrerà tutte le annotazioni (da qualsiasi dashboard o tramite API) con il `outage` tag. Se in una query di annotazione sono definiti più tag, Grafana mostrerà solo le annotazioni che corrispondono a tutti i tag. Per modificare il comportamento, **abilita Match any** e Grafana mostrerà le annotazioni che contengono uno qualsiasi dei tag che hai fornito. Puoi anche utilizzare le variabili del modello nella query dei tag. Ciò significa che se disponi di una dashboard che mostra le statistiche per diversi servizi e di una variabile modello che determina quali servizi mostrare, puoi utilizzare la stessa variabile modello nella tua query di annotazione per mostrare solo le annotazioni per quei servizi. # Modello JSON del pannello di controllo **** **Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.** Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.md) Per le aree di lavoro Grafana che supportano la versione 8.x di Grafana, vedere. [Funzionamento in Grafana versione 8](using-grafana-v8.md) 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, seleziona l'icona delle **impostazioni della dashboard** (a forma di ingranaggio). 1. Seleziona il **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": [], "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) | | `title` | titolo attuale del pannello di controllo | | `tags` | tag associati alla dashboard, una serie di stringhe | | `style` | tema del pannello di controllo, ad esempio o `dark` `light` | | `timezone` | fuso orario del pannello di controllo, ad esempio o `utc` `browser` | | `editable` | 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 o `last 6 hours` `last 7 days` | | `timepicker` | metadati timepicker, consulta la sezione [timepicker](#v10-dash-json-panels) per i dettagli | | `templating` | [metadati basati sui modelli, consulta la sezione relativa ai modelli per i dettagli](#v10-dash-json-panels) | | `annotations` | [metadati delle annotazioni, vedi le annotazioni per sapere come aggiungerli](v10-dash-annotations.md) | | `refresh` | intervallo di aggiornamento automatico | | `schemaVersion` | versione dello schema JSON (numero intero), incrementata ogni volta che un aggiornamento Grafana apporta modifiche a questo schema | | `version` | versione della dashboard (numero intero), incrementata ogni volta che la dashboard viene aggiornata | | `panels` | array di pannelli (vedi la sezione successiva 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`— da 1 a 24 (la larghezza del pannello di controllo è suddivisa 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, nella stessa unità di`h`. La griglia ha una gravità negativa che si sposta verso l'alto dei pannelli 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" } ] } ``` La tabella seguente descrive l'utilizzo dei campi di modello. | Name | Utilizzo | | --- | --- | | `enable` | se il template è abilitato o meno | | `list` | una matrice di oggetti, ciascuno dei quali rappresenta una variabile di modello | | `allFormat` | formato da utilizzare durante il recupero di tutti i valori dalla fonte di dati, tra cui`wildcard`, `glob``regex`,`pipe`. | | `current` | mostra la variabile attualmente selezionata text/value sulla dashboard | | `datasource` | mostra la fonte di dati per le variabili | | `includeAll` | se tutte le opzioni di valore sono disponibili o meno | | `multi` | se è possibile selezionare o meno più valori dalla lista di valori variabili | | `multiFormat` | formato da usare durante il recupero delle serie temporali dalla fonte di dati | | `name` | nome della variabile | | `options` | matrice di text/value coppie di variabili disponibili per la selezione sulla dashboard | | `query` | query sull'origine dei dati utilizzata per recuperare i valori di una variabile | | `refresh` | configura quando aggiornare una variabile | | `regex` | estrae parte del nome di una serie o di un segmento di nodo metrico | | `type` | tipo di variabile`custom`, o `query` `interval` | # Procedure consigliate per i dashboard **** **Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.** Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.md) Per le aree di lavoro Grafana che supportano la versione 8.x di Grafana, vedere. [Funzionamento in Grafana versione 8](using-grafana-v8.md) Questa sezione fornisce informazioni sulle migliori pratiche per gli amministratori e gli utenti di Grafana su come creare e gestire i dashboard Grafana. Per informazioni sui diversi tipi di dashboard che puoi creare, consulta le dashboard [Grafana: una guida completa a tutti i diversi tipi di dashboard che puoi](https://grafana.com/blog/2022/06/06/grafana-dashboards-a-complete-guide-to-all-the-different-types-you-can-build/?pg=webinar-getting-started-with-grafana-dashboard-design-amer&plcmt=related-content-1) creare post sul sito Web di Grafana Labs. **Nota** Questa sezione può aiutarti a creare una strategia per il monitoraggio e la manutenzione del pannello di controllo. Conoscete meglio i vostri sistemi e dovreste usare questa sezione per guidarvi nella comprensione. In definitiva, è tua responsabilità creare la strategia migliore per il tuo sistema. ## Strategie comuni di osservabilità Quando hai molte cose da monitorare, come una server farm, hai bisogno di una strategia per decidere cosa è abbastanza importante da monitorare. Questa pagina descrive diversi metodi comuni per scegliere cosa monitorare. Una strategia logica consente di creare dashboard uniformi e scalare più facilmente la piattaforma di osservabilità. **Linee guida per le strategie** + Il metodo USE ti dice quanto sono felici le tue macchine, il metodo RED ti dice quanto sono felici i tuoi utenti. + USE riporta le cause dei problemi. + RED riporta l'esperienza dell'utente ed è più probabile che riporti i sintomi dei problemi. + Il monitoraggio di entrambi è importante per comprendere il sistema. È buona norma prestare attenzione ai sintomi anziché alle cause. In genere, gli avvisi sono configurati sui dashboard RED. **Metodo USE** USE sta per: + **Utilizzo**: percentuale di tempo in cui la risorsa è occupata, ad esempio l'utilizzo della CPU del nodo. + **Saturazione**: quantità di lavoro che una risorsa deve svolgere, spesso la lunghezza della coda o il carico dei nodi. + **Errori**: conteggio degli eventi di errore. Questo metodo è ideale per le risorse hardware dell'infrastruttura, come CPU, memoria e dispositivi di rete. [Per ulteriori informazioni, consulta il post sul blog di Brendan Gregg The USE Method.](http://www.brendangregg.com/usemethod.html) **Metodo RED** RED sta per: + **Velocità**: richieste al secondo + **Errori**: numero di richieste non riuscite. + **Durata**: quantità di tempo impiegata da queste richieste, distribuzione delle misurazioni della latenza. Questo metodo è più applicabile ai servizi, in particolare a un ambiente di microservizi. Per ciascuno dei tuoi servizi, utilizza il codice per esporre queste metriche per ogni componente. I dashboard RED sono utili per avvisare e. SLAs Una dashboard RED ben progettata funge da proxy per l'esperienza utente. Per ulteriori informazioni, consulta il post sul blog di Tom Wilkie [The RED method: How to instrument your services](https://grafana.com/blog/2018/08/02/the-red-method-how-to-instrument-your-services). **I quattro segnali dorati** Secondo il [manuale di Google SRE](https://landing.google.com/sre/sre-book/chapters/monitoring-distributed-systems/#xref_monitoring_golden-signals), se riesci a misurare solo quattro metriche del tuo sistema rivolto agli utenti, concentrati su queste quattro. Questo metodo è simile al metodo RED, ma include la saturazione. + **Latenza**: tempo impiegato per soddisfare una richiesta. + **Traffico**: quanta richiesta viene immessa nel sistema. + **Errori**: percentuale di richieste non riuscite. + **Saturazione**: quanto è «pieno» il sistema, ## Modello di maturità per la gestione delle dashboard *La maturità della gestione delle dashboard* si riferisce a quanto sia ben progettato ed efficiente il tuo ecosistema di dashboard. Ti consigliamo di rivedere periodicamente la configurazione della dashboard per valutare a che punto sei e come puoi migliorare. In generale, la maturità della dashboard può essere definita come bassa, media o alta. Gran parte del contenuto di questo argomento è stato tratto dal talk [Fool-Proof Kubernetes Dashboards for Sleep-Deprived](https://www.youtube.com/watch?v=YE2aQFiMGfY) Oncalls del KubeCon 2019. **Basso: stato predefinito** In questa fase, non è disponibile una strategia di gestione del pannello di controllo coerente. Quasi tutti iniziano da qui. Come fai a sapere che sei qui? + Tutti possono modificare le tue dashboard. + Molte dashboard copiate, riutilizzo minimo o nullo delle dashboard. + Dashboard uniche che durano per sempre. + Nessun controllo della versione (dashboard JSON nel controllo della versione). + Naviga molto alla ricerca di dashboard, cerca la dashboard giusta. Ciò significa perdere molto tempo a cercare la dashboard di cui hai bisogno. + Non hai avvisi che ti indirizzino alla dashboard giusta. **Dashboard metodici di medie dimensioni** In questa fase, stai iniziando a gestire l'uso della dashboard con dashboard metodiche. Potresti aver definito una strategia, ma ci sono alcune cose che potresti migliorare. Come fai a sapere che sei qui? + Previeni l'espansione incontrollata utilizzando le variabili del modello. Ad esempio, non è necessaria una dashboard separata per ogni nodo, è possibile utilizzare variabili di query. Ancora meglio, puoi trasformare l'origine dei dati anche in una variabile modello, in modo da poter riutilizzare la stessa dashboard su diversi cluster e backend di monitoraggio. Per idee, consulta l'elenco degli esempi in[Variabili](v10-dash-variables.md),. + Dashboard metodici secondo una strategia di [osservabilità](#v10-dash-common-observability-strategies). + Dashboard gerarchici con approfondimenti al livello successivo. + Il design del pannello di controllo riflette le gerarchie dei servizi. Ad esempio, è possibile utilizzare il metodo RED con una riga per servizio. L'ordine delle righe potrebbe riflettere il flusso di dati, mentre scorri verso il basso la dashboard. + Confronta i like con i like: dividi le dashboard dei servizi quando la grandezza è diversa. Assicurati che le metriche aggregate non offuschino informazioni importanti. + Grafici espressivi con un uso significativo del colore e degli assi di normalizzazione, ove possibile. + Esempio di colore significativo: il blu significa che è buono, il rosso significa che è cattivo. [Le soglie](v10-panels-configure-thresholds.md) possono aiutare in questo senso. + Esempio di normalizzazione degli assi: quando confronti l'utilizzo della CPU, misura in percentuale anziché in numero grezzo, poiché le macchine possono avere un numero diverso di core. La normalizzazione dell'utilizzo della CPU in base al numero di core riduce il carico cognitivo perché lo spettatore può fidarsi che tutti i core vengano utilizzati al 100%, senza dover conoscerne il numero. CPUs + La navigazione diretta riduce le ipotesi. + Le variabili del modello rendono più difficile la navigazione in modo casuale o senza meta. + La maggior parte delle dashboard dovrebbe essere collegata tramite avvisi. + La navigazione è diretta tramite link. Per ulteriori informazioni, consulta [Gestione dei collegamenti alla dashboard](v10-dash-manage-dashboard-links.md). + Dashboard JSON con controllo della versione. **Utilizzo altamente ottimizzato** In questa fase, hai ottimizzato l'uso della gestione della dashboard con una strategia coerente e ponderata. Richiede manutenzione, ma i risultati ne valgono la pena. + Ridurre attivamente l'espansione incontrollata. + Esamina regolarmente le dashboard esistenti per assicurarti che siano ancora pertinenti. + Solo i dashboard approvati sono stati aggiunti all'elenco dei dashboard principali. + Monitoraggio dell'utilizzo della dashboard. Puoi sfruttare le [informazioni sull'utilizzo](v10-dash-assess-dashboard-usage.md). + Coerenza fin dalla progettazione. + Utilizza le librerie di script per generare dashboard e garantire la coerenza nel modello e nello stile. + grafonnet (Jsonnet) + grafanalib (Python) + Nessuna modifica nel browser. I visualizzatori della dashboard modificano le visualizzazioni con variabili. + La ricerca di dashboard è l'eccezione, non la regola. + Esegui sperimentazioni e test in un'istanza Grafana separata dedicata a tale scopo, non in un'istanza di produzione. Quando una dashboard nell'ambiente di test si dimostra utile, aggiungi quella dashboard all'istanza principale di Grafana. ## Le migliori pratiche per la creazione di dashboard Questa sezione descrive alcune best practice da seguire per la creazione di dashboard Grafana. **Prima di iniziare** Ecco alcuni principi da considerare prima di creare una dashboard. **Una dashboard dovrebbe raccontare una storia o rispondere a una domanda** Che storia stai cercando di raccontare con la tua dashboard? Prova a creare una progressione logica dei dati, ad esempio da grandi a piccoli o da generali a specifici. Qual è l'obiettivo di questa dashboard? (Suggerimento: se la dashboard non ha un obiettivo, chiediti se ne hai davvero bisogno.) Mantieni i tuoi grafici semplici e concentrati sulla risposta alla domanda che ti stai ponendo. Ad esempio, se la tua domanda è «quali server sono in difficoltà?» , allora forse non è necessario mostrare tutti i dati del server. Basta mostrare i dati per chi è in difficoltà. **Le dashboard dovrebbero ridurre il carico cognitivo, non aumentarlo** Il *carico cognitivo* è fondamentalmente la difficoltà con cui devi pensare a qualcosa per capirlo. Rendi la tua dashboard facile da interpretare. Gli altri utenti e voi future (quando starete cercando di capire cosa si è rotto alle 2 del mattino) lo apprezzerete. Chiediti: + Posso dire cosa rappresenta esattamente ogni grafico? È ovvio o devo pensarci? + Se lo mostro a qualcun altro, quanto tempo impiegheranno a capirlo? Si perderanno? **Avere una strategia di monitoraggio** È facile creare nuove dashboard. È più difficile ottimizzare la creazione di dashboard e rispettare un piano, ma ne vale la pena. Questa strategia dovrebbe governare sia lo schema generale del dashboard che imporre la coerenza nella progettazione delle singole dashboard. Per ulteriori informazioni, consulta [le strategie comuni di osservabilità](#v10-dash-common-observability-strategies) e i [livelli di maturità della gestione dei dashboard](#v10-dash-management-maturity-model). **Scrivilo** Una volta che hai una strategia o delle linee guida di progettazione, scrivile per mantenere la coerenza nel tempo. **Le migliori pratiche da seguire** + Quando crei una nuova dashboard, assicurati che abbia un nome significativo. + Se stai creando una dashboard per giocare o sperimentare, inserisci la parola `TEST` o `TMP` nel nome. + Prendi in considerazione l'idea di includere il tuo nome o le tue iniziali nel nome della dashboard o come tag in modo che le persone sappiano chi è il proprietario della dashboard. + Rimuovi i pannelli di controllo temporanei degli esperimenti quando hai finito di usarli. + Se crei molte dashboard correlate, pensa a come incrociarle per facilitarne la navigazione. Per ulteriori informazioni, consulta [Best practice per la gestione delle dashboard](#v10-dash-best-practices-for-managing-dashboards), più avanti in questa sezione. + Grafana recupera i dati da una fonte di dati. È importante una conoscenza di base delle fonti di dati [Connessione alle origini dati](AMG-data-sources.md) in generale e specifiche. + Evita l'aggiornamento non necessario della dashboard per ridurre il carico sulla rete o sul backend. Ad esempio, se i dati cambiano ogni ora, non è necessario impostare la frequenza di aggiornamento della dashboard su 30 secondi. + Usa gli assi Y sinistro e destro per visualizzare serie temporali con unità o intervalli diversi. + Aggiungi documentazione a dashboard e pannelli. + Per aggiungere documentazione a una dashboard, aggiungi una [visualizzazione del pannello di testo](v10-panels-text.md) alla dashboard. Registra elementi come lo scopo della dashboard, i link alle risorse utili e tutte le istruzioni di cui gli utenti potrebbero aver bisogno per interagire con la dashboard. + Per aggiungere documentazione a un pannello, modifica le impostazioni del pannello e aggiungi una descrizione. Qualsiasi testo che aggiungi verrà visualizzato se posizioni il cursore sul piccolo angolo `i` in alto a sinistra del pannello. + [Riutilizza le dashboard e rafforza la coerenza utilizzando modelli e variabili.](v10-dash-variables.md) + Fai attenzione a impilare i dati dei grafici. Le visualizzazioni possono essere fuorvianti e nascondere dati importanti. Si consiglia di disattivarlo nella maggior parte dei casi. ## Le migliori pratiche per la gestione delle dashboard Questa pagina descrive alcune best practice da seguire per la gestione delle dashboard Grafana. **Prima di iniziare** Ecco alcuni principi da considerare prima di iniziare a gestire le dashboard. **Osservabilità strategica** Esistono diverse strategie di [osservabilità comuni](#v10-dash-common-observability-strategies). Dovresti ricercarli e decidere se uno di essi funziona per te o se vuoi inventarne uno tuo. Ad ogni modo, prepara un piano, scrivilo e seguilo. Adatta la tua strategia alle mutevoli esigenze, se necessario. **Livello di maturità** Qual è il livello di maturità della tua dashboard? Analizza la configurazione attuale della dashboard e confrontala con il modello di [maturità della gestione della dashboard](#v10-dash-management-maturity-model). Capire dove ti trovi può aiutarti a decidere come arrivare dove vuoi essere. **Le migliori pratiche da seguire** + Evita la proliferazione incontrollata delle dashboard, ovvero la crescita incontrollata delle dashboard. L'espansione incontrollata delle dashboard influisce negativamente sul tempo necessario per trovare la dashboard giusta. Duplicare le dashboard e modificare «una cosa» (peggio ancora: mantenere i tag originali) è il tipo di espansione incontrollata più semplice. + Esamina periodicamente le dashboard e rimuovi quelle non necessarie. + Se crei una dashboard temporanea, magari per testare qualcosa, inserisci come prefisso il nome. `TEST:` Elimina la dashboard quando hai finito. + Copiare i dashboard senza modifiche significative non è una buona idea. + Ti perdi gli aggiornamenti alla dashboard originale, come le modifiche alla documentazione, le correzioni di bug o le aggiunte alle metriche. + In molti casi vengono create delle copie per personalizzare semplicemente la visualizzazione impostando i parametri del modello. Ciò dovrebbe invece essere fatto mantenendo un collegamento alla dashboard principale e personalizzando la visualizzazione con [i parametri URL](v10-panels-configure-data-links.md#v10-panels-data-link-variables). + Quando devi copiare una dashboard, rinominala chiaramente e *non* copiare i tag della dashboard. I tag sono metadati importanti per i dashboard utilizzati durante la ricerca. La copia dei tag può generare false corrispondenze. + Gestisci una dashboard composta da dashboard o dashboard con riferimenti incrociati. Questa operazione può essere eseguita in diversi modi: + Crea collegamenti alla dashboard, ai pannelli o ai dati. I link possono andare ad altre dashboard o a sistemi esterni. Per ulteriori informazioni, consulta [Gestire i collegamenti alla dashboard](v10-dash-manage-dashboard-links.md). + Aggiungi un [pannello con l'elenco della dashboard](v10-panels-dashboard-list.md). Puoi quindi personalizzare ciò che vedi effettuando ricerche per tag o cartelle. + Aggiungi un [pannello di testo](v10-panels-dashboard-list.md) e usa markdown per personalizzare la visualizzazione.