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