Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
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.
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 |
