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à. # Aggiungere e gestire variabili **** **Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.** Per le aree di lavoro Grafana che supportano la versione 12.x di Grafana, vedere. [Funzionamento nella versione 12 di Grafana](using-grafana-v12.md) Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Funzionamento in Grafana versione 9](using-grafana-v9.md) Per le aree di lavoro Grafana che supportano la versione 8.x di Grafana, vedere. [Funzionamento in Grafana versione 8](using-grafana-v8.md) La tabella seguente elenca i tipi di variabili in Grafana. | Tipo della variabile | Description | | --- | --- | | Query | Query-generated elenco di valori come nomi di metriche, nomi di server, ID dei sensori, data center e così via. | | Personalizzato | Definite manualmente le opzioni delle variabili utilizzando un elenco separato da virgole. | | Text box (Casella di testo) | Visualizza un campo di immissione di testo libero con un valore predefinito opzionale. | | Costante | Definire una costante nascosta. | | Origine dati | Cambia rapidamente la fonte di dati per un intero pannello di controllo. | | Interval | Le variabili di intervallo rappresentano intervalli di tempo. | | Filtri ad hoc | Key-value filtri che vengono aggiunti automaticamente a tutte le query metriche per un'origine dati (solo Prometheus, Loki, InfluxDB ed Elasticsearch). | | Variabili globali | Built-in variabili che possono essere utilizzate nelle espressioni nell'editor di query. | | Variabili concatenate | Le interrogazioni variabili possono contenere altre variabili. | **Topics** + [Inserimento delle opzioni generali](#v10-dash-variable-options) + [Aggiungere una variabile di interrogazione](#v10-dash-variable-add-query) + [Aggiungere una variabile personalizzata](#v10-dash-variable-add-custom) + [Aggiungere una variabile alla casella di testo](#v10-dash-variable-add-text) + [Aggiungere una variabile costante](#v10-dash-variable-add-constant) + [Aggiungere una variabile di origine dati](#v10-dash-variable-add-datasource) + [Aggiungere una variabile di intervallo](#v10-dash-variable-add-internal) + [Aggiungere filtri ad hoc](#v10-dash-variable-add-adhoc) + [Configura le opzioni di selezione delle variabili](#v10-dash-variable-add-selection) + [Variabili globali](#v10-dash-variable-add-global) + [Variabili concatenate](#v10-dash-variable-add-chained) + [Gestisci le variabili](#v10-dash-variable-add-manage) + [Filtra le variabili con regex](#v10-dash-variable-add-filter) ## Inserimento delle opzioni generali È necessario immettere opzioni generali per qualsiasi tipo di variabile creata. **Per inserire opzioni generali** 1. Vai alla dashboard per cui desideri creare una variabile e seleziona l'icona **delle impostazioni della dashboard** (a forma di ingranaggio) nella parte superiore della pagina. 1. Nella scheda **Variabili**, seleziona **Nuova variabile**. 1. Inserisci un **nome** per la variabile. 1. Nell'elenco **Tipo**, selezionare **Interrogazione**. 1. (Facoltativo) In **Etichetta**, inserite il nome visualizzato del menu a discesa della variabile. Se non inserisci un nome visualizzato, l'etichetta del menu a discesa è il nome della variabile. 1. Scegli un'opzione **Nascondi**: + **Nessuna selezione (vuota)**: l'elenco a discesa della variabile mostra il **nome** o il valore dell'**etichetta** della variabile. + **Etichetta**: l'elenco a discesa della variabile 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. ## Aggiungere una variabile di interrogazione Le variabili di query consentono di scrivere una query sull'origine dati in grado di restituire 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 variabili di query sono generalmente supportate solo per le stringhe. Se la query restituisce numeri o qualsiasi altro tipo di dati, potrebbe essere necessario convertirli in stringhe per utilizzarli come variabili. Per l'origine dati di Azure, ad esempio, puoi usare la funzione [tostring](https://docs.microsoft.com/en-us/azure/data-explorer/kusto/query/tostringfunction) per questo scopo. 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. **Nota** Le espressioni di query sono diverse per ogni fonte di dati. Per ulteriori informazioni, consulta la documentazione relativa all'[origine dati](AMG-data-sources.md). **Per aggiungere una variabile di query** 1. Immettete le opzioni generali, come sopra. 1. Nell'elenco **Origine dati**, seleziona l'origine dati di destinazione per la query. 1. Nell'elenco **Aggiorna**, selezionate quando la variabile deve aggiornare le opzioni. + **Al caricamento del dashboard**: esegue una query sull'origine dati ogni volta che viene caricato il 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 tua 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. + La query deve restituire valori denominati `__text` e`__value`. Ad esempio, in SQL, è possibile utilizzare una query come`SELECT hostname AS __text, id AS __value from MyTable`. Le interrogazioni per altre lingue variano a seconda della sintassi. + Se hai bisogno di più spazio in un editor di interrogazioni con un singolo campo di input, posiziona il cursore sulle linee nell'angolo inferiore destro del campo e trascina verso il basso per espandere. 1. (Facoltativo) Nel campo **Regex**, digita un'espressione regex per filtrare o acquisire parti specifiche dei nomi restituiti dalla query sull'origine dati. Per vedere degli esempi, consulta [Filtrare le variabili con regex](#v10-dash-variable-add-filter). 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](#v10-dash-variable-add-selection). 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. Seleziona **Aggiungi** per aggiungere la variabile alla dashboard. ## Aggiungere una variabile personalizzata Usa una variabile *personalizzata* per un valore che non cambia, ad esempio un numero o una stringa. Ad esempio, se hai nomi di server o nomi di regioni che non cambiano mai, potresti volerli creare come variabili personalizzate anziché variabili di query. Poiché non vengono modificate, è possibile utilizzarle in [variabili concatenate](#v10-dash-variable-add-chained) anziché in altre variabili di query. Ciò ridurrebbe il numero di query che Grafana deve inviare quando le variabili concatenate vengono aggiornate. **Per aggiungere una variabile personalizzata** 1. Inserisci le opzioni generali, come sopra. 1. Nell'elenco **Valori separati da virgole**, inserisci i valori di questa variabile in un elenco separato da virgole. È possibile includere numeri, stringhe o coppie chiave-valore separate da uno spazio e due punti. Ad esempio, `key1 : value1,key2 : value2`. 1. [(Facoltativo) Inserite le opzioni di selezione.](#v10-dash-variable-add-selection) 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. Seleziona **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 libero 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. **Per aggiungere una variabile di casella di testo** 1. Immettete le opzioni generali, come sopra. 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 gli utenti possono 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. Seleziona **Aggiungi** per aggiungere la variabile alla dashboard. ## Aggiungere una variabile costante Le variabili *costanti* consentono di definire una costante nascosta. Ciò è utile 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 solo un valore e non può essere aggiornata a meno che non si aggiornino le impostazioni della variabile. Le variabili costanti sono utili quando si hanno valori complessi che è necessario includere nelle query ma non si desidera riscriverli in ogni query. Ad esempio, se hai chiamato un percorso del server`i-0b6a61efe2ab843gg`, puoi sostituirlo con una variabile chiamata. `$path_gg` **Per aggiungere una variabile costante** 1. Inserisci le opzioni generali, come sopra. 1. Nel campo **Valore**, inserisci il valore della variabile. È possibile inserire lettere, numeri e simboli. Puoi anche usare i caratteri jolly se usi il [formato raw](v10-dash-variable-syntax.md#v10-dash-variable-syntax-raw). 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. Seleziona **Aggiungi** per aggiungere la variabile alla dashboard. ## Aggiungere una variabile di origine dati Le variabili di *origine dati* consentono di modificare rapidamente l'origine dati per un intero dashboard. Sono utili se disponi di più istanze di un'origine dati, magari in ambienti diversi. **Per aggiungere una variabile di origine dati** 1. Inserisci le opzioni generali, come sopra. 1. Nell'elenco **Tipo**, selezionate l'origine dati di destinazione per la variabile. Puoi anche scegliere **Apri selettore avanzato di origini dati** per visualizzare altre opzioni, inclusa l'aggiunta di un'origine dati (solo amministratori). Per ulteriori informazioni, consulta [Connessione alle origini dati](AMG-data-sources.md). 1. (Facoltativo) In **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. Lascia vuoto questo campo per visualizzare tutte le istanze. 1. (Facoltativo) Inserite [le opzioni di selezione](#v10-dash-variable-add-selection). 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. Seleziona **Aggiungi** per aggiungere la variabile alla dashboard. ## Aggiungere una variabile di intervallo Utilizzate una variabile di *intervallo* per rappresentare intervalli di tempo come`1m`, `1h` o. `1d` *Puoi considerarli come un gruppo a livello di dashboard basato su un comando temporale.* 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 Elasticsearch) o come parametro della funzione di riepilogo (per Graphite). **Per aggiungere una variabile di intervallo** 1. Immettete le opzioni generali, come sopra. 1. Nel campo **Valori**, inserisci gli intervalli 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 Auto** se desideri aggiungere l'`auto`opzione all'elenco. Questa opzione consente di specificare quante volte l'intervallo di tempo corrente deve essere diviso per calcolare l'intervallo di `auto` tempo corrente. Se lo accendi, 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 2 m, Grafana raggrupperà i dati in 15 incrementi di due 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. Seleziona **Aggiungi** per aggiungere la variabile alla dashboard. **Esempi di variabili a intervallo** L'esempio seguente mostra una variabile modello `myinterval` in una funzione Graphite: ``` summarize($myinterval, sum, false) ``` ## Aggiungere filtri ad hoc *I filtri ad hoc* consentono di 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 ad hoc nelle query. Utilizzate invece filtri ad hoc per scrivere filtri per le query esistenti. **Nota** Le variabili di filtro ad hoc funzionano solo con le fonti di dati Prometheus, Loki, InfluxDB ed Elasticsearch. 1. Inserisci le opzioni generali, come sopra. 1. Nell'elenco **Origine dati**, seleziona l'origine dati di destinazione. Puoi anche scegliere **Apri selettore avanzato di origini dati** per visualizzare altre opzioni, inclusa l'aggiunta di un'origine dati (solo amministratori). Per ulteriori informazioni, consulta [Connessione alle origini dati](AMG-data-sources.md). 1. Seleziona **Aggiungi** per aggiungere la variabile alla dashboard. **Crea 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 di creare una query ad hoc a livello di dashboard. I filtri applicati in questo modo vengono applicati a tutti i pannelli della dashboard. ## Configura le opzioni di selezione delle variabili *Le opzioni di selezione* sono una funzionalità che è possibile utilizzare per gestire le selezioni di opzioni variabili. Tutte le opzioni di selezione sono opzionali e sono disattivate per impostazione predefinita. ### Multi-value variabili 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 consentendo a ciascun plug-in di origine dati di 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 viene lasciato vuoto, Grafana concatena (somma) tutti i valori della query. Ad esempio, `value1,value2,value3`. Se viene utilizzato un `all` valore personalizzato, il valore sarà invece o. `*` `all` **Multi-value variabili con una fonte di dati Graphite** Graphite utilizza espressioni globulari. **Una variabile con più valori, in questo caso, deve essere interpolata come `{host1,host2,host3}` se il valore della variabile corrente fosse *host1, host2 e host3*.** **Multi-value variabili con un'origine dati Prometheus o InfluxDB** InfluxDB e Prometheus utilizzano espressioni regex, quindi la stessa variabile viene interpolata di. `(host1|host2|host3)` Ogni valore viene inoltre escluso dall'espressione regolare. In caso contrario, un valore con un carattere di controllo regex interromperebbe l'espressione regex. **Multi-value variabili con una fonte di dati elastica** Elasticsearch utilizza la sintassi delle query lucene, quindi la stessa variabile è formattata come. `("host1" OR "host2" OR "host3")` In questo caso, ogni valore viene escluso in modo che il valore contenga solo le parole di controllo Lucene e le virgolette. **Risolvi i problemi relativi alle variabili multivalore** L'escape e la formattazione automatici possono causare problemi e può essere difficile comprenderne la logica alla base. Soprattutto 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 l'escape e la formattazione automatica delle espressioni regolari, devi eseguire una delle seguenti operazioni: + Disattivate le opzioni dell'opzione **Multi-value**o **Includi** tutto. + Usa il [formato raw](v10-dash-variable-syntax.md#v10-dash-variable-syntax-raw). ### Opzione Includi tutto Grafana aggiunge un'`All`opzione all'elenco a discesa delle variabili. Se un utente seleziona questa opzione, vengono selezionate tutte le opzioni variabili. ### Personalizza tutti i valori Questa opzione è visibile solo se è selezionata l'**opzione Includi tutto**. Immettete la sintassi regex, globs o lucene nel campo **Custom all value** per definire il valore dell'opzione. `All` Per impostazione predefinita, il `All` valore include tutte le opzioni in un'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 con caratteri jolly. Per avere una sintassi regex, globs o lucene personalizzata nell'opzione **Custom all value**, questa opzione non viene mai evitata, quindi dovrai pensare a quale sia un valore valido per la tua fonte di dati. ## 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 puoi controllare la formattazione della data. | Sintassi | Risultato dell’esempio | Description | | --- | --- | --- | | `${__from}` | 1594671549254 | Epoca Unix in millisecondi | | `${__from:date}` | 2020-07-13 T20:19:09.254Z | Nessun argomento, il valore predefinito è ISO 3339 8601/RFC | | `${__from:date:iso}` | 2020-07-13 T20:19:09.254Z | ISO 3339 8601/RFC | | `${__from:date:seconds}` | 1594671549 | Epoca dei secondi di Unix | | `${__from:date:YYYY-MM}` | 2020-07 | Qualsiasi formato di data personalizzato che non includa il carattere: | La sintassi precedente funziona anche con`${__to}`. **$\_\_interval** *È possibile utilizzare la `$__interval` variabile come parametro per raggruppare per ora (per InfluxDB, MySQL, Postgres, MSSQL), intervallo di istogramma di data (per Elasticsearch) o come parametro della funzione di riepilogo (per Graphite).* 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, se stai guardando un grafico con dati relativi a 3 mesi, potresti non essere in grado di visualizzare i dettagli al minuto. Il raggruppamento per ora o giorno rende l'interrogazione più efficiente senza influire su ciò che mostra il grafico. `$__interval`Viene calcolato utilizzando l'intervallo di tempo e la larghezza del grafico (il numero di pixel). Calcolo approssimativo: `(to - from) / resolution` Ad esempio, quando l'intervallo di tempo è di 1 ora e il grafico è a schermo intero, l'intervallo potrebbe 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 vengono raggruppati per giorno. Nell'origine dati InfluxDB, la variabile legacy `$interval` è la stessa variabile. `$__interval`dovrebbe essere usato invece. Le fonti di dati InfluxDB ed Elasticsearch 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, ad esempio). `>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` **$\_\_org** Questa variabile è l'ID dell'organizzazione corrente. `${__org.name}`è il nome dell'organizzazione corrente. **$\_\_user** `${__user.id}`è l'ID dell'utente corrente. `${__user.login}`è l'handle di accesso dell'utente corrente. `${__user.email}`è l'e-mail dell'utente corrente. **$\_\_range** Supportato solo per le fonti di dati Prometheus e Loki. Questa variabile rappresenta l'intervallo per la dashboard corrente. Viene calcolata da`to - from`. Ha una rappresentazione in millisecondi e una seconda denominata e. `$__range_ms` `$__range_s` **$\_\_rate\_interval** Supportato solo per le fonti di dati Prometheus. La `$__rate_interval` variabile è pensata per essere utilizzata nella funzione rate. **$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`. Viene utilizzata in diversi luoghi, 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. **$\_\_timezone** La `$__timezone` variabile restituisce il fuso orario attualmente selezionato `utc` o una voce del database del fuso orario IANA (ad esempio,). `America/New_York` Se il fuso orario attualmente selezionato è l'*ora del browser*, Grafana proverà a determinare il fuso orario del browser. ## 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. Le query 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 consenta. Sono possibili dashboard con modelli collegati estremamente complessi, con 5 o 10 livelli di profondità. Tecnicamente, non ci sono limiti alla profondità o alla complessità che puoi raggiungere, ma più link hai, maggiore è il carico di query. **Buone pratiche e suggerimenti** Le seguenti pratiche semplificheranno l'utilizzo delle dashboard e delle variabili. **Creazione di nuove variabili collegate** + Le variabili concatenate creano parent/child dipendenze. Puoi immaginarle come una scala o un albero. + Il modo più semplice per creare una nuova variabile concatenata è copiare la variabile su cui si desidera basare quella nuova. Nell'elenco delle variabili, fate clic sull'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 create in questo modo vengono visualizzate in fondo all'elenco. Potrebbe essere necessario trascinarla in una posizione diversa nell'elenco per inserirla in un ordine logico. **Ordine variabile** Puoi modificare l'ordine delle variabili nell'elenco delle variabili del dashboard facendo clic sulle frecce su e giù sul lato destro di ogni voce. Grafana elenca i menu a discesa delle variabili da sinistra a destra in base a questo elenco, con la variabile in alto all'estrema sinistra. + Elenca le variabili che non hanno dipendenze in alto, prima delle variabili secondarie. + Ogni variabile deve seguire quella da cui dipende. + Ricorda che nell'interfaccia utente non è indicato quali variabili abbiano relazioni di dipendenza. Elenca le variabili in ordine logico per semplificare le cose agli altri utenti (e a te stesso). **Considerazione della complessità** Maggiore è il numero di livelli di dipendenza nelle variabili, maggiore sarà 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), Grafana deve eseguire le query per tutte le variabili dipendenti prima di aggiornare le visualizzazioni nella dashboard. ## Gestisci le variabili La pagina delle variabili consente di aggiungere variabili e gestire le variabili esistenti. Consente inoltre di [esaminare](v10-dash-variable-add-inspect.md) le variabili e identificare se una variabile viene referenziata (o utilizzata) in altre variabili o dashboard. **Sposta**: puoi spostare una variabile verso l'alto o verso il basso nell'elenco trascinandola. **Clona**: per clonare una variabile, fai clic sull'icona del clone dal set di icone a destra. In questo modo viene creata una copia della variabile con il nome della variabile originale preceduto da. `copy_of_` **Elimina**: per eliminare una variabile, fai clic sull'icona del cestino dal set di icone a destra. ## Filtra le variabili con regex Utilizzando l'opzione Regex Query, si filtra l'elenco di opzioni restituite dalla variabile query o si modificano le opzioni restituite. Questa pagina mostra come utilizzare regex per filter/modify i valori nel menu 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, consulta la guida di Mozilla sulle espressioni [regolari](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions). Gli esempi seguenti mostrano il filtraggio in base al seguente elenco di opzioni ``` backend_01 backend_02 backend_03 backend_04 ``` **Filtra in modo che vengano restituite solo le opzioni che `02` terminano con `01` o** Regex: ``` / ( 01|02 ) $/ ``` Risultato: ``` backend_01 backend_02 ``` **Filtra e modifica le opzioni utilizzando un gruppo di acquisizione regex per restituire parte del testo** Regex: ``` /.* ( 01|02 ) / ``` Risultato: ``` 01 02 ``` **Filtrare e modificare - Esempio di Prometheus** Per questo 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 ``` Questa espressione regolare: ``` /. *instance=" ( [^"]* ) .*/ ``` Restituisce questi risultati: ``` demo.robustperception.io:9090 demo.robustperception.io:9093 demo.robustperception.io:9100 ``` **Filtra e modifica utilizzando gruppi di acquisizione di testo e valori denominati** Utilizzando gruppi di acquisizione denominati, è possibile acquisire parti separate di «testo» e «valore» dalle opzioni restituite dalla query variabile. Ciò consente all'elenco a discesa delle variabili di 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, è molto più intuitiva `chip_name` del valore. `chip` Quindi 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 ``` Passato attraverso la seguente Regex: ``` /chip_name="(?[ ^ " ] + ) |chip=" (?[ ^ " ] + )/g ``` Produrrebbe 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 ``` Sono supportati solo `text` i nomi dei gruppi di `value` acquisizione.