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à. # Modelli e 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) Una variabile è un segnaposto per un valore. È possibile utilizzare le variabili nelle query metriche e nei titoli dei pannelli. Le variabili ti danno la possibilità di creare dashboard più interattive e dinamiche. Invece di inserire elementi come 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. Quando modifichi il valore utilizzando l'elenco a discesa nella parte superiore della dashboard, le query metriche del pannello riflettono il nuovo valore. Queste possono essere particolarmente utili per gli amministratori che desiderano consentire agli spettatori di modificare rapidamente le visualizzazioni ma non vogliono concedere loro autorizzazioni di modifica complete. I visualizzatori Grafana possono utilizzare variabili. Utilizzando variabili e modelli, puoi creare dashboard da un'unica fonte. 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. Questo semplifica la manutenzione e la manutenzione. Per un elenco dei tipi di variabili supportati e le istruzioni per aggiungere ogni tipo di variabile, vedere [Tipi di variabili](variables-types.md) ## Modelli Un *modello* è qualsiasi interrogazione che contiene una variabile. Ad esempio, se stavi amministrando una dashboard per monitorare diversi server, potresti creare una dashboard per ogni server. In alternativa, è possibile creare una dashboard e utilizzare pannelli con query basate su modelli, come illustrato nell'esempio seguente. ``` wmi_system_threads{instance=~"$server"} ``` I valori delle variabili vengono sempre sincronizzati con l'URL utilizzando la sintassi. `var-=value` ## 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 della dashboard. ## Sintassi variabile I titoli dei pannelli e le query metriche possono visualizzare le variabili utilizzando due diverse sintassi: + `$varname`Questa sintassi è più facile da leggere, come nell'esempio seguente:. `apps.frontend.$server.requests.count` Tuttavia, non è possibile utilizzare una variabile al centro di una parola. + `${var_name}`Utilizzate questa sintassi quando desiderate interpolare una variabile al centro di un'espressione. + `${var_name:}`Questo formato offre un maggiore controllo sul modo in cui Grafana interpola i valori. Per ulteriori informazioni, consulta [Opzioni avanzate di formato variabile](#advanced-variable-format-options). Prima che le query vengano inviate alla fonte di dati, la query viene *interpolata*, il che significa che la variabile viene sostituita con il suo valore corrente. Durante l'interpolazione, è possibile che il valore della variabile venga *ignorato per renderlo* conforme alla sintassi del linguaggio di interrogazione e del luogo in cui viene utilizzato. Ad esempio, una variabile utilizzata in un'espressione regex in una query Prometheus verrà escapata da regex. Leggi l'argomento della documentazione specifico sulla fonte di dati per i dettagli sulla fuga di valore durante l'interpolazione. Per informazioni sulla sintassi avanzata per sovrascrivere la formattazione predefinita dell'origine dati, consulta. [Opzioni avanzate di formato variabile](#advanced-variable-format-options) # 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. ## Altre opzioni variabili Questa sezione spiega le altre opzioni variabili disponibili. ### Inserimento delle opzioni di selezione delle variabili È possibile utilizzare **le opzioni di selezione** per gestire le selezioni di opzioni variabili. Tutte le opzioni di selezione sono opzionali e sono disattivate per impostazione predefinita. #### Valore multiplo Se attivi questa opzione, l'elenco a discesa delle variabili supporta la selezione di più opzioni contemporaneamente. Per ulteriori informazioni, consulta [Formattazione di variabili multivalore](#formatting-multi-value-variables). #### Opzione Includi tutto L'area di lavoro Grafana aggiunge un'`All`opzione all'elenco a discesa delle variabili. Se un utente finale seleziona questa opzione, vengono selezionate tutte le opzioni variabili. #### Personalizza tutti i valori Questa opzione è visibile solo se è selezionata l'**opzione Includi tutto**. Per definire il valore dell'`All`opzione, inserisci la sintassi regex, glob o Lucene nel campo **Custom** all value. Per impostazione predefinita, il `All` valore include tutte le opzioni nell'espressione combinata. Questa operazione può diventare molto lunga e causare problemi di prestazioni. A volte può essere meglio specificare un valore all personalizzato, ad esempio un'espressione regolare di tipo wild card. Quando utilizzi la sintassi personalizzata regex, glob o Lucene nell'opzione **Custom all value**, non viene mai ignorata, quindi devi considerare quale sia un valore valido per la tua origine dati. ### Opzioni avanzate di formato variabile La formattazione dell'interpolazione delle variabili dipende dall'origine dei dati, ma ci sono alcune situazioni in cui potresti voler modificare la formattazione predefinita. Ad esempio, l'impostazione predefinita per l'origine dati MySQL consiste nell'unire più valori separati da virgole da virgole:. `'server01','server02'` In alcuni casi, potresti voler avere una stringa separata da virgole senza virgolette:. `server01,server02` Per fare ciò, usa le seguenti opzioni avanzate di formattazione delle variabili. #### Sintassi generale Sintassi: `${var_name:option}` Se viene specificata un'opzione di formattazione non valida, `glob` è l'opzione predefinita o di riserva. #### CSV Formatta le variabili con più valori come una stringa separata da virgole. ``` servers = ['test1', 'test2'] String to interpolate: '${servers:csv}' Interpolation result: 'test1,test2' ``` #### Distribuito - OpenTSDB Formatta le variabili con più valori in formato personalizzato per OpenTSDB. ``` servers = ['test1', 'test2'] String to interpolate: '${servers:distributed}' Interpolation result: 'test1,servers=test2' ``` #### Virgolette doppie Formatta le variabili a valore singolo e multivalore in una stringa separata da virgole, scappa `"` in ogni valore da e cita ogni valore con`\"`. `"` ``` servers = ['test1', 'test2'] String to interpolate: '${servers:doublequote}' Interpolation result: '"test1","test2"' ``` #### Glob - Grafite Formatta le variabili con più valori in un glob (per le query Graphite). ``` servers = ['test1', 'test2'] String to interpolate: '${servers:glob}' Interpolation result: '{test1,test2}' ``` #### JSON Formatta le variabili con più valori come una stringa separata da virgole. ``` servers = ['test1', 'test2'] String to interpolate: '${servers:json}' Interpolation result: '["test1", "test2"]' ``` #### Lucene - OpenSearch Formatta le variabili con più valori in formato Lucene per. OpenSearch ``` servers = ['test1', 'test2'] String to interpolate: '${servers:lucene}' Interpolation result: '("test1" OR "test2")' ``` #### Codice percentuale Formatta le variabili a valore singolo e multivalore da utilizzare nei parametri URL. ``` servers = ['foo()bar BAZ', 'test2'] String to interpolate: '${servers:percentencode}' Interpolation result: 'foo%28%29bar%20BAZ%2Ctest2' ``` #### Pipeline Formatta le variabili con più valori in una stringa separata da un tubo. ``` servers = ['test1.', 'test2'] String to interpolate: '${servers:pipe}' Interpolation result: 'test1.|test2' ``` #### Raw Disattiva la formattazione specifica dell'origine dati, ad esempio le virgolette singole in una query SQL. ``` servers = ['test1.', 'test2'] String to interpolate: '${var_name:raw}' Interpolation result: '{test.1,test2}' ``` #### Espressione regolare Formatta le variabili con più valori in una stringa regex. ``` servers = ['test1.', 'test2'] String to interpolate: '${servers:regex}' Interpolation result: '(test1\.|test2)' ``` #### Citazione singola Formatta le variabili a valore singolo e multiplo in una stringa separata da virgole, scade `'` in ogni valore per e cita ogni valore con. `\'` `'` ``` servers = ['test1', 'test2'] String to interpolate: '${servers:singlequote}' Interpolation result: "'test1','test2'" ``` #### Sqlstring Formatta le variabili a valore singolo e multivalore in una stringa separata da virgole, scade `'` in ogni valore per e cita ogni valore con. `''` `'` ``` servers = ["test'1", "test2"] String to interpolate: '${servers:sqlstring}' Interpolation result: "'test''1','test2'" ``` #### Testo Formatta le variabili a valore singolo e multivalore nella loro rappresentazione testuale. Per una singola variabile, restituirà solo la rappresentazione del testo. Per le variabili multivalore, restituirà la rappresentazione del testo combinata con`+`. ``` servers = ["test1", "test2"] String to interpolate: '${servers:text}' Interpolation result: "test1 + test2" ``` ### Formattazione di variabili multivalore L'interpolazione di una variabile con più valori selezionati è complicata in quanto non è semplice formattare i valori multipli in una stringa valida nel contesto dato in cui viene utilizzata la variabile. Grafana cerca di risolvere questo problema abilitando ogni plug-in di origine dati a comunicare al motore di interpolazione dei modelli quale formato utilizzare per più valori. **Nota** L'opzione **Personalizza tutti i valori** sulla variabile deve essere vuota affinché Grafana formatti tutti i valori in un'unica stringa. Se lo lasci vuoto, la Grafana concatena (somma) tutti i valori della query. `value1,value2,value3`Qualcosa del genere. Se viene utilizzato un `all` valore personalizzato, il valore sarà invece qualcosa come `*` o`all`. #### Variabili multivalore con una fonte di dati Graphite Graphite utilizza espressioni globulari. **Una variabile con più valori, in questo caso, verrebbe interpolata come `{host1,host2,host3}` se il valore della variabile corrente fosse *host1, host2 e host3*.** #### Variabili multivalore con un'origine dati Prometheus o InfluxDB InfluxDB e Prometheus utilizzano espressioni regex, quindi la stessa variabile verrebbe interpolata di. `(host1|host2|host3)` Ogni valore verrebbe inoltre escluso dall'espressione regolare. In caso contrario, un valore con un carattere di controllo regex interromperebbe l'espressione regex. #### Variabili multivalore con un'origine dati elastica Amazon OpenSearch utilizza la sintassi delle query Lucene, quindi la stessa variabile verrebbe formattata come. `("host1" OR "host2" OR "host3")` In questo caso, è necessario escludere ogni valore in modo che il valore contenga solo le parole di controllo e le virgolette di Lucene. #### Risoluzione dei problemi di formattazione L'escape e la formattazione automatici possono causare problemi. Può essere difficile comprendere la logica alla base di un problema, specialmente per InfluxDB e Prometheus, dove l'uso della sintassi regex richiede che la variabile venga utilizzata nel contesto dell'operatore regex. Se non vuoi che Grafana esegua questa operazione di escape e formattazione automatica delle espressioni regolari, devi eseguire una delle seguenti operazioni: + **Disattiva le opzioni dell'opzione **Multivalore Includi** tutto.** + Usa il [formato variabile non elaborato] (\$1\$1< relref "advanced-variable-format-options.md \$1raw" >\$1\$1). ### Filtrare le variabili con regex Utilizzando l'opzione Regex Query, è possibile filtrare l'elenco di opzioni restituite dalla variabile query o modificare le opzioni restituite. Questa sezione mostra come utilizzare regex per filtrare e modificare i valori nell'elenco a discesa delle variabili. Utilizzando l'opzione Regex Query, si filtra l'elenco di opzioni restituite dalla query Variable o si modificano le opzioni restituite. Per ulteriori informazioni, vedete [Espressioni regolari](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions). Esempi di filtraggio nel seguente elenco di opzioni: ``` backend_01 backend_02 backend_03 backend_04 ``` #### Filtraggio in modo che vengano restituite solo le opzioni che terminano con `01` o `02` Regex: ``` /.*[01|02]/ ``` Risultato: ``` backend_01 backend_02 ``` #### Filtraggio e modifica delle opzioni utilizzando un gruppo di acquisizione regex per restituire parte del testo Regex: ``` /.*(01|02)/ ``` Risultato: ``` 01 02 ``` #### Filtraggio e modifica - Esempio di Prometheus Elenco di opzioni: ``` up{instance="demo.robustperception.io:9090",job="prometheus"} 1 1521630638000 up{instance="demo.robustperception.io:9093",job="alertmanager"} 1 1521630638000 up{instance="demo.robustperception.io:9100",job="node"} 1 1521630638000 ``` Regex: ``` /.*instance="([^"]*).*/ ``` Risultato: ``` demo.robustperception.io:9090 demo.robustperception.io:9093 demo.robustperception.io:9100 ``` #### Filtraggio e modifica utilizzando testo denominato e gruppi di acquisizione di valori Utilizzando gruppi di acquisizione denominati, è possibile acquisire parti separate di «testo» e «valore» dalle opzioni restituite dalla query variabile. L'elenco a discesa delle variabili può contenere un nome descrittivo per ogni valore che può essere selezionato. Ad esempio, quando si esegue una query sulla metrica `node_hwmon_chip_names` Prometheus, è più intuitivo del valore. `chip_name` `chip` Inizia con il seguente risultato della query variabile. ``` node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_0",chip_name="enp216s0f0np0"} 1 node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_1",chip_name="enp216s0f0np1"} 1 node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_2",chip_name="enp216s0f0np2"} 1 node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_3",chip_name="enp216s0f0np3"} 1 ``` Passalo attraverso la seguente Regex. ``` /chip_name="(?[^"]+)|chip="(?[^"]+)/g ``` Viene prodotto il seguente elenco a discesa. ``` Display Name Value ------------ ------------------------- enp216s0f0np0 0000:d7:00_0_0000:d8:00_0 enp216s0f0np1 0000:d7:00_0_0000:d8:00_1 enp216s0f0np2 0000:d7:00_0_0000:d8:00_2 enp216s0f0np3 0000:d7:00_0_0000:d8:00_3 ``` **Nota:** sono supportati solo `text` i nomi dei gruppi di `value` acquisizione. ### Pannelli o righe ripetuti Puoi creare dashboard dinamici utilizzando variabili *modello*. Tutte le variabili delle query si espandono fino al valore corrente della variabile prima che la query venga inviata al database. Con le variabili, puoi riutilizzare un'unica dashboard per tutti i tuoi servizi. Le variabili del modello possono essere molto utili per modificare dinamicamente le query su un'intera dashboard. *Se vuoi che Grafana crei dinamicamente nuovi pannelli o righe in base ai valori che hai selezionato, puoi usare la funzione Ripeti.* #### Pannelli ripetuti Se hai una variabile con `Multi-value` o `Include all value` opzioni attivate, puoi scegliere un pannello e fare in modo che Grafana ripeta quel pannello per ogni valore selezionato. Puoi trovare la funzione *Ripeti* nella *scheda Generale* in modalità di modifica del pannello. `direction`Controlla come sono disposti i pannelli. Se si sceglie`horizontal`, i pannelli vengono disposti side-by-side. Grafana regola automaticamente la larghezza di ogni pannello ripetuto in modo da riempire l'intera riga. Attualmente, non è possibile mescolare altri pannelli su una riga con un pannello ripetuto. Imposta `Max per row` per indicare a Grafana quanti pannelli per riga desideri al massimo. *Il valore predefinito è 4.* Se si sceglie`vertical`, i pannelli sono disposti dall'alto verso il basso in una colonna. La larghezza dei pannelli ripetuti è la stessa del primo pannello (il modello originale) che viene ripetuto. Apportate modifiche solo al primo pannello (il modello originale). Affinché le modifiche abbiano effetto su tutti i pannelli, devi avviare una ricostruzione dinamica della dashboard. Puoi farlo modificando il valore della variabile (ovvero la base per la ripetizione) o ricaricando la dashboard. **Nota** I pannelli ripetuti richiedono che le variabili abbiano uno o più elementi selezionati. Non è possibile ripetere un pannello zero volte per nasconderlo. #### Righe ripetute Come visto sopra, con i pannelli, puoi anche ripetere le righe se hai delle variabili impostate con `Multi-value` o un'opzione di `Include all value` selezione. Per attivare questa funzione, devi prima aggiungere una nuova *riga* utilizzando il menu *Aggiungi pannello*. Quindi fai una pausa sul titolo della riga e scegli il pulsante a forma di ingranaggio per accedere al pannello di `Row Options` configurazione. È quindi possibile selezionare la variabile per la quale si desidera ripetere la riga. È consigliabile utilizzare una variabile anche nel titolo della riga.