Konfigurasi korelasi

Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.

Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. Bekerja di Grafana versi 9

Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. Bekerja di Grafana versi 8

Setiap korelasi dikonfigurasi dengan opsi berikut:

Label

Label tautan, ditampilkan dalam visualisasi.

Deskripsi

Deskripsi opsional.

Sumber data sumber

Sumber hasil yang memiliki tautan yang ditampilkan.

Bidang hasil

Mendefinisikan di mana tautan ditampilkan dalam visualisasi.

Kueri target

Kueri target berjalan saat tautan diklik.

Transformasi

Manipulasi opsional ke data sumber yang disertakan diteruskan ke kueri target.

Untuk detail tentang membuat korelasi, lihat Membuat korelasi.

Sumber data sumber dan bidang hasil

Tautan ditampilkan di Jelajahi visualisasi untuk hasil dari sumber data sumber korelasi. Tautan ditetapkan ke salah satu bidang dari hasil yang disediakan dalam konfigurasi korelasi (bidang hasil). Setiap visualisasi menampilkan bidang dengan tautan dengan cara yang berbeda.

Kueri target

Kueri target dijalankan ketika tautan diklik dalam visualisasi. Anda dapat menggunakan editor kueri dari sumber data target yang dipilih untuk menentukan kueri target. Hasil data sumber dapat diakses di dalam kueri target dengan variabel.

Variabel Korelasi

Anda dapat menggunakan variabel di dalam kueri target untuk mengakses data sumber yang terkait dengan kueri. Korelasi menggunakan sintaks variabel Grafana. Variabel diisi dengan nilai-nilai dari hasil sumber ketika link dipilih. Ada dua jenis variabel yang dapat Anda gunakan:

• Variabel bidang (untuk mengakses nilai bidang dan label).

• Variabel korelasi (untuk mengakses nilai bidang dan transformasi).

Contoh: Jika hasil sumber berisi bidang yang disebutemployee, nilai bidang dapat diakses dengan:

• Variabel bidang${__data.fields.employee}.

• Variabel korelasi yang memetakan nilai bidang di atas ke${employee}.

Selain memetakan nilai bidang ke nama variabel yang lebih pendek, lebih banyak variabel korelasi dapat dibuat dengan menerapkan transformasi ke bidang yang ada.

Korelasi membuat tautan data hanya jika semua variabel memiliki nilai di baris data yang dipilih. Variabel global adalah pengecualian untuk aturan ini dan tidak perlu diisi dari data yang dikembalikan. Variabel-variabel ini diinterpolasi secara otomatis oleh sumber data.

Transformasi Korelasi

Transformasi menyediakan cara untuk mengekstrak lebih banyak variabel dari nilai bidang. Output transformasi adalah seperangkat variabel baru yang dapat diakses sebagai variabel lainnya.

Ada dua jenis transformasi: logfmt dan ekspresi reguler.

Setiap transformasi menggunakan nilai bidang yang dipilih sebagai input. Output dari transformasi adalah seperangkat variabel baru berdasarkan jenis dan opsi transformasi.

Transformasi Logfmt

Transformasi logfmt mendekonstruksi nilai bidang yang berisi teks yang diformat dengan pasangan kunci/nilai logfmt. Setiap pasangan menjadi variabel dengan kunci menjadi nama variabel.

Transformasi logfmt hanya memerlukan menentukan nama bidang input jika Anda ingin transformasi diterapkan ke bidang yang berbeda dari bidang hasil. Contoh variabel keluaran untukfield = "host=srv001 endpoint=/test app=foo":

name	nilai
host	srv001
titik akhir	/uji
aplikasi	foo

Transformasi ekspresi reguler

Transformasi ekspresi reguler mendekonstruksi nilai bidang berdasarkan ekspresi reguler yang disediakan.

Opsi transformasi ekspresi reguler:

lapangan

Nama bidang masukan

ekspresi

Ekspresi reguler. Grup tangkapan bernama dipetakan ke variabel yang cocok dengan nama grup. Jika grup pencocokan non-bernama digunakan variabel dibuat dari kecocokan pertama. Nilai mengesampingkan variabel yang cocok dengan bidang input atau variabel baru dibuat jika mapValue disediakan (lihat contoh dalam tabel berikut).

MapValue

Digunakan dengan grup regex sederhana tanpa grup pencocokan bernama. Secara default, kecocokan pertama mengganti variabel dengan nama bidang yang digunakan sebagai input. Untuk mengubah perilaku default itu, Anda dapat menentukan properti mapValue. Nama yang disediakan digunakan untuk membuat variabel baru. Ini dapat berguna jika kueri target Anda memerlukan nilai yang tepat dan bagian dari nilai yang diekstraksi dengan transformasi.

Contoh: Dengan asumsi nama bidang yang dipilih adalah employee dan nilai bidang adalahJohn Doe.

Berbagai variabel keluaran berdasarkan ekspresi dan opsi mapValue:

ekspresi	MapValue	variabel keluaran	komentar
/\w+ (\w+)/	-	employee=Doe	Tidak ada mapValue yang disediakan. Pencocokan pertama dipetakan ke variabel nama bidang yang ada (employee).
/(\w+) (\w+)/	name	name=John	Pencocokan pertama dipetakan ke variabel baru yang disebutname.
/(?\w+) (?\w+)/	-	firstName=John, lastName=Doe	Ketika grup bernama digunakan mereka adalah nama variabel output dan mapValue diabaikan.
/(?\w+) (?\w+)/	name	firstName=John, lastName=Doe	Sama seperti di atas