Configurazione della correlazione

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 9.x di Grafana, vedere. Lavorare nella versione 9 di Grafana

Per le aree di lavoro Grafana che supportano la versione 8.x di Grafana, vedere. Funzionamento in Grafana versione 8

Ogni correlazione è configurata con le seguenti opzioni:

Etichetta

Etichetta del link, mostrata nella visualizzazione.

Descrizione

Descrizione facoltativa.

Fonte dei dati di origine

La fonte dei risultati per i quali sono visualizzati i link.

Campo dei risultati

Definisce dove viene mostrato il link in una visualizzazione.

Interrogazione target

La query di destinazione viene eseguita quando si fa clic su un collegamento.

Trasformazioni

Manipolazioni opzionali ai dati di origine inclusi passate alla query di destinazione.

Per informazioni dettagliate sulla creazione di una correlazione, consulta Creare una correlazione.

Fonte dei dati e campo dei risultati

I collegamenti sono mostrati in Esplora le visualizzazioni per i risultati della fonte di dati di origine della correlazione. A uno dei campi viene assegnato un collegamento in base al risultato fornito nella configurazione di correlazione (il campo dei risultati). Ogni visualizzazione mostra i campi con collegamenti in un modo diverso.

Interrogazione target

La query di destinazione viene eseguita quando si fa clic su un collegamento nella visualizzazione. È possibile utilizzare l'editor di query dell'origine dati di destinazione selezionata per specificare la query di destinazione. È possibile accedere ai risultati dei dati di origine all'interno della query di destinazione con variabili.

Variabili di correlazione

È possibile utilizzare le variabili all'interno della query di destinazione per accedere ai dati di origine relativi alla query. Le correlazioni utilizzano la sintassi delle variabili Grafana. Le variabili vengono riempite con i valori dei risultati di origine quando viene scelto il collegamento. È possibile utilizzare due tipi di variabili:

• Variabili di campo (per accedere ai valori e alle etichette dei campi).

• Variabili di correlazione (per accedere ai valori e alle trasformazioni dei campi).

Esempio: se i risultati di origine contengono un campo chiamatoemployee, è possibile accedere al valore del campo con:

• Una variabile di campo${__data.fields.employee}.

• Una variabile di correlazione che associa il valore del campo precedente a${employee}.

Oltre a mappare i valori dei campi su nomi di variabili più brevi, è possibile creare più variabili di correlazione applicando trasformazioni ai campi esistenti.

La correlazione crea un collegamento dati solo se tutte le variabili hanno valori nella riga di dati selezionata. Le variabili globali fanno eccezione a questa regola e non devono essere compilate utilizzando i dati restituiti. Queste variabili vengono interpolate automaticamente dalle fonti di dati.

Trasformazioni di correlazione

Le trasformazioni forniscono un modo per estrarre più variabili dai valori di campo. L'output delle trasformazioni è un insieme di nuove variabili a cui è possibile accedere come qualsiasi altra variabile.

Esistono due tipi di trasformazioni: logfmt ed espressione regolare.

Ogni trasformazione utilizza un valore di campo selezionato come input. L'output di una trasformazione è un insieme di nuove variabili basate sul tipo e sulle opzioni della trasformazione.

Trasformazione Logfmt

La trasformazione logfmt decostruisce un valore di campo contenente testo formattato con coppie chiave/valore logfmt. Ogni coppia diventa una variabile con la chiave come nome della variabile.

La trasformazione logfmt richiede solo di specificare il nome del campo di input se si desidera che la trasformazione si applichi a un campo diverso da quello dei risultati. Variabili di output di esempio per: field = "host=srv001 endpoint=/test app=foo"

nome	value
host	srv001
endpoint	/test
app	piede

Trasformazione delle espressioni regolari

La trasformazione delle espressioni regolari decostruisce un valore di campo in base all'espressione regolare fornita.

Opzioni di trasformazione delle espressioni regolari:

campo

Nome del campo di input

espressione

Espressione regolare. I gruppi di acquisizione denominati vengono mappati su variabili che corrispondono al nome del gruppo. Se vengono utilizzati gruppi corrispondenti senza nome, viene creata una variabile a partire dalla prima corrispondenza. Il valore sostituisce la variabile che corrisponde al campo di input oppure viene creata una nuova variabile se viene fornito mapValue (vedere gli esempi nella tabella seguente).

MapValue

Utilizzato con semplici gruppi regex senza gruppi corrispondenti denominati. Per impostazione predefinita, la prima corrispondenza sostituisce la variabile con il nome del campo utilizzato come input. Per modificare questo comportamento predefinito, puoi specificare la proprietà MapValue. Il nome fornito viene utilizzato per creare una nuova variabile. Ciò può essere utile se la query di destinazione richiede sia il valore esatto che una parte del valore estratto con la trasformazione.

Esempio: supponiamo che il nome del campo selezionato sia employee e che il valore del campo sia. John Doe

Diverse variabili di output basate sulle opzioni expression e mapValue:

expression	MapValue	variabili di output	comment
/\w+ (\w+)/	-	employee=Doe	Nessun valore MapValue fornito. La prima corrispondenza viene mappata alla variabile del nome di campo esistente ()employee.
/(\w+) (\w+)/	nome	name=John	La prima corrispondenza viene mappata su una nuova variabile chiamata. name
/(?\w+) (?\w+)/	-	firstName=John, lastName=Doe	Quando vengono utilizzati gruppi denominati, questi sono i nomi delle variabili di output e mapValue viene ignorato.
/(?\w+) (?\w+)/	nome	firstName=John, lastName=Doe	Come sopra