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](using-grafana-v10.md) 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) Grafana utilizza diversi tipi di variabili. | Tipo della variabile | Description | | --- | --- | | Query | Elenco di valori generato da query come nomi di metriche, nomi di server, sensori IDs, data center e così via. Per ulteriori informazioni, consulta [Aggiungere una variabile di query](#add-a-query-variable). | | Personalizzato | Definite manualmente le opzioni delle variabili utilizzando un elenco separato da virgole. Per ulteriori informazioni, consulta [Aggiungere una variabile personalizzata](#add-a-custom-variable). | | 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](#add-a-text-box-variable). | | Costante | Definire una costante nascosta. Per ulteriori informazioni, consulta [Aggiungere una variabile costante](#add-a-constant-variable). | | Origine dati | Cambia rapidamente la fonte di dati per un intero pannello di controllo. Per ulteriori informazioni, consulta [Aggiungere una variabile di origine dati](#add-a-data-source-variable). | | Interval | Le variabili di intervallo rappresentano intervalli di tempo. Per ulteriori informazioni, consulta [Aggiungere una variabile di intervallo](#add-an-interval-variable). | | Filtri ad hoc | Key/value filtri 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](#add-ad-hoc-filters). | | Variabili globali | Variabili integrate che possono essere utilizzate nelle espressioni dell'editor di query. Per ulteriori informazioni, consulta [Variabili globali](#global-variables). | | Variabili concatenate | Le interrogazioni variabili possono contenere altre variabili. Per ulteriori informazioni, consulta [Variabili concatenate](#chained-variables). | ## 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 IDs, sensori o data center. I valori delle variabili cambiano man mano che recuperano dinamicamente le opzioni con una query sull'origine dei dati. Le 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'indirizzo[Connessione alle origini dati](AMG-data-sources.md). ### Inserimento di opzioni generali **Per inserire opzioni generali per una variabile di interrogazione** 1. 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. 1. Nella scheda **Variabili**, scegli **Nuovo**. 1. Inserisci un **nome** per la variabile. 1. Nell'elenco **Tipo**, selezionare **Interrogazione**. 1. (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. 1. 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** 1. Nell'elenco **Origine dati**, selezionare l'origine dati di destinazione per la query. Per ulteriori informazioni sulle fonti di dati, consulta[Connessione alle origini dati](AMG-data-sources.md). 1. 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. 1. Nel campo **Query**, inserisci una query. + Il campo di interrogazione varia in base alla fonte di dati. Alcune fonti di dati dispongono di editor di query personalizzati. + Se hai bisogno di più spazio in un 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. 1. (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](templates-and-variables.md#filter-variables-with-regex). 1. Nell'elenco **Ordinamento**, seleziona il tipo di ordinamento dei valori da visualizzare nell'elenco a discesa. L'opzione predefinita, **Disabilitata**, indica che verrà utilizzato l'ordine delle opzioni restituite dalla query sull'origine dei dati. 1. (Facoltativo) Inserite **le opzioni di selezione**. Per ulteriori informazioni, consulta [Inserimento delle opzioni di selezione delle variabili](templates-and-variables.md#enter-variable-selection-options). 1. 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. 1. 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 cambiano, è 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](#chained-variables) ### Inserimento di opzioni generali **Per inserire le opzioni di interrogazione per una variabile personalizzata** 1. 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. 1. Nella scheda **Variabili**, scegli **Nuovo**. 1. Inserisci un **nome** per la variabile. 1. Nell'elenco **Tipo**, scegli **Personalizzato**. 1. (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. 1. 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** 1. 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. 1. **(Facoltativo) Inserite le opzioni di selezione.** Per ulteriori informazioni, consulta [Inserimento delle opzioni di selezione delle variabili](templates-and-variables.md#enter-variable-selection-options). 1. 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. 1. 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. Usa questo tipo di variabile se hai 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** 1. 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. 1. Nella scheda **Variabili**, scegli **Nuovo**. 1. Inserisci un **nome** per la variabile. 1. Nell'elenco **Tipo**, seleziona la **casella Testo**. 1. (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. 1. 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** 1. (Facoltativo) Nel campo **Valore predefinito**, selezionate il valore predefinito per la variabile. Se non si inserisce nulla in questo campo, Grafana visualizza una casella di testo vuota in cui è possibile digitare il testo. 1. In **Anteprima dei valori**, Grafana mostra un elenco dei valori delle variabili correnti. Controllali per assicurarti che corrispondano a ciò che ti aspetti. 1. 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 riscrivere in ogni singola query. Ad esempio, se hai chiamato un percorso del server`i-0b6a61efe2ab843gg`, puoi sostituirlo con una variabile chiamata. `$path_gg` ### Inserimento di opzioni generali **Per inserire opzioni generali per una variabile costante** 1. 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. 1. Nella scheda **Variabili**, scegli **Nuovo**. 1. Inserisci un **nome** per la variabile. 1. Nell'elenco **Tipo**, selezionate **Costante**. 1. (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. 1. 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** 1. 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](templates-and-variables.md#advanced-variable-format-options). 1. 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. 1. 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 hai più istanze di un'origine dati, magari in ambienti diversi. ### Inserimento di opzioni generali **Per inserire opzioni generali per una variabile di origine dati** 1. 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. 1. Nella scheda **Variabili**, scegli **Nuovo**. 1. Inserisci un **nome** per la variabile. 1. Nell'elenco **Tipo**, seleziona **Datasource**. 1. (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. 1. 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** 1. Nell'elenco **Tipo**, selezionate l'origine dati di destinazione per la variabile. Per ulteriori informazioni sulle fonti di dati, consulta[Connessione alle origini dati](AMG-data-sources.md). 1. (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. 1. (Facoltativo) Inserite **le opzioni di selezione**. Per ulteriori informazioni, consulta [Inserimento delle opzioni di selezione delle variabili](templates-and-variables.md#enter-variable-selection-options). 1. In **Anteprima dei valori**, Grafana mostra un elenco dei valori delle variabili correnti. Controllali per assicurarti che corrispondano a ciò che ti aspetti. 1. Scegli **Aggiungi** per aggiungere la variabile alla dashboard. ## Aggiungere una variabile di intervallo Usa una variabile di *intervallo* per rappresentare intervalli di tempo come`1m`,,. `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** 1. 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. 1. Nella scheda **Variabili**, scegli **Nuovo**. 1. Inserisci un **nome** per la variabile. 1. Nell'elenco **Tipo**, selezionate **Intervallo.** 1. (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. 1. 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** 1. 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`. 1. (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 di `auto` 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. 1. In **Anteprima dei valori**, Grafana mostra un elenco dei valori delle variabili correnti. Controllali per assicurarti che corrispondano a ciò che ti aspetti. 1. 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** 1. Vai alla dashboard per cui desideri creare una variabile, quindi scegli l'icona **delle impostazioni della dashboard** (ingranaggio) nella parte superiore della pagina. 1. Nella scheda **Variabili**, scegli **Nuovo**. 1. Inserisci un **nome** per la variabile. 1. Nell'elenco **Tipo**, selezionate **Filtri ad hoc**. 1. (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. 1. 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** 1. Nell'elenco **Origine dati**, seleziona l'origine dati di destinazione. Per ulteriori informazioni sulle fonti di dati, consulta[Connessione alle origini dati](AMG-data-sources.md). 1. 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 della dashboard. ## 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 delle dashboard e delle 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 delle variabili 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. ### \$1\$1\$1dashboard Questa variabile è il nome della dashboard corrente. ### \$1\$1\$1from e \$1\$1\$1to Grafana ha due variabili di intervallo temporale integrate: `$__from` e. `$__to` Attualmente sono sempre interpolati come millisecondi di epoca per impostazione predefinita, ma è possibile controllare la formattazione della data. | Sintassi | Risultato dell’esempio | Description | | --- | --- | --- | | \$1\$1\$1\$1from\$1 | 1594671549254 | Epoca Unix in millisecondi | | \$1\$1\$1\$1from:date\$1 | 2020-07-13T 20:19:09.254 Z | Nessun args, il valore predefinito è ISO 8601/RFC 3339 | | \$1\$1\$1\$1from:date:iso\$1 | 2020-07-13T 20:19:09.254 Z | ISO 8601/RFC 3339 | | \$1\$1\$1\$1from:date:seconds\$1 | 1594671549 | Epoca dei secondi di Unix | | \$1\$1\$1\$1from:date:YYYY-MM\$1 | 2020-07 | Qualsiasi formato di dati personalizzato. Per ulteriori informazioni, consulta [Display](https://momentjs.com/docs/#/displaying/). | La sintassi precedente funziona `${__to}` anche con. Puoi usare questa variabile anche URLs in. 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-giocare a casa? viewpanel=2&orgid=1? da=ora-6h&a=adesso ### \$1\$1\$1intervallo *È 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 raggruppare 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 in`2m`; i punti sono raggruppati in intervalli di 2 minuti. Se l'intervallo di tempo è di 6 mesi e il grafico è a schermo intero, l'intervallo potrebbe essere `1d` (1 giorno); i punti 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` ### \$1\$1\$1interval\$1ms Questa variabile è la `$__interval` variabile in millisecondi, non una stringa formattata con intervallo di tempo. Ad esempio, se è allora è. `$__interval` `20m` `$__interval_ms` `1200000` ### \$1\$1\$1name **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. ### \$1\$1\$1org Questa variabile è l'ID dell'organizzazione corrente. La variabile `${__org.name}` è il nome dell'organizzazione corrente. ### \$1\$1\$1user 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. ### \$1\$1\$1range Questa variabile è attualmente supportata solo per le fonti di dati Prometheus. Questa variabile rappresenta l'intervallo per la dashboard corrente. Viene calcolata da`to - from`. Ha rappresentazioni in millisecondi e secondi chiamate e. `$__range_ms` `$__range_s` ### \$1timeFilter o \$1\$1\$1timeFilter La `$timeFilter` variabile restituisce l'intervallo di tempo attualmente selezionato come espressione. Ad esempio, l'`Last 7 days`espressione dell'intervallo di tempo è`time > now() - 7d`. 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.