Aggiungere e gestire le variabili 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

Per le aree di lavoro Grafana che supportano la versione 8.x di Grafana, vedere. Funzionamento in Grafana versione 8

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

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

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

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

Modelli

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

wmi_system_threads{instance=~"$server"}

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

Examples (Esempi)

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

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


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

Procedure ottimali variabili

• Gli elenchi a discesa delle variabili vengono visualizzati nell'ordine in cui sono elencati nell'elenco delle variabili nelle impostazioni della dashboard.

• Metti le variabili che cambierai spesso in alto, in modo che vengano mostrate per prime (all'estrema sinistra sulla dashboard).