Editor di correlazioni in Explore - Grafana gestito da Amazon
Creazione di una correlazioneTrasformazioniEsempi di correlazioni

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

Editor di correlazioni in Explore

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

Le correlazioni consentono agli utenti di creare un collegamento tra due fonti di dati qualsiasi. Per ulteriori informazioni, inclusa una panoramica delle correlazioni, vedere. Correlazioni nella versione 10 di Grafana

Creazione di una correlazione

Puoi creare correlazioni dalla pagina Esplora.

Per creare una correlazione

  1. Nel tuo spazio di lavoro Amazon Managed Grafana, vai alla pagina Esplora.

  2. Seleziona una fonte di dati che desideri utilizzare come fonte per una nuova correlazione.

  3. Esegui una query che produce dati in una visualizzazione supportata.

    Nota

    Le visualizzazioni supportate sono Logs e Table.

  4. Scegli + Aggiungi nella barra degli strumenti in alto e seleziona Aggiungi correlazione (puoi anche selezionare Correlations Editor dalla palette dei comandi).

    Esplora è ora in modalità Correlation Editor, indicata da un bordo blu e dalla barra superiore. Puoi uscire da Correlations Editor scegliendo Esci nella barra in alto.

  5. È ora possibile creare le seguenti nuove correlazioni per la visualizzazione con collegamenti allegati ai dati che è possibile utilizzare per creare una nuova query:

    • Registri: i collegamenti vengono visualizzati accanto ai valori dei campi all'interno dei dettagli del registro per ogni riga del registro.

    • Tabella: ogni cella della tabella è un collegamento.

  6. Scegli un link per aggiungere una nuova correlazione. I link sono associati a un campo che viene utilizzato come campo di risultato di una correlazione. Per ulteriori dettagli, consulta Configurazione della correlazione.

  7. Nella visualizzazione divisa che si apre, utilizza il riquadro destro per impostare l'origine della query di destinazione della correlazione. Per ulteriori dettagli, consulta Interrogazione target.

  8. Crea una query di destinazione utilizzando la sintassi delle variabili con le variabili dall'elenco fornito nella parte superiore del riquadro. L'elenco contiene valori di esempio dalla riga di dati selezionata.

  9. Fornisci un'etichetta e una descrizione (opzionale). Un'etichetta verrà utilizzata come nome del collegamento all'interno della visualizzazione e può contenere variabili.

  10. Fornisci trasformazioni (opzionale; vedi sotto per i dettagli).

  11. Scegli Salva nella barra degli strumenti in alto per salvare la correlazione e uscire dalla modalità Correlation Editor. Il collegamento utilizzato per creare la correlazione viene sostituito con un collegamento dati in ogni riga. Quando il link è selezionato, la query definita verrà eseguita in un altro riquadro, con le variabili sostituite dinamicamente con i valori della riga selezionata.

Trasformazioni

Le trasformazioni consentono di estrarre valori esistenti in un campo con altri dati. Ad esempio, utilizzando una trasformazione, è possibile estrarre una parte di una riga di registro da utilizzare in una correlazione. Per ulteriori dettagli sulle trasformazioni nelle correlazioni, vedere. Trasformazioni di correlazione

Dopo aver scelto uno dei link generati in modalità editor, puoi aggiungere trasformazioni selezionando Aggiungi trasformazione nel menu a discesa Trasformazioni.

Per utilizzare una trasformazione in una correlazione

  1. Seleziona un campo a cui applicare la trasformazione. Seleziona la parte del campo che desideri utilizzare per la trasformazione. Ad esempio, una riga di registro. Una volta selezionato, il valore di questo campo verrà utilizzato per aiutarti a creare la trasformazione.

  2. Seleziona il tipo di trasformazione. Vedi Trasformazioni di correlazione per le opzioni e le impostazioni pertinenti.

  3. In base alla selezione effettuata, è possibile che vengano inserite una o più variabili oppure potrebbe essere necessario fornire ulteriori specifiche nelle opzioni visualizzate.

  4. Seleziona Aggiungi trasformazione alla correlazione per aggiungere le variabili specificate all'elenco delle variabili disponibili.

Nota

Per le espressioni regolari in questa finestra di dialogo, viene richiamata Variable Name qui quella a mapValue cui si fa riferimento in altra documentazione. Grafana evidenzia qualsiasi testo che corrisponde all'espressione nel valore del campo. Usa i gruppi di acquisizione delle espressioni regolari per selezionare quale parte della corrispondenza deve essere estratta. Quando viene fornita un'espressione regolare valida, la variabile e il valore di quella variabile vengono visualizzati sotto il Variable Name campo.

Esempi di correlazioni

Gli esempi seguenti mostrano come creare correlazioni utilizzando l'editor di correlazioni in Explore. Se desideri seguire questi esempi, assicurati di configurare una fonte di dati di test.

Creazione di una correlazione testo-grafico

Questo esempio mostra come creare una correlazione utilizzando Correlations Editor in Explore.

Le correlazioni consentono di utilizzare i risultati di una query per eseguire una nuova query in qualsiasi fonte di dati. In questo esempio, eseguirai una query che esegue il rendering di dati tabulari. I dati verranno utilizzati per eseguire una query diversa che produce un risultato grafico.

