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à.
Tipi di variabili
Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 8.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 9.x di Grafana, vedere. Lavorare nella versione 9 di Grafana
Grafana utilizza diversi tipi di variabili.
Tipo di variabile | Descrizione |
---|---|
Query | Elenco di valori generato da una query, ad esempio nomi di metriche, nomi di server, ID dei sensori, data center e così via. Per ulteriori informazioni, consulta Aggiungere una variabile di query. |
Personalizza | Definite manualmente le opzioni delle variabili utilizzando un elenco separato da virgole. Per ulteriori informazioni, consulta Aggiungere una variabile personalizzata. |
Text box (Casella di testo) | Visualizza un campo di immissione di testo con un valore predefinito opzionale. Per ulteriori informazioni, consulta Aggiungere una variabile alla casella di testo. |
Costante | Definire una costante nascosta. Per ulteriori informazioni, consulta Aggiungere una variabile costante. |
Origine dati | Cambia rapidamente la fonte di dati per un intero pannello di controllo. Per ulteriori informazioni, consulta Aggiungere una variabile di origine dati. |
Interval | Le variabili di intervallo rappresentano intervalli di tempo. Per ulteriori informazioni, consulta Aggiungere una variabile di intervallo. |
Filtri ad hoc | Filtri chiave/valore che vengono aggiunti automaticamente a tutte le query metriche per un'origine dati (InfluxDB, Prometheus e solo). OpenSearch Per ulteriori informazioni, consulta Aggiungere filtri ad hoc. |
Variabili globali | Variabili integrate che possono essere utilizzate nelle espressioni dell'editor di query. Per ulteriori informazioni, consulta Variabili globali. |
Variabili concatenate | Le interrogazioni variabili possono contenere altre variabili. Per ulteriori informazioni, consulta Variabili concatenate. |
Aggiungere una variabile di query
Utilizzando le variabili di query, puoi scrivere una query sull'origine dati che restituisce un elenco di nomi di metriche, valori di tag o chiavi. Ad esempio, una variabile di query potrebbe restituire un elenco di nomi di server, ID di sensori o data center. I valori delle variabili cambiano man mano che recuperano dinamicamente le opzioni con una query sull'origine dei dati.
Le espressioni di query possono contenere riferimenti ad altre variabili e, in effetti, creare variabili collegate. Grafana lo rileva e aggiorna automaticamente una variabile quando una delle sue variabili collegate cambia.
Espressioni di interrogazione
Le espressioni di query sono diverse per ogni fonte di dati. Per ulteriori informazioni, consulta la documentazione relativa alla tua fonte di dati all'indirizzoConnessione alle origini dati.
Inserimento di opzioni generali
Per inserire opzioni generali per una variabile di interrogazione
-
Vai alla dashboard per cui desideri creare una variabile, quindi scegli l'icona delle impostazioni della dashboard (a forma di ingranaggio) nella parte superiore della pagina.
-
Nella scheda Variabili, scegli Nuovo.
-
Inserisci un nome per la variabile.
-
Nell'elenco Tipo, selezionare Interrogazione.
-
(Facoltativo) Per Label, inserite il nome visualizzato dell'elenco a discesa delle variabili. Se non inserisci un nome visualizzato, l'etichetta del menu a discesa sarà il nome della variabile.
-
Scegli un'opzione Nascondi:
-
Nessuna selezione (vuoto): l'elenco a discesa delle variabili mostra il nome o il valore dell'etichetta della variabile. Questa è l'impostazione predefinita.
-
Etichetta: l'elenco a discesa delle variabili mostra solo il valore della variabile selezionata e una freccia rivolta verso il basso.
-
Variabile: nella dashboard non viene visualizzato alcun elenco a discesa delle variabili.
-
Inserimento delle opzioni di interrogazione
Per inserire le opzioni di interrogazione per una variabile di interrogazione
-
Nell'elenco Origine dati, selezionare l'origine dati di destinazione per la query. Per ulteriori informazioni sulle fonti di dati, consultaConnessione alle origini dati.
-
Nell'elenco Aggiorna, selezionate quando la variabile deve aggiornare le opzioni.
-
Mai: memorizza nella cache le interrogazioni relative alle variabili e i valori non vengono aggiornati. Ciò va bene se i valori non cambiano mai, ma è problematico se sono dinamici e cambiano molto.
-
On Dashboard Load: interroga l'origine dati ogni volta che viene caricata la dashboard. Ciò rallenta il caricamento della dashboard, poiché la query variabile deve essere completata prima di poter inizializzare la dashboard.
-
In caso di modifica dell'intervallo di tempo: interroga l'origine dati quando l'intervallo di tempo del dashboard cambia. Utilizza questa opzione solo se la query sulle opzioni variabili contiene un filtro per intervallo di tempo o dipende dall'intervallo di tempo del dashboard.
-
-
Nel campo Query, inserisci una query.
-
Il campo di interrogazione varia in base alla fonte di dati. Alcune fonti di dati dispongono di editor di query personalizzati.
-
Se hai bisogno di più spazio in un editor di interrogazioni con un solo campo di input, fai una pausa sulle righe nell'angolo inferiore destro del campo e trascina verso il basso per espanderlo.
-
-
(Facoltativo) Nel campo Regex, digita un'espressione regex per filtrare o acquisire parti specifiche dei nomi restituiti dalla query sull'origine dati. Per alcuni esempi, consulta Filtrare le variabili con regex.
-
Nell'elenco Ordinamento, seleziona il tipo di ordinamento dei valori da visualizzare nell'elenco a discesa. L'opzione predefinita, Disabilitata, indica che verrà utilizzato l'ordine delle opzioni restituite dalla query sull'origine dei dati.
-
(Facoltativo) Inserite le opzioni di selezione. Per ulteriori informazioni, consulta Inserimento delle opzioni di selezione delle variabili.
-
In Anteprima dei valori, l'area di lavoro Grafana visualizza un elenco dei valori delle variabili correnti. Controllali per assicurarti che corrispondano a ciò che ti aspetti.
-
Scegli Aggiungi per aggiungere la variabile alla dashboard.
Aggiungere una variabile personalizzata
Usa una variabile personalizzata per valori che non cambiano. Potrebbero essere numeri, stringhe o anche altre variabili.
Ad esempio, se hai nomi di server o nomi di aree che non cambiano, puoi crearli come variabili personalizzate anziché variabili di query. Poiché non vengono modificate, è possibile utilizzarle in variabili concatenate anziché in altre variabili di query. Ciò ridurrebbe il numero di query che Grafana deve inviare quando le variabili concatenate vengono aggiornate. Per ulteriori informazioni sulle variabili concatenate, vedere. Variabili concatenate
Inserimento di opzioni generali
Per inserire le opzioni di interrogazione per una variabile personalizzata
-
Vai alla dashboard per cui desideri creare una variabile, quindi scegli l'icona delle impostazioni della dashboard (a forma di ingranaggio) nella parte superiore della pagina.
-
Nella scheda Variabili, scegli Nuovo.
-
Inserisci un nome per la variabile.
-
Nell'elenco Tipo, scegli Personalizzato.
-
(Facoltativo) Per Etichetta, inserite il nome visualizzato dell'elenco a discesa delle variabili. Se non inserisci un nome visualizzato, l'etichetta del menu a discesa sarà il nome della variabile.
-
Scegli un'opzione Nascondi:
-
Nessuna selezione (vuoto): l'elenco a discesa delle variabili mostra il nome o il valore dell'etichetta della variabile. Questa è l'impostazione predefinita.
-
Etichetta ‐ Il menu a discesa dell'elenco delle variabili mostra solo il valore della variabile selezionata e una freccia rivolta verso il basso.
-
Variabile: nella dashboard non viene visualizzato alcun elenco a discesa delle variabili.
-
Inserimento di opzioni personalizzate
Per inserire opzioni personalizzate per una variabile personalizzata
-
Nell'elenco Valori separati da virgole, immettete i valori di questa variabile in un elenco separato da virgole. È possibile includere numeri, stringhe, altre variabili o coppie chiave-valore separate da due punti.
-
(Facoltativo) Inserite le opzioni di selezione. Per ulteriori informazioni, consulta Inserimento delle opzioni di selezione delle variabili.
-
In Anteprima dei valori, l'area di lavoro Grafana visualizza un elenco dei valori delle variabili correnti. Controllali per assicurarti che corrispondano a ciò che ti aspetti.
-
Scegli Aggiungi per aggiungere la variabile alla dashboard.
Aggiungere una variabile alla casella di testo
Le variabili delle caselle di testo visualizzano un campo di immissione di testo con un valore predefinito opzionale. Questa è la variabile più flessibile, in quanto è possibile inserire qualsiasi valore. Utilizza questo tipo di variabile se disponi di metriche con cardinalità elevata o se desideri aggiornare più pannelli in una dashboard contemporaneamente.
Inserimento di opzioni generali
Per inserire opzioni generali per una variabile di casella di testo
-
Vai alla dashboard per cui desideri creare una variabile, quindi scegli l'icona delle impostazioni della dashboard (a forma di ingranaggio) nella parte superiore della pagina.
-
Nella scheda Variabili, scegli Nuovo.
-
Inserisci un nome per la variabile.
-
Nell'elenco Tipo, seleziona la casella Testo.
-
(Facoltativo) Per Label, inserite il nome visualizzato dell'elenco a discesa delle variabili. Se non inserisci un nome visualizzato, l'etichetta del menu a discesa sarà il nome della variabile.
-
Scegli un'opzione Nascondi:
-
Nessuna selezione (vuoto): l'elenco a discesa delle variabili mostra il nome o il valore dell'etichetta della variabile. Questa è l'impostazione predefinita.
-
Etichetta: l'elenco a discesa delle variabili mostra solo il valore della variabile selezionata e una freccia rivolta verso il basso.
-
Variabile: nella dashboard non viene visualizzato alcun elenco a discesa delle variabili.
-
Inserimento delle opzioni di testo
Per inserire le opzioni di testo per una variabile di casella di testo
-
(Facoltativo) Nel campo Valore predefinito, selezionate il valore predefinito per la variabile. Se non si inserisce nulla in questo campo, Grafana visualizza una casella di testo vuota in cui è possibile digitare il testo.
-
In Anteprima dei valori, Grafana mostra un elenco dei valori delle variabili correnti. Controllali per assicurarti che corrispondano a ciò che ti aspetti.
-
Scegli Aggiungi per aggiungere la variabile alla dashboard.
Aggiungere una variabile costante
Per definire una costante nascosta, utilizzate variabili costanti. Le variabili costanti sono utili per i prefissi dei percorsi metrici per i dashboard che desideri condividere. Quando esporti una dashboard, le variabili costanti vengono convertite in opzioni di importazione.
Le variabili costanti non sono flessibili. Ogni variabile costante contiene un solo valore. Per aggiornarla, è necessario aggiornare le impostazioni della variabile.
Le variabili costanti sono utili quando si dispone di valori complessi che è necessario includere nelle query ma non si desidera ridigitare in ogni singola query. Ad esempio, se hai chiamato un percorso del serveri-0b6a61efe2ab843gg
, puoi sostituirlo con una variabile chiamata. $path_gg
Inserimento di opzioni generali
Per inserire opzioni generali per una variabile costante
-
Vai alla dashboard per la quale desideri creare una variabile, quindi scegli l'icona delle impostazioni della dashboard (a forma di ingranaggio) nella parte superiore della pagina.
-
Nella scheda Variabili, scegli Nuovo.
-
Inserisci un nome per la variabile.
-
Nell'elenco Tipo, selezionate Costante.
-
(Facoltativo) Per Label, inserite il nome visualizzato dell'elenco a discesa delle variabili. Se non inserisci un nome visualizzato, l'etichetta del menu a discesa sarà il nome della variabile.
-
Scegli un'opzione Nascondi:
-
Variabile: nella dashboard non viene visualizzato alcun elenco a discesa delle variabili. Questa è l'impostazione predefinita.
-
Nessuna selezione (vuoto): l'elenco a discesa delle variabili mostra il nome o il valore dell'etichetta della variabile.
-
Etichetta: l'elenco a discesa delle variabili mostra solo il valore della variabile selezionata e una freccia rivolta verso il basso.
-
Inserimento di opzioni costanti
Per inserire opzioni costanti per una variabile costante
-
Nel campo Valore, immettere il valore della variabile. È possibile inserire lettere, numeri e simboli. Se utilizzi opzioni avanzate di formato variabile, puoi persino usare le wild card. Per ulteriori informazioni, consulta Opzioni avanzate di formato variabile.
-
In Anteprima dei valori, l'area di lavoro Grafana visualizza il valore della variabile corrente. Controllalo per assicurarti che corrisponda a quello che ti aspetti.
-
Scegli Aggiungi per aggiungere la variabile alla dashboard.
Aggiungere una variabile di origine dati
Per modificare rapidamente l'origine dati per un'intera dashboard, puoi utilizzare le variabili dell'origine dati. Sono utili se disponi di più istanze di un'origine dati, magari in ambienti diversi.
Inserimento di opzioni generali
Per inserire opzioni generali per una variabile di origine dati
-
Vai alla dashboard per cui desideri creare una variabile, quindi scegli l'icona delle impostazioni della dashboard (a forma di ingranaggio) nella parte superiore della pagina.
-
Nella scheda Variabili, scegli Nuovo.
-
Inserisci un nome per la variabile.
-
Nell'elenco Tipo, seleziona Datasource.
-
(Facoltativo) Per Label, inserite il nome visualizzato dell'elenco a discesa delle variabili. Se non inserisci un nome visualizzato, l'etichetta del menu a discesa sarà il nome della variabile.
-
Scegli un'opzione Nascondi:
-
Nessuna selezione (vuoto): l'elenco a discesa delle variabili mostra il nome o il valore dell'etichetta della variabile. Questa è l'impostazione predefinita.
-
Etichetta: l'elenco a discesa delle variabili mostra solo il valore della variabile selezionata e una freccia rivolta verso il basso.
-
Variabile: nella dashboard non viene visualizzato alcun elenco a discesa delle variabili.
-
Inserimento delle opzioni relative all'origine dei dati
Per inserire le opzioni relative all'origine dati per una variabile dell'origine dati
-
Nell'elenco Tipo, selezionate l'origine dati di destinazione per la variabile. Per ulteriori informazioni sulle fonti di dati, consultaConnessione alle origini dati.
-
(Facoltativo) Per Filtro del nome dell'istanza, inserisci un filtro regex per le istanze di origine dati tra cui scegliere nell'elenco a discesa dei valori delle variabili. Mantieni vuoto questo campo per visualizzare tutte le istanze.
-
(Facoltativo) Inserite le opzioni di selezione. Per ulteriori informazioni, consulta Inserimento delle opzioni di selezione delle variabili.
-
In Anteprima dei valori, Grafana mostra un elenco dei valori delle variabili correnti. Controllali per assicurarti che corrispondano a ciò che ti aspetti.
-
Scegli Aggiungi per aggiungere la variabile alla dashboard.
Aggiungere una variabile di intervallo
Usa una variabile di intervallo per rappresentare intervalli di tempo come1m
,,. 1h
1d
Puoi considerarli come un comando a livello di dashboard group-by-time . Le variabili di intervallo modificano il modo in cui i dati vengono raggruppati nella visualizzazione. È inoltre possibile utilizzare l'opzione Auto per restituire un determinato numero di punti dati per intervallo di tempo.
È possibile utilizzare una variabile di intervallo come parametro per raggruppare per ora (per InfluxDB), intervallo di data e istogramma (per) o come parametro della funzione di riepilogo (per Graphite OpenSearch).
Inserimento di opzioni generali
Per inserire opzioni generali per una variabile di intervallo
-
Vai alla dashboard per cui desideri creare una variabile, quindi scegli l'icona delle impostazioni della dashboard (a forma di ingranaggio) nella parte superiore della pagina.
-
Nella scheda Variabili, scegli Nuovo.
-
Inserisci un nome per la variabile.
-
Nell'elenco Tipo, selezionate Intervallo.
-
(Facoltativo) Per Label, inserite il nome visualizzato dell'elenco a discesa delle variabili. Se non inserisci un nome visualizzato, l'etichetta del menu a discesa sarà il nome della variabile.
-
Scegli un'opzione Nascondi:
-
Nessuna selezione (vuoto): l'elenco a discesa delle variabili mostra il nome o il valore dell'etichetta della variabile. Questa è l'impostazione predefinita.
-
Etichetta: l'elenco a discesa delle variabili mostra solo il valore della variabile selezionata e una freccia rivolta verso il basso.
-
Variabile: nella dashboard non viene visualizzato alcun elenco a discesa delle variabili.
-
Inserimento delle opzioni relative agli intervalli
Per inserire le opzioni di intervallo per una variabile di intervallo
-
Nel campo Valori, inserisci gli intervalli di intervallo di tempo che desideri vengano visualizzati nell'elenco a discesa delle variabili. Sono supportate le seguenti unità di tempo:
s (seconds)
,,m (minutes)
,h (hours)
,d (days)
w (weeks)
,M (months)
e.y (years)
Puoi anche accettare o modificare i valori predefiniti:1m,10m,30m,1h,6h,12h,1d,7d,14d,30d
. -
(Facoltativo) Attiva l'opzione automatica se desideri aggiungere l'
auto
opzione all'elenco. Utilizzate questa opzione per specificare quante volte deve essere diviso l'intervallo di tempo corrente per calcolare l'intervallo diauto
tempo corrente. Se lo attivi, vengono visualizzate altre due opzioni:-
Conteggio dei passaggi: seleziona il numero di volte in cui l'intervallo di tempo corrente verrà diviso per calcolare il valore, in modo simile all'opzione di interrogazione Max data points. Ad esempio, se l'intervallo di tempo visibile corrente è di 30 minuti, l'
auto
intervallo raggruppa i dati in 30 incrementi di un minuto. Il valore predefinito è 30 passaggi. -
Intervallo minimo: la soglia minima al di sotto della quale gli intervalli di conteggio dei passi non divideranno il tempo. Per continuare con l'esempio di 30 minuti, se l'intervallo minimo è impostato su,
2m
Grafana raggruppa i dati in 15 incrementi da 2 minuti.
-
-
In Anteprima dei valori, Grafana mostra un elenco dei valori delle variabili correnti. Controllali per assicurarti che corrispondano a ciò che ti aspetti.
-
Scegli Aggiungi per aggiungere la variabile alla dashboard.
Esempi di variabili a intervallo
Esempio di utilizzo della variabile template myinterval
in una funzione Graphite:
summarize($myinterval, sum, false)
Un esempio di grafite più complesso:
groupByNode(summarize(movingAverage(apps.$app.$server.counters.requests.count, 5), '$interval', 'sum', false), 2, 'sum')
Aggiungere filtri ad hoc
Puoi utilizzare filtri monouso o ad hoc per aggiungere filtri chiave/valore che vengono aggiunti automaticamente a tutte le query metriche che utilizzano l'origine dati specificata. A differenza di altre variabili, non si utilizzano filtri monouso nelle query. Li utilizzate invece per scrivere filtri per le interrogazioni esistenti.
Nota
Nota: le variabili di filtro una tantum o ad hoc funzionano solo con InfluxDB, Prometheus e fonti di dati. OpenSearch
Inserimento di opzioni generali
Per inserire opzioni generali per un filtro ad hoc
-
Vai alla dashboard per la quale desideri creare una variabile, quindi scegli l'icona delle impostazioni della dashboard (a forma di ingranaggio) nella parte superiore della pagina.
-
Nella scheda Variabili, scegli Nuovo.
-
Inserisci un nome per la variabile.
-
Nell'elenco Tipo, selezionate Filtri ad hoc.
-
(Facoltativo) Per Etichetta, inserite il nome visualizzato dell'elenco a discesa delle variabili. Se non inserisci un nome visualizzato, l'etichetta del menu a discesa sarà il nome della variabile.
-
Scegli un'opzione Nascondi:
-
Nessuna selezione (vuoto): l'elenco a discesa delle variabili mostra il nome o il valore dell'etichetta della variabile. Questa è l'impostazione predefinita.
-
Etichetta: l'elenco a discesa delle variabili mostra solo il valore della variabile selezionata e una freccia rivolta verso il basso.
-
Variabile: nella dashboard non viene visualizzato alcun elenco a discesa delle variabili.
-
Inserimento delle opzioni
Per inserire le opzioni per un filtro ad hoc
-
Nell'elenco Origine dati, seleziona l'origine dati di destinazione. Per ulteriori informazioni sulle fonti di dati, consultaConnessione alle origini dati.
-
Scegli Aggiungi per aggiungere la variabile alla dashboard.
Creazione di filtri ad hoc
I filtri ad hoc sono una delle opzioni variabili più complesse e flessibili disponibili. Invece di un normale elenco di opzioni variabili, questa variabile consente la creazione di una query ad hoc a livello di dashboard. I filtri applicati in questo modo vengono applicati a tutti i pannelli del pannello di controllo.
Variabili concatenate
Le variabili concatenate, chiamate anche variabili collegate o variabili annidate, sono variabili di query con una o più altre variabili nella relativa query variabile. Questa sezione spiega come funzionano le variabili concatenate e fornisce collegamenti a dashboard di esempio che utilizzano variabili concatenate.
Le interrogazioni con variabili concatenate sono diverse per ogni fonte di dati, ma la premessa è la stessa per tutte. È possibile utilizzare le query con variabili concatenate in qualsiasi fonte di dati che le supporti.
Puoi creare dashboard complesse, collegate e basate su modelli, con una profondità di 5 o 10 livelli. Tecnicamente, non ci sono limiti alla profondità o alla complessità che puoi raggiungere, ma più link hai, maggiore è il carico delle query.
Buone pratiche e suggerimenti
Le seguenti pratiche semplificheranno l'utilizzo di dashboard e variabili.
Creazione di nuove variabili concatenate
-
Il concatenamento di variabili crea dipendenze padre-figlio. Puoi immaginarle come una scala o un albero.
-
Il modo più rapido per creare una nuova variabile concatenata è copiare la variabile su cui si desidera basare quella nuova. Nell'elenco delle variabili, scegli l'icona Duplica variabile a destra della voce della variabile per crearne una copia. È quindi possibile aggiungerlo alla query per la variabile principale.
-
Le nuove variabili concatenate create in questo modo vengono visualizzate in fondo all'elenco. Per assegnare un ordine logico all'elenco, trascinate la variabile in una posizione diversa nell'elenco.
Ordine variabile
Per modificare l'ordine delle variabili nell'elenco delle variabili del dashboard, scegli le frecce su e giù sul lato destro di ogni voce. L'area di lavoro Grafana elenca gli elenchi a discesa delle variabili da sinistra a destra in base a questo elenco, visualizzando la variabile nella parte superiore dell'elenco all'estrema sinistra.
-
Elenca le variabili che non hanno dipendenze in alto, prima delle relative variabili secondarie.
-
Ogni variabile deve seguire quella da cui dipende.
-
L'interfaccia utente non indica quali variabili hanno relazioni di dipendenza. Elenca le variabili in ordine logico per renderle più chiare agli utenti finali (e a te stesso).
Considerazione della complessità
Maggiore è il numero di livelli di dipendenza nelle variabili, maggiore è il tempo necessario per aggiornare i dashboard dopo aver modificato le variabili.
Ad esempio, se disponi di una serie di quattro variabili collegate (country, region, server, metric) e modifichi il valore di una variabile radice (country), l'area di lavoro Grafana deve eseguire query per tutte le variabili dipendenti prima di aggiornare le visualizzazioni nella dashboard.
Variabili globali
Grafana ha variabili globali integrate che possono essere utilizzate nelle espressioni dell'editor di query. Questo argomento le elenca in ordine alfabetico e le definisce. Queste variabili sono utili nelle query, nei collegamenti alla dashboard, nei collegamenti ai pannelli e nei collegamenti dati.
$__dashboard
Questa variabile è il nome della dashboard corrente.
$__from e $__to
Grafana ha due variabili di intervallo temporale integrate: $__from
e. $__to
Attualmente sono sempre interpolati come millisecondi di epoca per impostazione predefinita, ma è possibile controllare la formattazione della data.
Sintassi | Risultato di esempio | Descrizione |
---|---|---|
${__from}
|
1594671549254 | Epoca Unix in millisecondi |
${__from:date}
|
2020-07-13T 20:19:09.254 Z | Nessun args, il valore predefinito è ISO 8601/RFC 3339 |
${__from:date:iso}
|
2020-07-13T 20:19:09.254 Z | ISO 8601/RFC 3339 |
${__from:date:seconds}
|
1594671549 | Epoca dei secondi di Unix |
${__from:date:YYYY-MM}
|
2020-07 | Qualsiasi formato di dati personalizzato. Per ulteriori informazioni, consulta Display |
La sintassi precedente funziona ${__to}
anche con.
Puoi usare questa variabile anche negli URL. Ad esempio, per inviare un utente finale a una dashboard che mostra un intervallo di tempo compreso tra sei ore fa e ora, utilizza il seguente URL: https://play.grafana.org/d/000000012/grafana-play-home? viewPanel=2&orgid=1? da=ora-6h&a=adesso
$__intervallo
È possibile utilizzare la $__interval
variabile come parametro per raggruppare in base all'ora (per InfluxDB, Myself, Postgres, MSSQL), all'intervallo dell'istogramma di data (per) o come parametro della funzione di riepilogo (per Graphite OpenSearch).
L'area di lavoro Grafana calcola automaticamente un intervallo che può essere utilizzato per raggruppare per tempo nelle interrogazioni. Quando ci sono più punti dati di quelli che possono essere visualizzati su un grafico, le interrogazioni possono essere rese più efficienti raggruppandole in base a un intervallo più ampio. Ad esempio, è più efficiente eseguire il raggruppamento per 1 giorno che per 10 secondi quando si esaminano 3 mesi di dati. Il grafico avrà lo stesso aspetto e la query sarà più veloce. $__interval
Viene calcolato utilizzando l'intervallo di tempo e la larghezza del grafico (il numero di pixel).
Calcolo approssimativo: (from - to) / resolution
Ad esempio, quando l'intervallo di tempo è di 1 ora e il grafico è a schermo intero, l'intervallo può essere calcolato in2m
; i punti sono raggruppati in intervalli di 2 minuti. Se l'intervallo di tempo è di 6 mesi e il grafico è a schermo intero, l'intervallo potrebbe essere 1d
(1 giorno); i punti sono raggruppati per giorno.
Nell'origine dati InfluxDB, la variabile legacy $interval
è la stessa variabile. Usare invece $__interval
.
InfluxDB e le fonti di OpenSearch dati dispongono di Group by time
interval
campi che vengono utilizzati per codificare l'intervallo o per impostare il limite minimo per la $__interval
variabile utilizzando la sintassi ->. >
>10m
$__interval_ms
Questa variabile è la $__interval
variabile in millisecondi, non una stringa formattata con intervallo di tempo. Ad esempio, se è allora è. $__interval
20m
$__interval_ms
1200000
$__name
Questa variabile è disponibile solo nel pannello Singlestat e può essere utilizzata nei campi del prefisso o del suffisso della scheda Opzioni. La variabile verrà sostituita con il nome o l'alias della serie.
$__org
Questa variabile è l'ID dell'organizzazione corrente. La variabile ${__org.name}
è il nome dell'organizzazione corrente.
$__user
La variabile ${__user.id}
è l'ID dell'utente corrente. La variabile ${__user.login}
è l'handle di accesso dell'utente corrente. La variabile ${__user.email}
è l'e-mail dell'utente corrente.
$__range
Questa variabile è attualmente supportata solo per le fonti di dati Prometheus. Questa variabile rappresenta l'intervallo per la dashboard corrente. Viene calcolata dato - from
. Ha rappresentazioni in millisecondi e secondi chiamate e. $__range_ms
$__range_s
$timeFilter o $__timeFilter
La $timeFilter
variabile restituisce l'intervallo di tempo attualmente selezionato come espressione. Ad esempio, l'Last 7
days
espressione dell'intervallo di tempo ètime > now() - 7d
.
Questa variabile viene utilizzata in diversi punti, tra cui:
-
La clausola WHERE per l'origine dati InfluxDB. Grafana lo aggiunge automaticamente alle query InfluxDB in modalità Query Editor. Puoi aggiungerlo manualmente in modalità Editor di testo:.
WHERE $timeFilter
-
Registra le query di Analytics nella fonte di dati di Azure Monitor.
-
Query SQL in MySQL, Postgres e MSSQL.
-
La
$__timeFilter
variabile viene utilizzata nell'origine dati MySQL.