Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Korelasi dalam Grafana versi 10
<a name="v10-correlations"></a>

****  
**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](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Anda dapat membuat tautan interaktif untuk visualisasi Jelajahi untuk menjalankan kueri yang terkait dengan data yang disajikan dengan menyiapkan Korelasi.

Korelasi mendefinisikan bagaimana data dalam satu sumber data digunakan untuk kueri data di sumber data lain. Beberapa contoh:
+ Nama aplikasi yang dikembalikan dalam sumber data log dapat digunakan untuk menanyakan metrik yang terkait dengan aplikasi tersebut dalam sumber data metrik.
+ Nama pengguna yang dikembalikan oleh sumber data SQL dapat digunakan untuk menanyakan log yang terkait dengan pengguna tertentu dalam sumber data log.

Jelajahi mengambil korelasi yang ditentukan pengguna untuk menampilkan tautan di dalam visualisasi. Anda dapat mengklik tautan untuk menjalankan kueri terkait dan melihat hasilnya di Jelajahi Tampilan Split.

Jelajahi visualisasi yang saat ini mendukung menampilkan tautan berdasarkan korelasi:
+ [Beberapa catatan](v10-panels-logs.md)
+ [Tabel](v10-panels-table.md)

[Anda dapat mengonfigurasi korelasi menggunakan halaman **Administrasi > Plugin dan data > Korelasi** di Grafana atau langsung di Jelajahi.](v10-explore-correlations.md)

**Topics**
+ [Konfigurasi korelasi](v10-correlations-config.md)
+ [Buat korelasi baru](v10-correlations-create.md)

# Konfigurasi korelasi
<a name="v10-correlations-config"></a>

****  
**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](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

 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](v10-correlations-create.md).

## Sumber data sumber dan bidang hasil
<a name="v10-correlations-config-source-and-result"></a>

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
<a name="v10-correlations-config-target-query"></a>

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
<a name="v10-correlations-config-variables"></a>

Anda dapat menggunakan variabel di dalam kueri target untuk mengakses data sumber yang terkait dengan kueri. Korelasi menggunakan sintaks [variabel Grafana](v10-dash-variable-syntax.md). Variabel diisi dengan nilai-nilai dari hasil sumber ketika link dipilih. Ada dua jenis variabel yang dapat Anda gunakan:
+ [Variabel bidang](v10-panels-configure-data-links.md#v10-panels-data-link-variables) (untuk mengakses nilai bidang dan label).
+ Variabel korelasi (untuk mengakses nilai bidang dan transformasi).

Contoh: Jika hasil sumber berisi bidang yang disebut`employee`, 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](v10-dash-variable-add.md#v10-dash-variable-add-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
<a name="v10-correlations-config-transformations"></a>

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
<a name="v10-correlations-config-logfmt-transformation"></a>

[Transformasi logfmt mendekonstruksi nilai bidang yang berisi teks yang diformat dengan pasangan kunci/nilai logfmt.](https://brandur.org/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 untuk`field = "host=srv001 endpoint=/test app=foo"`:


| name | nilai | 
| --- | --- | 
| host | srv001 | 
| titik akhir | /uji | 
| aplikasi | foo | 

### Transformasi ekspresi reguler
<a name="v10-correlations-config-regular-expression-transformation"></a>

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 adalah`John Doe`.

Berbagai variabel keluaran berdasarkan ekspresi dan opsi mapValue:


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

# Buat korelasi baru
<a name="v10-correlations-create"></a>

****  
**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](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Anda dapat membuat korelasi di editor Jelajahi korelasi, atau menggunakan halaman **Administrasi** Grafana di ruang kerja Grafana Terkelola Amazon.

**Prasyarat**

Anda harus memiliki izin untuk menambahkan korelasi baru. Hanya pengguna dengan izin menulis ke sumber data yang dapat menentukan korelasi baru.

## Membuat korelasi di editor korelasi Explore
<a name="v10-correlations-create-explore"></a>

Anda dapat membuat korelasi di editor korelasi Jelajahi. Untuk detail selengkapnya, lihat [Menciptakan korelasi](v10-explore-correlations.md#v10-explore-corr-create-a-correlation).

## Membuat korelasi di halaman Administrasi
<a name="v10-correlations-create-administration"></a>

Anda dapat menggunakan halaman **Administrasi** konsol Grafana untuk membuat korelasi.

**Untuk membuat korelasi di halaman Administrasi**

1. Buka bagian **Administrasi** di Grafana.

1. Di bawah **Plugin dan data**, buka halaman **Korelasi**.

1. Pilih tombol **Tambah** di sudut kanan atas.

1. Berikan **label** untuk korelasi.

1. (Opsional) Berikan **deskripsi**.

1. Pergi ke halaman berikutnya.

1. Menyediakan **sumber data target**.

1. Berikan **kueri target** menggunakan variabel.

1. Pergi ke halaman berikutnya.

1. Menyediakan **sumber sumber data**.

1. Berikan **bidang hasil**.

1. Tambahkan transformasi jika Anda membutuhkan variabel yang bukan bidang di sumber data sumber.

1. Pilih **Tambah** untuk menambahkan transformasi baru.

1. Pilih jenis transformasi.

1. Konfigurasikan transformasi tergantung pada jenis yang dipilih.

1. Simpan korelasinya.

Anda dapat mengedit korelasi dengan cara yang sama, tetapi saat mengedit, Anda tidak dapat mengubah sumber data yang dipilih.