Per seguire questo esempio, assicurati di aver impostato una fonte di dati di test.

Per creare una correlazione testo-grafico

  1. In Grafana, vai a Esplora.

  2. Seleziona la fonte dei dati di test dal menu a discesa in alto a sinistra della pagina.

  3. Scegli + Aggiungi nel menu a discesa a destra e seleziona Aggiungi correlazione.

  4. Esplora è ora in modalità Correlation Editor, indicata da un bordo blu.

  5. Seleziona lo scenario seguente dal menu a discesa dello scenario: File CSV.

  6. Seleziona il file, population_by_state.csv. Ogni cella è un collegamento su cui puoi fare clic per iniziare a creare una nuova correlazione.

  7. Fai clic su una cella qualsiasi della State colonna per creare una nuova correlazione che colleghi un collegamento dati a quella voce. Ad esempio, seleziona. California

  8. Nella vista divisa, seleziona la stessa fonte di dati selezionata nel riquadro a sinistra. L'helper sopra l'editor di query contiene tutte le variabili disponibili, è possibile utilizzare la query di destinazione. Le variabili contengono tutti i campi di dati (colonne della tabella) della riga selezionata.

  9. Nel menu Scenario, selezionate Valori metrici CSV. Il String Input campo nell'editor di Query fornisce variabili con valori di popolazione per ogni anno:. ${1980},${2000},${2020} Questo genererà un grafico utilizzando valori variabili.

  10. Nel campo Alias dell'editor di query, immettere${State}.

    Eseguite un'interrogazione per verificare che produca un grafico utilizzando i valori di esempio delle variabili.

  11. Scegliete Salva per salvare la correlazione e uscire dall'Editor delle correlazioni.

    Dopo aver salvato la correlazione, Explore eseguirà nuovamente la query nel riquadro di sinistra. Facendo clic sul nome di uno stato, la query a destra viene rieseguita con i valori della riga inserita nel file CSV, modificando così il grafico. La query viene rieseguita con valori aggiornati ogni volta che si fa clic sul nome di uno stato.

È possibile applicare gli stessi passaggi a qualsiasi fonte di dati. Le correlazioni consentono di creare collegamenti nelle visualizzazioni per eseguire query dinamiche basate su dati selezionati. In questo esempio abbiamo utilizzato i dati restituiti da una query per creare una nuova query che genera visualizzazioni diverse utilizzando la stessa fonte di dati. Tuttavia, puoi creare correlazioni tra qualsiasi fonte di dati per creare flussi di esplorazione personalizzati.

Creazione di una correlazione tra log e tabelle

In questo esempio, creerai una correlazione per dimostrare come utilizzare le trasformazioni per estrarre valori dalla riga di log e da un altro campo.

Per seguire questo esempio, assicurati di aver impostato una fonte di dati di test.

Per creare una correlazione tra log e tabella

  1. In Grafana, vai a Esplora.

  2. Seleziona la fonte dei dati di test dal menu a discesa in alto a sinistra della pagina.

  3. Scegli + Aggiungi nel menu a discesa a destra e seleziona Aggiungi correlazione.

  4. Esplora è ora in modalità Correlation Editor, indicata da un bordo blu.

  5. Nel menu Scenario, seleziona Registri.

  6. Espandi una riga di registro per visualizzare i link di correlazione. Seleziona Correlate with hostname.

  7. Esplora si apre in visualizzazione divisa. Seleziona la stessa fonte di dati selezionata nel riquadro a sinistra. L'helper sopra l'editor di query contiene tutte le variabili disponibili che puoi utilizzare nella query di destinazione.

  8. Espandi la sezione Trasformazioni e fai clic su Aggiungi trasformazione.

  9. Nel menu a discesa Campo, seleziona messaggio. La riga del registro viene visualizzata come dati di esempio.

  10. In Tipo, selezionate Logfmt. Questo compila l'elenco delle variabili.

  11. Scegli Aggiungi trasformazione alla correlazione.

  12. Scegli di nuovo Aggiungi trasformazione e in Campo, seleziona hostname.

  13. In Tipo, seleziona Espressione regolare.

  14. In Espressione, inserisci quanto segue:-([0-9]\*). Questo seleziona qualsiasi numero a destra del trattino.

  15. In Nome variabile, inserisci quanto segue:. hostNumber Questo compila l'elenco delle variabili.

  16. Scegli Aggiungi trasformazione alla correlazione per aggiungerla alle altre variabili.

  17. Nell'editor delle sorgenti dati, apri il menu a discesa Scenario e seleziona Contenuto CSV.

  18. Nella casella di testo sottostante, fornisci quanto segue e salva la correlazione:

    time,msg,hostNumber,status
${time},${msg},${hostNumber},${status}

    Questo chiude la vista divisa e riesegue la query a sinistra. Espandi qualsiasi riga di registro per visualizzare il pulsante di correlazione. Scegliendo il pulsante di correlazione si apre la visualizzazione divisa con time (un campo), msg (estratto con logfmt dalla riga di registro), host number (estratto con regex da) e (estratto con logfmt dalla riga di registrohostname). status