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

La tabella seguente elenca i tipi di variabili forniti con Grafana.

Inserimento delle opzioni generali

È necessario immettere opzioni generali per qualsiasi tipo di variabile creata.

Aggiungere una variabile di query

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 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.

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 anziché in altre variabili di query. Ciò ridurrebbe il numero di query che Grafana deve inviare quando le variabili concatenate vengono aggiornate.

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.

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 da includere nelle query ma non si desidera digitare nuovamente in ogni query. Ad esempio, se hai chiamato un percorso del serveri-0b6a61efe2ab843gg, puoi sostituirlo con una variabile chiamata. $path_gg

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.

Aggiungere una variabile di intervallo

Utilizzate una variabile di intervallo per rappresentare intervalli di tempo come1m, 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).

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.

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.

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 consentendo a ciascun plug-in di origine dati di comunicare al motore di interpolazione dei modelli quale formato utilizzare per più valori.

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

Elasticsearch 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 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:

Opzione Includi tutto

Grafana aggiunge un'Allopzione 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.

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 query. 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. $__intervalViene 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 in2m: i punti sono raggruppati in intervalli di 2 minuti. Se l'intervallo di tempo è di 6 mesi e il grafico è a schermo intero, l'intervallo potrebbe essere 1d (1 giorno). I punti vengono raggruppati per giorno.

Nell'origine dati InfluxDB, la variabile legacy $interval è la stessa variabile. $__intervaldovrebbe 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 ->). > >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

Attualmente è supportato solo per le fonti di dati Prometheus e Loki. Questa variabile rappresenta l'intervallo per la dashboard corrente. Viene calcolata dato - from. Ha una rappresentazione in millisecondi e una seconda denominata e. $__range_ms $__range_s

$__rate_interval

Attualmente è 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 daysespressione dell'intervallo di tempo ètime > now() - 7d.

Viene utilizzata in diversi luoghi, tra cui:

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 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

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.

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 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 usare regex per filtrare/modificare 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.

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

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

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="(?<text>[ ^ " ] + ) |chip=" (?<value >[ ^ " ] + )/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.

La pagina delle variabili consente di identificare facilmente se una variabile viene referenziata (o utilizzata) in altre variabili o nella dashboard.

Ogni variabile referenziata o utilizzata presenta un segno di spunta verde accanto ad essa, mentre le variabili non referenziate hanno un'icona di avvertenza arancione accanto ad esse. Inoltre, tutte le variabili referenziate hanno un'icona di dipendenza accanto al segno di spunta verde. È possibile selezionare l'icona per visualizzare la mappa delle dipendenze. La mappa delle dipendenze può essere spostata. È possibile ingrandire o ridurre con la rotellina del mouse o uno strumento equivalente.