

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

# Bekerja di Grafana versi 10
<a name="using-grafana-v10"></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)

Saat Anda membuat ruang kerja Grafana, Anda memiliki opsi versi Grafana mana yang akan digunakan. Topik berikut menjelaskan penggunaan ruang kerja Grafana yang menggunakan Grafana versi 10.

**Topics**
+ [Dasbor di Grafana versi 10](v10-dashboards.md)
+ [Panel dan visualisasi dalam Grafana versi 10](v10-panels.md)
+ [Jelajahi di Grafana versi 10](v10-explore.md)
+ [Korelasi dalam Grafana versi 10](v10-correlations.md)
+ [Peringatan di Grafana versi 10](v10-alerts.md)

# Dasbor di Grafana versi 10
<a name="v10-dashboards"></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)

 Dasbor adalah satu set dari satu atau lebih [panel](v10-panels.md) yang diatur dan disusun menjadi satu atau lebih baris. Grafana dikirimkan dengan berbagai panel sehingga mudah untuk membuat kueri yang tepat, dan menyesuaikan visualisasi sehingga Anda dapat membuat dasbor yang sempurna untuk kebutuhan Anda. Setiap panel dapat berinteraksi dengan data dari apa pun yang dikonfigurasi[Connect ke sumber data](AMG-data-sources.md). 

 Snapshot dasbor bersifat statis. Kueri dan ekspresi tidak dapat dieksekusi ulang dari snapshot. Akibatnya, jika Anda memperbarui variabel apa pun dalam kueri atau ekspresi Anda, itu tidak akan mengubah data dasbor Anda. 

**Topics**
+ [Menggunakan dasbor](v10-dash-using-dashboards.md)
+ [Membangun dasbor](v10-dash-building-dashboards.md)
+ [Mengelola dasbor](v10-dash-managing-dashboards.md)
+ [Mengelola daftar putar](v10-dash-managing-playlists.md)
+ [Berbagi dasbor dan panel](v10-dash-sharing.md)
+ [Variabel](v10-dash-variables.md)
+ [Menilai penggunaan dasbor](v10-dash-assess-dashboard-usage.md)
+ [Memecahkan masalah dasbor](v10-dash-troubleshoot.md)
+ [Mencari Dasbor di Grafana versi 10](v10-search.md)

# Menggunakan dasbor
<a name="v10-dash-using-dashboards"></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)

Topik ini memberikan ikhtisar fitur dasbor dan pintasan, dan menjelaskan cara menggunakan pencarian dasbor.

## Fitur
<a name="v10-dash-features"></a>

Anda dapat menggunakan dasbor untuk menyesuaikan presentasi data Anda. Gambar berikut menunjukkan antarmuka dasbor di ruang kerja Grafana yang Dikelola Amazon.

![\[Gambar yang menunjukkan antarmuka untuk dasbor di ruang kerja Grafana yang Dikelola Amazon, dengan sorotan untuk tombol untuk berbagai fitur.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/AMG-dashboard-overview-v10.png)



|  Fitur  |  Deskripsi  | 
| --- | --- | 
| **1. Rumah** | Pilih ikon beranda Grafana yang akan diarahkan ke halaman beranda yang dikonfigurasi dalam instance Grafana. | 
| **2. Judul** | Saat Anda memilih judul dasbor, Anda dapat mencari dasbor yang terdapat di folder saat ini. | 
| **3. Berbagi dasbor** | Gunakan opsi ini untuk membagikan dasbor saat ini dengan tautan atau snapshot. Anda juga dapat mengekspor definisi dasbor dari modal saham. | 
| **4. Menambahkan panel baru** | Gunakan opsi ini untuk menambahkan panel, baris dasbor, atau panel perpustakaan ke dasbor saat ini. | 
| **5. Simpan dasbor** | Pilih ikon Simpan untuk menyimpan perubahan ke dasbor Anda. | 
| **6. Wawasan dasbor** | Pilih untuk melihat analitik tentang dasbor Anda, termasuk informasi tentang pengguna, aktivitas, dan jumlah kueri. Untuk informasi selengkapnya, lihat [Menilai penggunaan dasbor](v10-dash-assess-dashboard-usage.md). | 
| **7. Pengaturan dasbor** | Gunakan opsi ini untuk mengubah nama dasbor, folder, atau tag dan mengelola variabel dan kueri anotasi. Untuk informasi selengkapnya tentang setelan dasbor, lihat[Memodifikasi pengaturan dasbor](v10-dash-modify-settings.md). | 
| **8. Dropdown pemilih waktu** |  Gunakan untuk memilih opsi rentang waktu relatif dan mengatur rentang waktu absolut kustom. Anda dapat mengubah pengaturan **Zona waktu** dan **tahun fiskal** dari kontrol rentang waktu dengan mengklik **Ubah pengaturan waktu** tombol. Pengaturan waktu disimpan berdasarkan per dasbor.  | 
| **9. Memperkecil rentang waktu** |  Gunakan untuk memperkecil rentang waktu. Untuk informasi selengkapnya tentang cara menggunakan kontrol rentang waktu, lihat[Pengaturan rentang waktu dasbor](#v10-dash-setting-dashboard-time-range).  | 
| **10. Segarkan dasbor** | Pilih untuk segera memicu kueri dan menyegarkan data dasbor. | 
| **11. Segarkan interval waktu dasbor** | Pilih interval waktu penyegaran otomatis dasbor. | 
| **12. Mode tampilan**  | Pilih untuk menampilkan dasbor di layar besar seperti TV atau kios. Mode tampilan menyembunyikan informasi yang tidak relevan seperti menu navigasi.  | 
| **13. Panel dasbor** |  Blok bangunan utama dasbor adalah panel. Untuk menambahkan panel baru, baris dasbor, atau panel perpustakaan, pilih **Tambah panel**. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/v10-dash-using-dashboards.html)  | 
| **14. Legenda grafik** | Ubah warna seri, sumbu y, dan visibilitas seri langsung dari legenda. | 
| **15. Baris dasbor** | Baris dasbor adalah pembagi logis dalam dasbor yang mengelompokkan panel bersama-sama. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/v10-dash-using-dashboards.html)  | 

## Pintasan keyboard
<a name="v10-dash-keyboard-shortcuts"></a>

Grafana memiliki sejumlah pintasan keyboard yang tersedia. **Untuk menampilkan semua pintasan keyboard yang tersedia untuk Anda, tekan?** atau **h** pada keyboard Anda.
+ `Ctrl+S`menyimpan dasbor saat ini. 
+ `f`membuka pencari dasbor/pencarian. 
+  `d+k`beralih mode kios (menyembunyikan menu). 
+ `d+e`memperluas semua baris. 
+ `d+s`membuka pengaturan dasbor. 
+ `Ctrl+K`membuka palet perintah.
+ `Esc`keluar dari panel saat dalam tampilan layar penuh atau mode edit. Juga mengembalikan Anda ke dasbor dari pengaturan dasbor.

**Panel terfokus**

Untuk menggunakan pintasan yang menargetkan panel tertentu, arahkan kursor ke panel dengan penunjuk Anda.
+ `e`beralih tampilan edit panel 
+ `v`beralih tampilan layar penuh panel 
+ `ps`membuka fitur berbagi panel 
+ `pd`panel duplikat 
+ `pr`menghapus panel 
+ `pl`beralih legenda panel 

## Pengaturan rentang waktu dasbor
<a name="v10-dash-setting-dashboard-time-range"></a>

Grafana menyediakan beberapa cara untuk mengelola rentang waktu data yang divisualisasikan, untuk dasbor, panel dan juga untuk peringatan.

Bagian ini menjelaskan unit waktu dan rentang relatif yang didukung, kontrol waktu umum, pengaturan waktu di seluruh dasbor, dan pengaturan waktu khusus panel.

**Satuan waktu dan rentang relatif**

Grafana mendukung satuan waktu berikut:`s (seconds)`,,`m (minutes)`,`h (hours)`,`d (days)`, `w (weeks)` `M (months)``Q (quarters)`, dan. `y (years)` 

Operator minus memungkinkan Anda untuk mundur dalam waktu, relatif terhadap tanggal dan waktu saat ini, atau`now`. Jika Anda ingin menampilkan periode penuh unit (hari, minggu, atau bulan), tambahkan `/<time unit>` ke akhir. Untuk melihat periode fiskal, penggunaan `fQ (fiscal quarter)` dan satuan `fy (fiscal year)` waktu.

Operator plus memungkinkan Anda untuk melangkah maju dalam waktu, relatif terhadap sekarang. Misalnya, Anda dapat menggunakan fitur ini untuk melihat data yang diprediksi di masa mendatang.

Tabel berikut memberikan contoh rentang relatif.


| Contoh rentang relatif | Dari | Ke | 
| --- | --- | --- | 
| 5 menit terakhir |  `now-5m`  |  `now`  | 
| Hari sejauh ini |  `now/d`  |  `now`  | 
| Minggu ini |  `now/w`  |  `now/w`  | 
| Minggu ini sejauh ini |  `now/w`  |  `now`  | 
| Bulan ini |  `now/M`  |  `now/M`  | 
| Bulan ini sejauh ini |  `now/M`  |  `now`  | 
| Bulan Sebelumnya |  `now-1M/M`  |  `now-1M/M`  | 
| Tahun ini sejauh ini |  `now/Y`  |  `now`  | 
| Tahun ini |  `now/Y`  |  `now/Y`  | 
| Tahun fiskal sebelumnya |  `now-1y/fy`  |  `now-1y/fy`  | 

**catatan**  
 Grafana Alerting tidak mendukung sintaks berikut:  
`now+n`untuk stempel waktu masa depan.
`now-1n/n`untuk *awal n sampai akhir n*, karena ini adalah stempel waktu absolut.

**Kontrol rentang waktu umum**

Kontrol waktu dasbor dan panel memiliki antarmuka pengguna yang umum. Berikut ini menjelaskan kontrol rentang waktu umum.
+ Rentang waktu saat ini, juga disebut *pemilih waktu*, menunjukkan rentang waktu yang saat ini ditampilkan di dasbor atau panel yang Anda lihat. Arahkan kursor ke lapangan untuk melihat stempel waktu yang tepat dalam rentang dan sumbernya (seperti waktu browser lokal). Klik *rentang waktu saat ini* untuk mengubahnya. Anda dapat mengubah waktu saat ini menggunakan *rentang waktu relatif*, seperti 15 menit terakhir, atau rentang waktu absolut, seperti `2020-05-14 00:00:00` untuk`2020-05-15 23:59:59`.
+ **Rentang waktu relatif** dapat dipilih dari daftar **rentang waktu relatif**. Anda dapat memfilter daftar menggunakan bidang input di bagian atas. Beberapa contoh rentang waktu termasuk *30 menit terakhir*, *12 jam terakhir*, *7 hari terakhir*, *2 tahun terakhir*, *Kemarin*, *Hari sebelum kemarin*, *Hari ini minggu lalu*, *Hari ini sejauh* *ini, Minggu ini sejauh* ini, dan *Bulan ini sejauh* ini.
+ **Rentang waktu absolut** dapat diatur dalam dua cara: Mengetik nilai waktu yang tepat atau nilai waktu relatif ke dalam bidang **Dari** dan **Ke** dan mengklik **Terapkan rentang waktu**, atau mengklik rentang tanggal atau tanggal dari kalender yang ditampilkan saat Anda mengklik **Dari** atau **Ke** bidang. Untuk menerapkan pilihan Anda, klik **Terapkan rentang waktu**. Anda juga dapat memilih dari daftar rentang waktu absolut yang baru-baru ini digunakan.
+ **Rentang waktu semi-relatif** dapat dipilih dalam pengaturan rentang waktu absolut. Misalnya, untuk menampilkan aktivitas sejak tanggal tertentu, Anda dapat memilih waktu absolut untuk waktu mulai, dan waktu relatif (seperti`now`) untuk waktu akhir.

  Menggunakan rentang waktu semi-relatif, seiring berjalannya waktu, dasbor Anda akan secara otomatis dan progresif memperkecil untuk menampilkan lebih banyak riwayat dan lebih sedikit detail. Pada tingkat yang sama, karena resolusi data yang tinggi menurun, tren historis selama seluruh periode waktu akan menjadi lebih jelas.
**catatan**  
Peringatan tidak mendukung rentang waktu semi-relatif.
+ **Perkecil** dengan memilih ikon zoom out (atau dengan menggunakan Cmd\$1Z atau Ctrl\$1Z sebagai pintasan keyboard). Ini meningkatkan tampilan, menunjukkan rentang waktu yang lebih besar di dasbor atau visualisasi panel.
+ **Perbesar** dengan memilih rentang waktu yang ingin Anda lihat pada grafik dalam visualisasi.
**catatan**  
Zoom in hanya berlaku untuk visualisasi grafik. 

**Segarkan dasbor**

Klik ikon **Segarkan dasbor** untuk segera menjalankan setiap kueri di dasbor dan menyegarkan visualisasi. Grafana membatalkan permintaan yang tertunda saat Anda memicu penyegaran.

Secara default, Grafana tidak secara otomatis menyegarkan dasbor. Kueri berjalan sesuai jadwal mereka sendiri sesuai dengan pengaturan panel. Namun, jika Anda ingin menyegarkan dasbor secara teratur, klik panah bawah di sebelah ikon **Refresh dashboard** dan kemudian pilih interval penyegaran.

**Kontrol rentang waktu menggunakan URL**

Anda dapat mengontrol rentang waktu dasbor dengan memberikan parameter kueri berikut di URL dasbor.
+ `from`mendefinisikan batas bawah rentang waktu, yang ditentukan dalam epoch ms, atau waktu [relatif](#v10-dash-setting-dashboard-time-range).
+ `to`mendefinisikan batas atas rentang waktu, yang ditentukan dalam zaman ms, atau waktu relatif.
+ `time`dan `time.window` mendefinisikan rentang waktu dari `time-time.window/2` ke`time+time.window/2`. Kedua parameter harus ditentukan dalam ms. Misalnya `?time=1500000000000&time.window=10000` menghasilkan rentang waktu 10 detik dari 1499999995000 hingga 1500000005000.

# Membangun dasbor
<a name="v10-dash-building-dashboards"></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)

Setelah Anda membuat ruang kerja Grafana dan masuk, Anda dapat membuat dasbor dan memodifikasi pengaturan agar sesuai dengan kebutuhan Anda. Dasbor terdiri dari [panel dengan visualisasi](v10-panels-viz.md). Setiap panel memiliki kueri yang terkait dengannya, untuk menarik data dari salah satu Anda[Connect ke sumber data](AMG-data-sources.md).

Anda dapat membuat dasbor yang lebih interaktif dan dinamis dengan menambahkan dan menggunakan [variabel](v10-dash-variables.md). Alih-alih hard-coding server, aplikasi, atau nama lain dalam kueri metrik Anda, Anda dapat menggunakan variabel di tempatnya.

**Topics**
+ [Membuat dasbor](v10-dash-creating.md)
+ [Mengimpor dasbor](v10-dash-importing.md)
+ [Mengekspor dasbor](v10-dash-exporting.md)
+ [Memodifikasi pengaturan dasbor](v10-dash-modify-settings.md)
+ [Variabel URL dasbor](v10-dash-dashboard-url-variables.md)
+ [Mengelola panel perpustakaan](v10-dash-manage-library-panels.md)
+ [Mengelola riwayat versi dasbor](v10-dash-manage-version-history.md)
+ [Mengelola tautan dasbor](v10-dash-manage-dashboard-links.md)
+ [Visualisasi anotasi](v10-dash-annotations.md)
+ [Model Dashboard JSON](v10-dash-dashboard-json-model.md)
+ [Praktik terbaik untuk dasbor](v10-dash-bestpractices.md)

# Membuat dasbor
<a name="v10-dash-creating"></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)

**Membuat dasbor**

Dasbor dan panel memungkinkan Anda menampilkan data Anda dalam bentuk visual menggunakan Grafana. Setiap panel membutuhkan setidaknya satu kueri untuk menampilkan visualisasi. Sebelum Anda memulai, selesaikan prasyarat berikut.
+ Pastikan Anda memiliki izin yang tepat. Untuk informasi selengkapnya tentang izin, lihat [Pengguna, tim, dan izin](Grafana-administration-authorization.md).
+ Identifikasi dasbor yang ingin Anda tambahkan panel.
+ Memahami bahasa kueri dari sumber data target.
+ Pastikan bahwa sumber data yang Anda tulis kueri telah ditambahkan. Untuk informasi selengkapnya, lihat [Connect ke sumber data](AMG-data-sources.md).

 Untuk membuat dasbor:

1. Masuk ke Grafana, dan pilih **Dasbor dari menu** kiri.

1. Pilih **Baru**, lalu **Dasbor baru**.

1. Di dasbor kosong, pilih **\$1 Tambahkan visualisasi**. Ini membuka kotak dialog visualisasi baru.

1. Pilih sumber data. Anda dapat memilih sumber data yang ada, salah satu sumber data bawaan Grafana untuk pengujian, atau memilih **Konfigurasi sumber data baru** untuk menyiapkan yang baru (hanya pengguna dengan izin Admin yang dapat mengonfigurasi sumber data baru).

   Tampilan **panel Edit** terbuka, dengan sumber data Anda dipilih. Anda dapat mengubah sumber data untuk panel nanti, menggunakan tab **Query** dari editor panel, jika diperlukan.

1. Tulis atau buat kueri dalam bahasa kueri sumber data Anda. Pilih ikon segarkan dasbor untuk melakukan kueri pada sumber data, melihat hasilnya saat Anda pergi.

1. Dalam daftar **Visualisasi**, pilih jenis visualisasi. Grafana menampilkan pratinjau hasil kueri Anda dengan visualisasi yang diterapkan. Untuk informasi selengkapnya, lihat [Opsi visualisasi](v10-panels-viz.md).

1. Di bawah **opsi Panel**, Anda dapat memasukkan judul dan deskripsi untuk panel Anda. 

1. Sebagian besar visualisasi memerlukan beberapa penyesuaian sebelum mereka menampilkan informasi yang tepat yang Anda butuhkan. Anda dapat menyesuaikan pengaturan panel dengan cara berikut.
   + [Konfigurasikan pemetaan nilai](v10-panels-configure-value-mappings.md)
   + [Opsi khusus visualisasi](v10-panels-viz.md)
   + [Ganti nilai bidang](v10-panels-configure-overrides.md)
   + [Konfigurasikan ambang batas](v10-panels-configure-thresholds.md)
   + [Konfigurasikan opsi standar](v10-panels-configure-standard-options.md)

1. Setelah selesai mengonfigurasi panel, pilih **Simpan untuk menyimpan** dasbor.

   Atau, pilih **Terapkan** untuk melihat perubahan tanpa meninggalkan editor panel.

1. Tambahkan catatan untuk menggambarkan visualisasi (atau jelaskan perubahan Anda) dan kemudian klik **Simpan** di sudut kanan atas halaman.
**catatan**  
Catatan sangat membantu jika Anda perlu mengembalikan dasbor ke versi sebelumnya.

1. Pilih **Simpan**.

1. Secara opsional, Anda dapat menambahkan lebih banyak panel ke dasbor dengan memilih **Tambahkan** di header dasbor, dan memilih **Visualisasi dari drop-down**.

**Menyalin dasbor yang ada**

Anda dapat dengan cepat menyalin dasbor yang ada, untuk memulai membuat yang baru.

**Untuk menyalin dasbor yang ada**

1. Pilih **Dasbor** dari menu kiri.

1. Pilih dasbor yang ingin Anda salin, untuk membukanya.

1. Pilih **Pengaturan** (ikon roda gigi) di kanan atas dasbor.

1. Pilih **Simpan seperti** di sudut kanan atas dasbor.

1. (Opsional) Tentukan nama, folder, deskripsi, dan apakah akan menyalin tag dasbor asli untuk dasbor yang disalin atau tidak.

1. Pilih **Simpan**.

**Mengkonfigurasi baris berulang**

Anda dapat mengonfigurasi Grafana untuk menambahkan panel atau baris secara dinamis ke dasbor berdasarkan nilai variabel. Variabel secara dinamis mengubah kueri Anda di semua baris di dasbor. Untuk informasi selengkapnya tentang panel berulang, lihat [Mengonfigurasi panel berulang.]()

Anda juga dapat mengulang baris jika Anda memiliki variabel yang ditetapkan dengan `Multi-value` atau `Include all values` dipilih.

Sebelum Anda memulai, pastikan bahwa kueri menyertakan variabel multi-nilai, maka Anda harus menyelesaikan langkah-langkah berikut.

**Untuk mengkonfigurasi baris berulang**

1. Pilih **Dasbor** dari menu kiri, lalu pilih dasbor yang ingin Anda ubah.

1. Di bagian atas dasbor, pilih **Tambah**, lalu pilih **Baris** dari drop-down.

   Jika dasbor kosong, Anda dapat secara bergantian memilih tombol **\$1 Tambahkan baris** di tengah dasbor.

1. Arahkan kursor ke judul baris dan pilih ikon **Pengaturan** (roda gigi) yang muncul.

1. Pada kotak dialog **Opsi Baris**, tambahkan judul dan pilih variabel yang ingin Anda tambahkan baris berulang.
**catatan**  
 Untuk memberikan konteks kepada pengguna dasbor, tambahkan variabel ke judul baris. 

1. Pilih **Perbarui**.

**Baris berulang dan sumber data khusus Dasbor**

Jika baris menyertakan panel menggunakan sumber data [Dasbor](AMG-data-sources.md#AMG-data-sources-special) khusus—sumber data yang menggunakan kumpulan hasil dari panel lain di dasbor smae—maka panel yang sesuai dalam baris berulang akan mereferensikan panel di baris asli, bukan yang ada di baris berulang.

Misalnya, di dasbor:
+ `Row 1`termasuk `Panel 1A` dan`Panel 1B`.
+ `Panel 1B`menggunakan hasil dari `Panel 1A` dengan menggunakan sumber `Dashboard` data.
+ Pengulangan `Row 2` termasuk `Panel 2A` dan`Panel 2B`.
+ `Panel 2B`Referensi`Panel 1A`, tidak`Panel 2A`.

**Untuk memindahkan panel**

1. Buka dasbor.

1. Pilih judul panel dan seret panel ke lokasi baru. Anda dapat menempatkan panel di dasbor di lokasi mana pun.

**Untuk mengubah ukuran panel**

1. Buka dasbor.

1. Untuk menyesuaikan ukuran panel, seret sudut kanan bawah panel. Anda dapat mengukur panel dasbor sesuai dengan kebutuhan Anda.

# Mengimpor dasbor
<a name="v10-dash-importing"></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 mengimpor dasbor yang telah dikonfigurasi sebelumnya ke ruang kerja Grafana yang Dikelola Amazon.

**Untuk mengimpor dasbor**

1. Masuk ke ruang kerja Grafana Terkelola Amazon Anda.

1. Pilih **Dasbor** dari menu kiri.

1. Pilih **Baru** dan pilih **Impor** di menu tarik-turun.

1. Selanjutnya Anda harus memilih definisi JSON dasbor untuk diimpor. Anda memiliki tiga pilihan untuk cara mengimpor JSON:
   + Unggah file yang berisi dashboard JSON.
   + Langsung salin teks JSON ke area teks.
   + Tempelkan URL atau ID dasbor Grafana Labs ke bidang. Untuk informasi lebih lanjut tentang dasbor grafana.com URLs, lihat bagian selanjutnya.
   + (Opsional) Ubah detail dasbor yang ingin Anda ubah.
   + Pilih sumber data, jika diperlukan.
   + Pilih **Impor**.
   + Simpan dasbor.

## Menemukan dasbor di grafana.com
<a name="v10-dash-import-from-grafana"></a>

Halaman [Dasbor](https://grafana.com/grafana/dashboards/) di grafana.com memberi Anda dasbor untuk aplikasi server umum. Jelajahi pustaka dasbor resmi dan yang dibangun oleh komunitas dan impor untuk memulai dan menjalankan dengan cepat.

**catatan**  
Untuk mengimpor dasbor dari grafana.com, ruang kerja Grafana yang Dikelola Amazon Anda harus memiliki akses ke internet.

# Mengekspor dasbor
<a name="v10-dash-exporting"></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 menggunakan Grafana UI atau HTTP API untuk mengekspor dasbor.

Tindakan ekspor dasbor membuat file Grafana JSON yang berisi semua yang Anda butuhkan, termasuk tata letak, variabel, gaya, sumber data, kueri, dan sebagainya, sehingga Anda nantinya dapat mengimpor dasbor.

**Membuat dasbor portabel**

Jika Anda ingin mengekspor dasbor untuk digunakan orang lain, Anda dapat menambahkan variabel template untuk hal-hal seperti awalan metrik (gunakan variabel konstan) dan nama server.

Variabel template dari jenis ini `Constant` akan secara otomatis disembunyikan di dasbor, dan juga akan ditambahkan sebagai input yang diperlukan saat dasbor diimpor.

**Untuk mengekspor dasbor**

1. Buka dasbor yang ingin Anda ekspor.

1. Pilih ikon bagikan.

1. Pilih **Ekspor**.

1. Pilih **Simpan ke file.**

**catatan**  
Grafana mengunduh file JSON ke mesin lokal Anda. 

# Memodifikasi pengaturan dasbor
<a name="v10-dash-modify-settings"></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)

Halaman pengaturan dasbor memungkinkan Anda untuk:
+ Edit properti dasbor umum, termasuk pengaturan waktu.
+ Tambahkan kueri anotasi.
+ Tambahkan variabel dasbor.
+ Tambahkan tautan.
+ Lihat model JSON dasbor

**Untuk mengakses halaman pengaturan dasbor**

1. Buka dasbor dalam mode edit.

1. Klik **Pengaturan dasbor** (ikon roda gigi) yang terletak di bagian atas halaman.

**Memodifikasi pengaturan waktu dasbor**

Sesuaikan pengaturan waktu dasbor saat Anda ingin mengubah zona waktu dasbor, waktu browser lokal, dan tentukan interval waktu penyegaran otomatis.

**Untuk mengubah pengaturan waktu dasbor**

1. Pada halaman Pengaturan **dasbor**, pilih **Umum**.

1. Arahkan ke bagian **Opsi Waktu**.

1. Tentukan pengaturan waktu sesuai dengan deskripsi berikut.

1. 
   + **Timezone** — Tentukan zona waktu lokal layanan atau sistem yang Anda pantau. Ini dapat membantu ketika memantau sistem atau layanan yang beroperasi di beberapa zona waktu.
     + **Default** — Grafana menggunakan zona waktu default yang dipilih untuk profil pengguna, tim, atau organisasi. Jika tidak ada zona waktu yang ditentukan untuk profil pengguna, tim yang menjadi anggota pengguna, atau organisasi, maka Grafana menggunakan waktu browser lokal.
     + **Waktu browser lokal** — Zona waktu yang dikonfigurasi untuk browser pengguna tampilan digunakan. Ini biasanya zona waktu yang sama seperti yang diatur di komputer.
     + Gunakan [zona waktu standar ISO 8601](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones), termasuk UTC.
   + **Penyegaran otomatis** - Sesuaikan opsi yang ditampilkan untuk waktu relatif dan opsi penyegaran otomatis. Entri dipisahkan koma dan menerima satuan waktu yang valid.
   + **Sekarang tunda** — Ganti `now` waktu dengan memasukkan waktu tunda. Gunakan opsi ini untuk mengakomodasi penundaan yang diketahui dalam agregasi data untuk menghindari nilai nol.
   + **Sembunyikan pemilih waktu** - Memilih opsi ini jika Anda tidak ingin dasbor menampilkan pemilih waktu.

**catatan**  
Untuk memiliki kontrol waktu, data Anda harus menyertakan kolom waktu. Lihat dokumentasi untuk [sumber data](AMG-data-sources.md) spesifik Anda untuk informasi selengkapnya tentang menyertakan kolom waktu.

**Menambahkan kueri anotasi**

Kueri anotasi adalah kueri yang menanyakan peristiwa. Peristiwa ini dapat divisualisasikan dalam grafik di dasbor sebagai garis vertikal bersama dengan ikon kecil yang dapat Anda arahkan kursor untuk melihat informasi acara.

**Untuk menambahkan kueri anotasi**

1. Pada halaman **Pengaturan dasbor**, pilih **Anotasi**.

1. Pilih **Tambahkan kueri anotasi**. 

1. Masukkan nama dan pilih sumber data.

1. Lengkapi sisa formulir untuk membuat kueri dan anotasi.

UI editor kueri berubah berdasarkan sumber data yang Anda pilih. lihat dokumentasi [sumber data](AMG-data-sources.md) untuk detail tentang cara membuat kueri. Atau, untuk plugin sumber data yang Anda instal dari[Temukan plugin dengan katalog plugin](grafana-plugins.md#plugin-catalog), Anda dapat menggunakan [dokumentasi di situs web Grafana Labs](https://grafana.com/docs/grafana/v10.3/datasources/).

**Menambahkan variabel**

Variabel memungkinkan Anda membuat dasbor yang lebih interaktif dan dinamis. Alih-alih hard-coding hal-hal seperti server, aplikasi, dan nama sensor dalam kueri metrik Anda, Anda dapat menggunakan variabel di tempatnya. Variabel ditampilkan sebagai daftar dropdown di bagian atas dasbor. Dropdown ini memudahkan untuk mengubah data yang ditampilkan di dasbor Anda.

Untuk informasi selengkapnya tentang variabel, lihat [Variabel](v10-dash-variables.md).

**Untuk menambahkan variabel**

1. Pada halaman **pengaturan Dasbor**, klik **Variabel** di menu bagian sisi kiri dan kemudian tombol **Tambahkan variabel**.

1. Di bagian **Umum**, tambahkan nama variabel. Ini adalah nama yang nantinya akan Anda gunakan dalam kueri.

1. Pilih variabel **Type**.
**catatan**  
Jenis variabel yang Anda pilih memengaruhi bidang mana yang Anda isi di halaman.

1. Tentukan variabel dan klik **Perbarui**.

**Menambahkan tautan**

Tautan dasbor memungkinkan Anda menempatkan tautan ke dasbor dan situs web lain langsung di bawah header dasbor. Tautan menyediakan navigasi yang mudah ke dasbor dan konten terkait lainnya. 

**Untuk menambahkan tautan**

1. Pada halaman **pengaturan Dasbor**, pilih **Tautan** dari menu bagian sisi kiri dan kemudian tombol **Tambahkan tautan**.

1. Masukkan judul dan di bidang **Jenis**, pilih **Dasbor** atau **Tautan**.

1. Untuk menambahkan tautan dasbor, tambahkan tag opsional, pilih salah satu opsi tautan dasbor, dan klik **Terapkan**.
**catatan**  
Menggunakan tag membuat dropdown dinamis dasbor yang semuanya memiliki tag tertentu.

1. Untuk menambahkan tautan web, tambahkan URL dan teks tooltip yang muncul saat pengguna mengarahkan kursor ke tautan, pilih ikon yang muncul di sebelah tautan, dan pilih salah satu opsi tautan dasbor. 

**Lihat dasbor model JSON**

Dasbor di Grafana diwakili oleh objek JSON, yang menyimpan metadata dasbor. Metadata dasbor mencakup properti dasbor, metadata dari panel, variabel template, kueri panel, dan sebagainya. Metadata JSON mendefinisikan dasbor.

Untuk melihat model JSON dasbor, pada halaman **pengaturan Dasbor**, klik **JSON**.

Untuk informasi selengkapnya tentang bidang JSON, lihat bidang [JSON](v10-dash-dashboard-json-model.md).

# Variabel URL dasbor
<a name="v10-dash-dashboard-url-variables"></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)

Grafana dapat menerapkan nilai variabel yang diteruskan sebagai parameter kueri di dasbor. URLs Untuk informasi selengkapnya, lihat [Mengelola tautan dasbor](v10-dash-manage-dashboard-links.md) serta [Template dan variabel](v10-dash-variables.md).

**Melewati variabel sebagai parameter kueri**

Grafana menafsirkan parameter string kueri yang diawali dengan variabel di `var-` dasbor yang diberikan.

Misalnya, di URL ini: 

```
https://${your-domain}/path/to/your/dashboard?var-example=value
```

Parameter query `var-example=value` merupakan contoh variabel dashboard dengan nilai`value`.

**Melewati beberapa nilai untuk variabel**

Untuk melewatkan beberapa nilai, ulangi parameter variabel sekali untuk setiap nilai.

```
https://${your-domain}/path/to/your/dashboard?var-example=value1&var-example=value2
```

Grafana menafsirkan `var-example=value1&var-example=value2` sebagai contoh variabel dasbor dengan dua nilai: dan. `value1` `value2`

**Menambahkan variabel ke tautan dasbor**

Grafana dapat menambahkan variabel ke tautan dasbor saat Anda membuatnya dari pengaturan dasbor. Untuk informasi selengkapnya dan langkah-langkah untuk menambahkan variabel, lihat [Mengelola tautan dasbor](v10-dash-manage-dashboard-links.md).

**Melewati filter ad hoc**

Filter ad hoc menerapkan filter kunci atau nilai ke semua kueri metrik yang menggunakan sumber data tertentu. Untuk informasi selengkapnya, lihat [Filter ad hoc](v10-dash-variable-add.md#v10-dash-variable-add-adhoc).

Untuk meneruskan filter ad hoc sebagai parameter kueri, gunakan sintaks variabel untuk meneruskan variabel filter ad hoc, dan juga berikan kunci, operator sebagai nilai, dan nilai sebagai daftar yang dipisahkan pipa.

Misalnya, di URL ini:

`https://${your-domain}/path/to/your/dashboard?var-adhoc=example_key|=|example_value` 

Parameter kueri `var-adhoc=key|=|value` menerapkan filter ad hoc yang dikonfigurasi sebagai variabel dasbor adhoc menggunakan `example_key` kunci, `=` operator, dan nilainya. `example_value`

**catatan**  
Saat berbagi URLs dengan filter ad hoc, ingatlah untuk menyandikan URL. Pada contoh di atas, ganti pipa (`|`) dengan `%7C` dan operator kesetaraan (`=`) dengan`%3D`.

**Mengontrol rentang waktu menggunakan URL**

Untuk mengatur rentang waktu dasbor, gunakan parameter`from`,`to`,`time`, dan `time.window` kueri. Karena ini bukan variabel, mereka tidak memerlukan `var-` awalan.

# Mengelola panel perpustakaan
<a name="v10-dash-manage-library-panels"></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)

Panel perpustakaan adalah panel yang dapat digunakan kembali yang dapat Anda gunakan di dasbor apa pun. Saat Anda mengubah panel pustaka, perubahan menyebar ke semua contoh di mana panel digunakan. Panel perpustakaan merampingkan penggunaan kembali panel di beberapa dasbor.

Anda dapat menyimpan panel perpustakaan di folder bersama dasbor yang disimpan.

**Membuat panel perpustakaan**

Saat Anda membuat panel pustaka, panel di dasbor sumber juga dikonversi ke panel perpustakaan. Anda perlu menyimpan dasbor asli setelah panel dikonversi.

**Untuk membuat panel perpustakaan**

1. Buka panel yang ingin Anda konversi ke panel perpustakaan dalam mode edit.

1. Dalam opsi tampilan panel, klik opsi panah bawah untuk memulai perubahan pada visualisasi.

1. Pilih **panel Perpustakaan**, lalu **\$1 Buat panel perpustakaan**. Ini membuka dialog buat.

1. Di **nama panel Perpustakaan**, masukkan nama yang Anda inginkan untuk panel.

1. Di **Simpan di folder**, pilih folder untuk menyimpan panel perpustakaan.

1. Pilih **Buat panel perpustakaan** untuk menyimpan perubahan Anda ke perpustakaan.

1. Simpan dasbor.

Setelah panel perpustakaan dibuat, Anda dapat memodifikasi panel menggunakan dasbor apa pun yang muncul. Setelah Anda menyimpan perubahan, semua instance panel pustaka mencerminkan modifikasi ini.

Anda juga dapat membuat panel perpustakaan langsung dari menu edit panel apa pun, dengan memilih **More...** lalu **Buat panel perpustakaan**.

**Menambahkan panel pustaka ke dasbor**

Tambahkan panel pustaka Grafana ke dasbor saat Anda ingin memberikan visualisasi kepada pengguna dasbor lainnya.

**Untuk menambahkan panel pustaka ke dasbor**

1. Pilih **Dasbor** di menu sebelah kiri.

1. Pilih **Baru**, lalu pilih **Dasbor baru** dari drop-down.

1. Di dasbor kosong, pilih **\$1 Impor panel perpustakaan**. Anda akan melihat daftar panel perpustakaan Anda.

1. Filter daftar atau cari untuk menemukan panel yang ingin Anda tambahkan.

1. Klik panel untuk menambahkannya ke dasbor.

**Membatalkan tautan panel pustaka**

Putuskan tautan panel pustaka saat Anda ingin membuat perubahan pada panel dan tidak memengaruhi contoh panel pustaka lainnya.

**Untuk memutuskan tautan panel pustaka**

1. Pilih **Dasbor** di menu sebelah kiri.

1. Pilih **panel Perpustakaan**.

1. Pilih panel perpustakaan yang sedang digunakan di dasbor yang berbeda.

1. Pilih panel yang ingin Anda putuskan tautannya.

1. Pilih judul panel (atau arahkan penunjuk ke mana saja di atas panel), untuk menampilkan menu tindakan di sudut kanan atas panel.

1. Pilih **Edit**. Panel akan terbuka dalam mode edit.

1. Pilih **Putuskan tautan** di sudut kanan atas halaman.

1. Pilih **Ya, batalkan tautan**.

**Melihat daftar panel pustaka**

Anda dapat melihat daftar panel pustaka yang tersedia dan mencari panel perpustakaan.

**Untuk melihat daftar panel pustaka**

1. Pilih **Dasbor** di menu sebelah kiri.

1. Pilih **panel Perpustakaan**. Anda dapat melihat daftar panel pustaka yang ditentukan sebelumnya.

1. Cari panel perpustakaan tertentu jika Anda tahu namanya. Anda juga dapat memfilter panel berdasarkan folder atau jenis.

**Menghapus panel pustaka**

Hapus panel perpustakaan saat Anda tidak lagi membutuhkannya.

**Untuk menghapus panel pustaka**

1. Pilih **Dasbor** di menu sebelah kiri.

1. Pilih **panel Perpustakaan**.

1. Pilih ikon hapus di sebelah nama panel perpustakaan untuk panel yang ingin Anda hapus.

# Mengelola riwayat versi dasbor
<a name="v10-dash-manage-version-history"></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 kali Anda menyimpan versi dasbor Anda, salinan versi itu disimpan sehingga versi dasbor Anda sebelumnya tidak hilang. Daftar versi ini tersedia dengan memasukkan pengaturan dasbor dan kemudian memilih **Versi** di menu sebelah kiri.

**catatan**  
20 versi terbaru dari dasbor disimpan.

Fitur riwayat versi dasbor memungkinkan Anda membandingkan dan mengembalikan ke versi dasbor yang disimpan sebelumnya.

**Membandingkan dua versi dasbor**

Untuk membandingkan dua versi dasbor, pilih dua versi dari daftar yang ingin Anda bandingkan. Klik **Bandingkan versi** untuk melihat perbedaan antara dua versi. Ini memunculkan tampilan diff versi. Secara default, Anda akan melihat ringkasan tekstual perubahan.

Jika Anda ingin melihat perbedaan JSON mentah yang mewakili dasbor Anda, Anda dapat melakukannya dengan mengklik tombol **View JSON Diff** di bagian bawah.

**Memulihkan ke versi dasbor yang disimpan sebelumnya**

Jika Anda perlu mengembalikan ke versi dasbor yang disimpan sebelumnya, Anda dapat memilih tombol **Pulihkan** di sebelah kanan baris dalam daftar versi dasbor, atau pilih** <x>tombol **Pulihkan ke versi** di tampilan diff. Memilih salah satu dari ini akan meminta Anda untuk mengkonfirmasi pemulihan.

Setelah memulihkan ke versi sebelumnya, versi baru akan dibuat yang berisi data yang sama persis dengan versi sebelumnya, hanya dengan nomor versi yang berbeda. Ini ditunjukkan di **kolom Catatan** untuk baris di versi dasbor baru. Ini memastikan versi dasbor Anda sebelumnya tidak terpengaruh oleh perubahan.

# Mengelola tautan dasbor
<a name="v10-dash-manage-dashboard-links"></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 menggunakan tautan untuk menavigasi antara dasbor yang umum digunakan atau untuk menghubungkan orang lain ke visualisasi Anda. Tautan memungkinkan Anda membuat pintasan ke dasbor, panel, dan bahkan situs web eksternal lainnya.

Grafana mendukung tautan dasbor, tautan panel, dan tautan data. Tautan dasbor ditampilkan di bagian atas dasbor. Tautan panel dapat diakses dengan mengklik ikon di sudut kiri atas panel.

**Memilih tautan mana yang akan digunakan**

Mulailah dengan mencari tahu bagaimana Anda saat ini menavigasi antar dasbor. Jika Anda sering melompat di antara satu set dasbor dan berjuang untuk menemukan konteks yang sama di masing-masing, tautan dapat membantu mengoptimalkan alur kerja Anda.

Langkah selanjutnya adalah mencari tahu jenis tautan mana yang tepat untuk alur kerja Anda. Meskipun semua jenis tautan di Grafana digunakan untuk membuat pintasan ke dasbor lain atau situs web eksternal, mereka bekerja dalam konteks yang berbeda.
+ Jika tautan terkait dengan sebagian besar jika tidak semua panel di dasbor, gunakan tautan dasbor.
+ Jika Anda ingin menelusuri panel tertentu, gunakan tautan panel.
+ Jika Anda ingin menautkan ke situs eksternal, Anda dapat menggunakan tautan dasbor atau tautan panel.
+ Jika Anda ingin menelusuri seri tertentu, atau bahkan pengukuran tunggal, gunakan tautan data.

**Mengontrol rentang waktu menggunakan URL**

Untuk mengontrol rentang waktu panel atau dasbor, Anda dapat memberikan parameter kueri di URL dasbor:
+ `from`mendefinisikan batas bawah rentang waktu, ditentukan dalam ms epoch.
+ `to`mendefinisikan batas atas rentang waktu, ditentukan dalam ms epoch.
+ `time`dan `time.window` mendefinisikan rentang waktu dari `time-time.window/2` ke`time+time.window/2`. Kedua parameter harus ditentukan dalam ms. Misalnya `?time=1500000000000&time.window=10000` akan menghasilkan rentang waktu 10 detik dari 1499999995000 hingga 1500000005000.

**Tautan dasbor**

Saat Anda membuat tautan dasbor, Anda dapat menyertakan rentang waktu dan variabel template saat ini untuk langsung melompat ke konteks yang sama di dasbor lain. Dengan cara ini, Anda tidak perlu khawatir apakah orang yang Anda kirimi tautan melihat data yang tepat. Untuk jenis tautan lainnya, lihat [Variabel tautan data]().

Tautan dasbor juga dapat digunakan sebagai pintasan ke sistem eksternal, seperti mengirimkan GitHub masalah dengan nama dasbor saat ini.

Setelah menambahkan tautan dasbor, itu akan muncul di sudut kanan atas dasbor Anda.

**Menambahkan tautan ke dasbor**

Tambahkan tautan ke dasbor lain di bagian atas dasbor Anda saat ini.

**Untuk menambahkan tautan ke dasbor**

1. Saat melihat dasbor yang ingin Anda tautkan, klik roda gigi di bagian atas layar untuk membuka **pengaturan Dasbor**.

1. Pilih **Tautan** dan kemudian **Tambahkan Tautan Dasbor** atau **Baru**.

1. Di **Type**, pilih **dasbor**.

1. Pilih opsi tautan dari berikut ini.
   + **Dengan tag** - Masukkan tag untuk membatasi dasbor yang ditautkan hanya dengan tag yang Anda masukkan. Jika tidak, Grafana menyertakan tautan ke semua dasbor lainnya.
   + **Sebagai dropdown** — Jika Anda menautkan ke banyak dasbor, Secara default, Grafana menampilkan semuanya side-by-side di bagian atas dasbor Anda. Memilih opsi ini dan menambahkan judul opsional, akan menampilkan tautan dalam dropdown.
   + **Rentang waktu** - Pilih opsi ini untuk menyertakan rentang waktu dasbor di tautan. Saat pengguna mengklik tautan, dasbor yang ditautkan akan terbuka dengan rentang waktu yang ditunjukkan sudah ditetapkan.
   + **Nilai variabel** - Pilih opsi ini untuk menyertakan variabel template yang saat ini digunakan sebagai parameter kueri di tautan. Saat pengguna mengklik tautan, templat apa pun yang cocok di dasbor tertaut disetel ke nilai dari tautan. Untuk informasi selengkapnya, lihat [Variabel URL Dasbor](v10-dash-dashboard-url-variables.md).
   + **Buka di tab baru** - Pilih opsi ini jika Anda ingin tautan dasbor terbuka di tab atau jendela baru.

1. Klik **Tambah**.

**Menambahkan tautan URL ke dasbor**

Tambahkan tautan ke URL di bagian atas dasbor Anda saat ini. Anda dapat menautkan ke URL apa pun yang tersedia, termasuk dasbor, panel, atau situs eksternal. Anda bahkan dapat mengontrol rentang waktu untuk memastikan pengguna diperbesar pada data yang tepat di Grafana.

**Untuk menambahkan tautan URL ke dasbor**

1. Saat melihat dasbor yang ingin Anda tautkan, pilih roda gigi di bagian atas layar untuk membuka **pengaturan Dasbor**.

1. Pilih **Tautan** dan kemudian **Tambahkan Tautan Dasbor** atau **Baru**.

1. Di **Ketik**, pilih **Tautan**.

1. Pilih opsi tautan dari berikut ini.
   + **URL** — Masukkan URL yang ingin Anda tautkan. Bergantung pada target, Anda mungkin ingin menyertakan nilai bidang.
   + **Judul** - Masukkan judul yang ingin ditampilkan tautan.
   + **Tooltip** - Masukkan tooltip yang ingin ditampilkan tautan.
   + **Ikon** - Pilih ikon yang ingin ditampilkan dengan tautan.
   + **Rentang waktu** - Pilih opsi ini untuk menyertakan rentang waktu dasbor di tautan. Saat pengguna mengklik tautan, dasbor yang ditautkan akan terbuka dengan rentang waktu yang ditentukan.
     + `from`— Mendefinisikan batas bawah rentang waktu, yang ditentukan dalam epoch ms.
     + `to`— Mendefinisikan batas atas rentang waktu, yang ditentukan dalam zaman ms.
     + `time`dan `time.window` — Tentukan rentang waktu dari `time-time.window/2` ke`time+time.window/2`. Kedua parameter harus ditentukan dalam ms. Misalnya `?time=1500000000000&time.window=10000` akan menghasilkan rentang waktu 10 detik dari 1499999995000 hingga 1500000005000.
   + **Nilai variabel** - Pilih opsi ini untuk menyertakan variabel template yang saat ini digunakan sebagai parameter kueri di tautan. Saat pengguna mengklik tautan, templat apa pun yang cocok di dasbor tertaut disetel ke nilai dari tautan.

     Format variabel adalah sebagai berikut:

     ```
     https://${you-domain}/path/to/your/dashboard?var-${template-varable1}=value1&var-{template-variable2}=value2
     ```
   + **Buka di tab baru** - Pilih opsi ini jika Anda ingin tautan dasbor terbuka di tab atau jendela baru

1. Pilih **Tambahkan**.

**Memperbarui tautan dasbor**

Untuk mengubah atau memperbarui tautan dasbor yang ada, ikuti prosedur ini.

**Untuk memperbarui tautan dasbor**

1. Di **pengaturan Dasbor,** pada tab **Tautan**, pilih tautan yang ada yang ingin Anda edit.

1. Ubah pengaturan dan kemudian pilih **Perbarui**.

**Menduplikasi tautan dasbor**

Untuk menduplikasi tautan dasbor yang ada, pilih ikon duplikat di sebelah tautan yang ada yang ingin Anda duplikat.

**Menghapus tautan dasbor**

Untuk menghapus tautan dasbor yang ada, pilih ikon sampah di samping tautan yang ingin Anda hapus.

**Tautan panel**

Setiap panel dapat memiliki rangkaian tautannya sendiri yang ditampilkan di sudut kiri atas panel. Anda dapat menautkan ke URL apa pun yang tersedia, termasuk dasbor, panel, atau situs eksternal. Anda bahkan dapat mengontrol rentang waktu untuk memastikan pengguna diperbesar pada data yang tepat di Grafana.

Untuk melihat tautan panel yang tersedia, pilih ikon di sebelah kanan judul panel.
+ **Menambahkan tautan panel**: Setiap panel dapat memiliki kumpulan tautannya sendiri yang ditampilkan di sudut kiri atas panel. Anda dapat menautkan ke URL apa pun yang tersedia, termasuk dasbor, panel, atau situs eksternal. Anda bahkan dapat mengontrol rentang waktu untuk memastikan pengguna diperbesar pada data yang tepat di Grafana. Klik ikon di sudut kiri atas panel untuk melihat tautan panel yang tersedia.

  1. Arahkan kursor ke panel yang ingin Anda tambahkan tautannya.

  1. Pilih menu, dan pilih **Edit**, atau Anda dapat menggunakan pintasan keyboard,`e`.

  1. Perluas bagian **opsi Panel**, dan gulir ke bawah ke **tautan Panel**.

  1. Pilih **Tambahkan tautan**.

  1. Masukkan **Judul**. Ini adalah label yang dapat dibaca manusia untuk tautan yang akan ditampilkan di UI.

  1. Masukkan **URL** yang ingin Anda tautkan. Tekan `Ctrl+Space` (atau`Cmd+Space`) dan pilih bidang URL untuk melihat variabel yang tersedia. Dengan menambahkan variabel template ke link panel Anda, link mengirim pengguna ke konteks yang tepat, dengan variabel yang relevan sudah ditetapkan.

     Anda juga dapat menggunakan variabel waktu.
     + `from`mendefinisikan batas bawah rentang waktu, yang ditentukan dalam epoch ms.
     + `to`mendefinisikan batas atas rentang waktu, yang ditentukan dalam epoch ms.
     + `time`dan `time.window` mendefinisikan rentang waktu dari `time-time.window/2` ke`time+time.window/2`. Kedua parameter harus ditentukan dalam ms. Misalnya `?time=1500000000000&time.window=10000` menghasilkan rentang waktu 10 detik dari 1499999995000 hingga 1500000005000.
+ **Memperbarui tautan panel**

  1. Pilih panel (atau letakkan kursor di atas panel) untuk menampilkan menu tindakan di kanan atas panel.

  1. Dari menu, pilih **Edit**.

     Anda juga dapat menggunakan pintasan keyboard,`e`.

  1. Perluas bagian **opsi Panel**, dan gulir ke bawah ke **tautan Panel**.

  1. Temukan tautan yang ingin Anda ubah, dan pilih ikon **Edit** (pensil) di sebelahnya.

  1. Buat perubahan yang diperlukan.

  1. Pilih **Simpan** untuk menyimpan perubahan dan menutup jendela.

  1. Simpan perubahan ke dasbor Anda dengan memilih **Simpan** di kanan atas.
+ **Menghapus tautan panel**

  1. Pilih panel (atau letakkan kursor di atas panel) untuk menampilkan menu tindakan di kanan atas panel.

  1. Dari menu, pilih **Edit**.

     Anda juga dapat menggunakan pintasan keyboard,`e`.

  1. Perluas bagian **opsi Panel**, dan gulir ke bawah ke **tautan Panel**.

  1. Temukan tautan yang ingin Anda hapus, dan pilih ikon **X** di sebelahnya.

  1. Pilih **Simpan** di kanan atas untuk menyimpan perubahan Anda ke dasbor.

# Visualisasi anotasi
<a name="v10-dash-annotations"></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)

Anotasi menyediakan cara untuk menandai poin pada visualisasi dengan acara yang kaya. Mereka divisualisasikan sebagai garis vertikal dan ikon pada semua panel grafik. Saat Anda mengarahkan kursor ke anotasi, Anda bisa mendapatkan deskripsi acara dan tag acara. Bidang teks dapat menyertakan tautan ke sistem lain dengan lebih detail.

Anda dapat membuat anotasi visualisasi dengan tiga cara:
+ Langsung di panel, menggunakan [kueri anotasi bawaan](#v10-dash-built-in-query).
+ Menggunakan Grafana HTTP API.
+ Mengkonfigurasi kueri anotasi di pengaturan dasbor.

Dalam dua kasus pertama, Anda membuat anotasi baru, sementara yang terakhir Anda menanyakan anotasi yang ada dari sumber data. Kueri anotasi bawaan juga mendukung ini.

Bagian ini menjelaskan opsi pertama dan ketiga; untuk informasi tentang penggunaan Grafana HTTP API, lihat. [API Anotasi](Grafana-API-Annotations.md)

Anotasi didukung untuk jenis visualisasi berikut:
+ Deret waktu 
+ Garis waktu negara
+ Candlestick

## Buat anotasi di panel
<a name="v10-dash-create-annotations-in-panels"></a>

Grafana hadir dengan kemampuan untuk menambahkan peristiwa anotasi langsung dari panel menggunakan [kueri anotasi bawaan](#v10-dash-built-in-query) yang ada di semua dasbor. Anotasi yang Anda buat dengan cara ini disimpan di Grafana.

Untuk menambahkan anotasi langsung di panel:
+ Dasbor harus sudah disimpan.
+ Kueri bawaan harus diaktifkan.

**Untuk menambahkan anotasi**

1. Di dasbor pilih panel tempat Anda menambahkan anotasi. Menu konteks akan muncul. 

1. Di menu konteks, pilih **Tambahkan anotasi**.

1. (Opsional) Tambahkan deskripsi anotasi dan tag.

1. Pilih **Simpan**.

Atau, untuk menambahkan anotasi, tekan `Ctrl` (atau`Cmd`) saat memilih panel, dan popover **Tambahkan anotasi akan** muncul.

**Anotasi wilayah**

Anda juga dapat membuat anotasi yang mencakup wilayah, atau periode waktu dalam visualisasi.

**Untuk menambahkan anotasi wilayah**

1. Di dasbor tekan `Ctrl` (atau`Cmd`) saat memilih area panel.

1.  Tambahkan deskripsi anotasi dan tag (opsional). 

1.  Klik **Simpan**. 

**Untuk mengedit anotasi**

1. Di dasbor, arahkan kursor ke indikator anotasi pada panel.

1. Pilih ikon **Edit** (pensil) di tooltip anotasi.

1. Ubah and/or tag deskripsi.

1. Pilih **Simpan**.

**Untuk menghapus anotasi**

1. Di dasbor, arahkan kursor ke indikator anotasi pada panel.

1. Pilih ikon **Hapus** (sampah) di tooltip anotasi.

## Ambil anotasi melalui pengaturan dasbor
<a name="v10-dash-fetch-annotations"></a>

Di pengaturan dasbor, di bawah **Anotasi**, Anda dapat menambahkan kueri baru untuk mengambil anotasi menggunakan sumber data apa pun, termasuk sumber data anotasi data bawaan. Kueri anotasi mengembalikan peristiwa yang dapat divisualisasikan sebagai penanda peristiwa dalam grafik di seluruh dasbor. 

**Untuk menambahkan kueri anotasi baru**

1. Pilih ikon **Pengaturan** (roda gigi) di header dasbor untuk membuka menu pengaturan.

1. Pilih **Anotasi**.

1. Klik **Tambahkan kueri anotasi**.

1. Masukkan nama untuk kueri anotasi.

   Nama ini diberikan ke sakelar (kotak centang) yang memungkinkan Anda mengaktifkan menampilkan peristiwa anotasi dari kueri ini. 

1. Pilih sumber data untuk anotasi.

   Anda juga dapat memilih **Buka pemilih sumber data lanjutan** untuk melihat opsi lainnya, termasuk menambahkan sumber data baru (hanya tersedia untuk Admin).

1. Jika Anda tidak ingin segera menggunakan kueri anotasi, kosongkan kotak centang **Diaktifkan**.

1. **Jika Anda tidak ingin sakelar kueri anotasi ditampilkan di dasbor, pilih kotak centang Tersembunyi.**

1. Pilih warna untuk penanda acara.

1. Di menu tarik-turun **Tampilkan di**, pilih salah satu opsi berikut:
   + **Semua panel** — Anotasi ditampilkan pada semua panel yang mendukung anotasi.
   + **Panel yang dipilih** - Anotasi ditampilkan pada semua panel yang Anda pilih.
   + **Semua panel kecuali** - Anotasi ditampilkan pada semua panel kecuali yang Anda pilih.

1. Konfigurasikan kueri.

   Opsi kueri anotasi berbeda untuk setiap sumber data. Untuk informasi tentang anotasi dalam sumber data tertentu, lihat[Connect ke sumber data](AMG-data-sources.md).

## Kueri bawaan
<a name="v10-dash-built-in-query"></a>

Setelah Anda menambahkan anotasi, mereka akan tetap terlihat. Ini karena kueri anotasi bawaan yang ada di semua dasbor. Kueri anotasi ini akan mengambil semua peristiwa anotasi yang berasal dari dasbor saat ini, yang disimpan di Grafana, dan menampilkannya di panel tempat pembuatannya. Ini termasuk anotasi riwayat status peringatan.

Secara default, kueri anotasi bawaan menggunakan sumber data `Grafana` khusus, dan anotasi manual hanya didukung menggunakan sumber data ini. Anda dapat menggunakan sumber data lain dalam kueri anotasi bawaan, tetapi Anda hanya dapat membuat anotasi otomatis menggunakan editor kueri untuk sumber data tersebut.

Untuk menambahkan anotasi langsung ke dasbor, kueri ini harus diaktifkan.

**Untuk mengonfirmasi kueri bawaan diaktifkan**

1. Pilih ikon **pengaturan** dasbor (roda gigi) di header dasbor untuk membuka menu pengaturan dasbor.

1. Pilih **Anotasi**. 

1. Temukan kueri **Anotasi & Peringatan (Built-in)**.

   Jika ditampilkan **Dinonaktifkan** sebelum nama kueri, maka Anda harus memilih nama kueri untuk membukanya dan memperbarui pengaturan.

**Untuk menghentikan anotasi agar tidak diambil dan digambar**

1. Pilih ikon **pengaturan** dasbor (roda gigi) di header dasbor untuk membuka menu pengaturan dasbor.

1. Pilih **Anotasi**. 

1. Pilih kueri **Anotasi & Peringatan (Built-in)**.

1. Pilih sakelar **Diaktifkan** untuk mematikannya.

Saat Anda menyalin dasbor menggunakan fitur **Simpan Sebagai**, itu akan mendapatkan id dasbor baru, jadi anotasi yang dibuat di dasbor sumber tidak akan lagi terlihat pada salinan. Anda masih dapat menunjukkannya jika Anda menambahkan **Kueri Anotasi** baru dan memfilter berdasarkan tag. Namun, ini hanya berfungsi jika anotasi di dasbor sumber memiliki tag untuk difilter.

**Memfilter kueri berdasarkan tag**

**Anda dapat membuat kueri baru untuk mengambil anotasi dari kueri anotasi bawaan menggunakan sumber `Grafana` data dengan menyetel Filter menurut ke.** `Tags`

Misalnya, buat nama kueri anotasi `outages` dan tentukan tag`outage`. Kueri ini akan menampilkan semua anotasi (dari dasbor apa pun atau melalui API) dengan `outage` tag. Jika beberapa tag didefinisikan dalam kueri anotasi, maka Grafana hanya akan menampilkan anotasi yang cocok dengan semua tag. Untuk mengubah perilaku, aktifkan **Match any**, dan Grafana akan menampilkan anotasi yang berisi salah satu tag yang Anda berikan.

 Anda juga dapat menggunakan variabel template dalam kueri tag. Ini berarti jika Anda memiliki dasbor yang menampilkan statistik untuk layanan yang berbeda dan variabel template yang menentukan layanan mana yang akan ditampilkan, Anda dapat menggunakan variabel template yang sama dalam kueri anotasi Anda untuk hanya menampilkan anotasi untuk layanan tersebut. 

# Model Dashboard JSON
<a name="v10-dash-dashboard-json-model"></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)

Dasbor di Grafana diwakili oleh objek JSON, yang menyimpan metadata dasbornya. Metadata dasbor mencakup properti dasbor, metadata dari panel, variabel template, dan kueri panel.

**Untuk melihat JSON dasbor**

1. Arahkan ke dasbor.

1. Di menu navigasi atas, pilih ikon **Pengaturan dasbor** (roda gigi).

1. Pilih **Model JSON**.

## Bidang JSON
<a name="v10-dash-json-fields"></a>

Saat pengguna membuat dasbor baru, objek JSON dasbor baru diinisialisasi dengan bidang berikut.

**catatan**  
Dalam JSON berikut, id ditampilkan sebagai null, yang merupakan nilai default yang ditetapkan untuk itu sampai dashboard disimpan. Setelah dasbor disimpan, nilai integer ditetapkan ke `id` bidang.

```
{
  "id": null,
  "uid": "cLV5GDCkz",
  "title": "New dashboard",
  "tags": [],
  "timezone": "browser",
  "editable": true,
  "graphTooltip": 1,
  "panels": [],
  "time": {
    "from": "now-6h",
    "to": "now"
  },
  "timepicker": {
    "time_options": [],
    "refresh_intervals": []
  },
  "templating": {
    "list": []
  },
  "annotations": {
    "list": []
  },
  "refresh": "5s",
  "schemaVersion": 17,
  "version": 0,
  "links": []
}
```

Berikut ini menjelaskan setiap bidang di dashboard JSON.


| Nama | Penggunaan | 
| --- | --- | 
| `id` | pengidentifikasi numerik unik untuk dasbor (dihasilkan oleh db) | 
| `uid` | pengidentifikasi dasbor unik yang dapat dihasilkan oleh siapa saja. string (8-40) | 
| `title` | judul dasbor saat ini | 
| `tags` | tag yang terkait dengan dasbor, array string | 
| `style` | tema dasbor, seperti `dark` atau `light` | 
| `timezone` | zona waktu dasbor, seperti `utc` atau `browser` | 
| `editable` | apakah dasbor dapat diedit atau tidak | 
| `graphTooltip` | 0 tanpa crosshair bersama atau tooltip (default), 1 untuk crosshair bersama, 2 untuk crosshair bersama dan tooltip bersama | 
| `time` | rentang waktu untuk dasbor, seperti `last 6 hours` atau `last 7 days` | 
| `timepicker` | [metadata timepicker, lihat bagian timepicker untuk detailnya](#v10-dash-json-panels) | 
| `templating` | template metadata, lihat bagian [templating](#v10-dash-json-panels) untuk detailnya | 
| `annotations` | metadata anotasi, lihat [anotasi](v10-dash-annotations.md) untuk cara menambahkannya | 
| `refresh` | interval penyegaran otomatis | 
| `schemaVersion` | versi skema JSON (integer), bertambah setiap kali pembaruan Grafana membawa perubahan pada skema ini | 
| `version` | versi dasbor (integer), bertambah setiap kali dasbor diperbarui | 
| `panels` | panel array (lihat bagian selanjutnya untuk detailnya) | 

## Panel
<a name="v10-dash-json-panels"></a>

Panel adalah blok bangunan dasbor. Ini terdiri dari kueri sumber data, jenis grafik, alias, dan banyak lagi. Panel JSON terdiri dari array objek JSON, masing-masing mewakili panel yang berbeda. Sebagian besar bidang umum untuk semua panel tetapi beberapa bidang tergantung pada jenis panel. Berikut ini adalah contoh panel JSON dari panel teks.

```
"panels": [
  {
    "type": "text",
    "title": "Panel Title",
    "gridPos": {
      "x": 0,
      "y": 0,
      "w": 12,
      "h": 9
    },
    "id": 4,
    "mode": "markdown",
    "content": "# title"
  }
```

**Ukuran dan posisi panel**

Properti GridPOS menjelaskan ukuran panel dan posisi dalam koordinat grid.
+ `w`- 1 hingga 24 (lebar dasbor dibagi menjadi 24 kolom)
+ `h`— Dalam satuan tinggi grid, masing-masing mewakili 30 piksel.
+ `x`— Posisi x, dalam satuan yang sama dengan`w`.
+ `y`— Posisi y, dalam satuan yang sama dengan`h`.

Grid memiliki gravitasi negatif yang bergerak ke atas panel jika ada ruang kosong di atas panel.

**Timepicker**

```
"timepicker": {
    "collapse": false,
    "enable": true,
    "notice": false,
    "now": true,
    "refresh_intervals": [
      "5s",
      "10s",
      "30s",
      "1m",
      "5m",
      "15m",
      "30m",
      "1h",
      "2h",
      "1d"
    ],
    "status": "Stable",
    "type": "timepicker"
  }
```

**Templating**

`templating`Bidang berisi array variabel template dengan nilai yang disimpan bersama dengan beberapa metadata lainnya.

```
"templating": {
    "enable": true,
    "list": [
       {
        "allFormat": "wildcard",
        "current":  {
          "tags": [],
          "text": "prod",
          "value": "prod"
        },
        "datasource": null,
        "includeAll": true,
        "name": "env",
        "options": [
           {
            "selected": false,
            "text": "All",
            "value": "*"
          },
           {
            "selected": false,
            "text": "stage",
            "value": "stage"
          },
           {
            "selected": false,
            "text": "test",
            "value": "test"
          }
        ],
        "query": "tag_values(cpu.utilization.average,env)",
        "refresh": false,
        "type": "query"
      },
       {
        "allFormat": "wildcard",
        "current":  {
          "text": "apache",
          "value": "apache"
        },
        "datasource": null,
        "includeAll": false,
        "multi": false,
        "multiFormat": "glob",
        "name": "app",
        "options": [
           {
            "selected": true,
            "text": "tomcat",
            "value": "tomcat"
          },
           {
            "selected": false,
            "text": "cassandra",
            "value": "cassandra"
          }
        ],
        "query": "tag_values(cpu.utilization.average,app)",
        "refresh": false,
        "regex": "",
        "type": "query"
      }
    ]
  }
```

Tabel berikut menjelaskan penggunaan bidang templating.


| Nama | Penggunaan | 
| --- | --- | 
|  `enable`  |  apakah templating diaktifkan atau tidak  | 
|  `list`  |  array objek masing-masing mewakili satu variabel template  | 
|  `allFormat`  |  format yang akan digunakan saat mengambil semua nilai dari sumber data, termasuk`wildcard`,, `glob``regex`,`pipe`.  | 
|  `current`  |  menunjukkan variabel yang dipilih saat ini text/value di dasbor  | 
|  `datasource`  |  menunjukkan sumber data untuk variabel  | 
|  `includeAll`  |  apakah semua opsi nilai tersedia atau tidak  | 
|  `multi`  |  apakah beberapa nilai dapat dipilih atau tidak dari daftar nilai variabel  | 
|  `multiFormat`  |  format yang akan digunakan saat mengambil timeseries dari sumber data  | 
|  `name`  |  nama variabel  | 
|  `options`  |  array text/value pasangan variabel yang tersedia untuk seleksi di dasbor  | 
|  `query`  |  kueri sumber data yang digunakan untuk mengambil nilai untuk variabel  | 
|  `refresh`  |  mengonfigurasi kapan harus me-refresh variabel  | 
|  `regex`  |  mengekstrak bagian dari nama seri atau segmen simpul metrik  | 
|  `type`  |  jenis variabel,`custom`,`query`, atau `interval`  | 

# Praktik terbaik untuk dasbor
<a name="v10-dash-bestpractices"></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)

Bagian ini memberikan informasi tentang praktik terbaik bagi administrator dan pengguna Grafana tentang cara membuat dan memelihara dasbor Grafana.

Untuk informasi tentang berbagai jenis dasbor yang dapat Anda buat, lihat [dasbor Grafana: Panduan lengkap untuk semua jenis berbeda yang dapat Anda](https://grafana.com/blog/2022/06/06/grafana-dashboards-a-complete-guide-to-all-the-different-types-you-can-build/?pg=webinar-getting-started-with-grafana-dashboard-design-amer&plcmt=related-content-1) buat posting blog di situs web Grafana Labs.

**catatan**  
Bagian ini dapat membantu Anda membuat strategi untuk pemantauan dan pemeliharaan dasbor Anda. Anda tahu sistem Anda yang terbaik, dan harus menggunakan bagian ini untuk memandu pemahaman Anda. Pada akhirnya, adalah tanggung jawab Anda untuk menciptakan strategi terbaik untuk sistem Anda.

## Strategi observabilitas umum
<a name="v10-dash-common-observability-strategies"></a>

Ketika Anda memiliki banyak hal untuk dipantau, seperti server farm, Anda memerlukan strategi untuk memutuskan apa yang cukup penting untuk dipantau. Halaman ini menjelaskan beberapa metode umum untuk memilih apa yang akan dipantau.

Strategi logis memungkinkan Anda membuat dasbor yang seragam dan menskalakan platform observabilitas Anda dengan lebih mudah.

**Pedoman strategi**
+ Metode USE memberi tahu Anda betapa bahagianya mesin Anda, metode RED memberi tahu Anda betapa bahagianya pengguna Anda.
+ Gunakan laporan tentang penyebab masalah.
+ RED melaporkan pengalaman pengguna dan lebih cenderung melaporkan gejala masalah.
+ Memantau keduanya penting untuk memahami sistem Anda. Sebagai praktik terbaik, waspada pada gejala daripada penyebab. Biasanya, peringatan dikonfigurasi pada dasbor MERAH.

**Gunakan metode**

USE adalah singkatan dari:
+ **Pemanfaatan** — Persentase waktu sumber daya sibuk, seperti penggunaan CPU node.
+ **Saturasi** — Jumlah pekerjaan yang harus dilakukan sumber daya, seringkali panjang antrian atau beban simpul.
+ **Kesalahan** — Hitungan peristiwa kesalahan.

Metode ini paling baik untuk sumber daya perangkat keras dalam infrastruktur, seperti CPU, memori, dan perangkat jaringan. [Untuk informasi lebih lanjut, lihat posting blog Brendan Gregg Metode USE.](http://www.brendangregg.com/usemethod.html)

**Metode RED**

RED adalah singkatan dari:
+ **Tarif** - Permintaan per detik
+ **Kesalahan** — Jumlah permintaan yang gagal.
+ **Durasi** — Jumlah waktu yang dibutuhkan permintaan ini, distribusi pengukuran latensi.

Metode ini paling berlaku untuk layanan, terutama lingkungan microservices. Untuk setiap layanan Anda, instrumen kode untuk mengekspos metrik ini untuk setiap komponen. Dasbor MERAH bagus untuk mengingatkan dan. SLAs Dasbor RED yang dirancang dengan baik adalah proxy untuk pengalaman pengguna.

Untuk informasi lebih lanjut, lihat posting blog Tom Wilkie [Metode RED: Cara instrumen layanan Anda](https://grafana.com/blog/2018/08/02/the-red-method-how-to-instrument-your-services).

**Empat Sinyal Emas**

Menurut [buku pegangan Google SRE](https://landing.google.com/sre/sre-book/chapters/monitoring-distributed-systems/#xref_monitoring_golden-signals), jika Anda hanya dapat mengukur empat metrik sistem yang dihadapi pengguna Anda, fokuslah pada keempat metrik ini.

Metode ini mirip dengan metode RED, tetapi termasuk saturasi.
+ **Latensi** — Waktu yang dibutuhkan untuk melayani permintaan.
+ **Lalu Lintas** — Berapa banyak permintaan yang ditempatkan pada sistem Anda.
+ **Kesalahan** — Tingkat permintaan yang gagal.
+ **Saturasi** — Seberapa “penuh” sistem Anda,

## Model kematangan manajemen dasbor
<a name="v10-dash-management-maturity-model"></a>

*Kematangan manajemen dasbor* mengacu pada seberapa baik dirancang dan efisien ekosistem dasbor Anda. Kami merekomendasikan untuk meninjau pengaturan dasbor Anda secara berkala untuk mengukur di mana Anda berada dan bagaimana Anda dapat meningkatkan.

Secara garis besar, kematangan dasbor dapat didefinisikan sebagai rendah, sedang, atau tinggi. 

 Sebagian besar konten untuk topik ini diambil dari pembicaraan KubeCon 2019 [Fool-Proof Kubernetes Dashboards for Sleep-Deprived Oncalls](https://www.youtube.com/watch?v=YE2aQFiMGfY). 

**Rendah - keadaan default**

Pada tahap ini, Anda tidak memiliki strategi manajemen dasbor yang koheren. Hampir semua orang mulai dari sini.

Bagaimana Anda bisa tahu Anda ada di sini?
+ Semua orang dapat memodifikasi dasbor Anda.
+ Banyak dasbor yang disalin, sedikit atau tidak ada penggunaan kembali dasbor.
+ Dasbor satu kali yang berkeliaran selamanya.
+ Tidak ada kontrol versi (dasbor JSON dalam kontrol versi).
+ Banyak browsing untuk dashboard, mencari dashboard yang tepat. Ini berarti banyak waktu yang terbuang untuk mencoba menemukan dasbor yang Anda butuhkan.
+ Tidak ada peringatan untuk mengarahkan Anda ke dasbor kanan.

**Sedang - dasbor metodis**

Pada tahap ini, Anda mulai mengelola penggunaan dasbor Anda dengan dasbor metodis. Anda mungkin telah menyusun strategi, tetapi ada beberapa hal yang dapat Anda tingkatkan.

 Bagaimana Anda bisa tahu Anda ada di sini? 
+ Mencegah penyebaran dengan menggunakan variabel template. Misalnya, Anda tidak memerlukan dasbor terpisah untuk setiap node, Anda dapat menggunakan variabel kueri. Lebih baik lagi, Anda dapat menjadikan sumber data sebagai variabel template juga, sehingga Anda dapat menggunakan kembali dasbor yang sama di berbagai cluster dan memantau backend.

  Lihat daftar contoh di[Variabel](v10-dash-variables.md), untuk ide.
+ [Dasbor metodis menurut strategi observabilitas.](#v10-dash-common-observability-strategies)
+ Dasbor hierarkis dengan penelusuran ke tingkat berikutnya.
+ Desain dasbor mencerminkan hierarki layanan. Misalnya, Anda dapat menggunakan metode RED dengan satu baris per layanan. Urutan baris dapat mencerminkan aliran data, saat Anda menggulir ke bawah dasbor.
+ Bandingkan like to like: split service dashboard bila besarnya berbeda. Pastikan metrik agregat tidak menghilangkan informasi penting.
+ Bagan ekspresif dengan penggunaan warna yang berarti dan sumbu normalisasi di mana Anda bisa.
  + Contoh warna yang bermakna: Biru berarti bagus, merah berarti buruk. [Ambang batas](v10-panels-configure-thresholds.md) dapat membantu dengan itu.
  + Contoh sumbu normalisasi: Saat membandingkan penggunaan CPU, ukur berdasarkan persentase daripada angka mentah, karena mesin dapat memiliki jumlah inti yang berbeda. Normalisasi penggunaan CPU dengan jumlah core mengurangi beban kognitif karena pemirsa dapat mempercayai bahwa pada 100% semua core sedang digunakan, tanpa harus mengetahui jumlahnya. CPUs
+ Penjelajahan terarah mengurangi tebakan.
  + Variabel template membuat lebih sulit untuk menjelajah secara acak atau tanpa tujuan.
  + Sebagian besar dasbor harus ditautkan dengan peringatan.
  + Penjelajahan diarahkan dengan tautan. Untuk informasi selengkapnya, lihat [Mengelola tautan dasbor](v10-dash-manage-dashboard-links.md).
+  Dasbor yang dikontrol versi JSON. 

**Penggunaan yang dioptimalkan tinggi**

Pada tahap ini, Anda telah mengoptimalkan penggunaan manajemen dasbor Anda dengan strategi yang konsisten dan bijaksana. Itu membutuhkan perawatan, tetapi hasilnya sepadan.
+ Secara aktif mengurangi penyebaran.
  + Tinjau dasbor yang ada secara teratur untuk memastikannya masih relevan.
  + Hanya dasbor yang disetujui yang ditambahkan ke daftar dasbor utama.
  + Melacak penggunaan dasbor. Anda dapat memanfaatkan [wawasan Penggunaan](v10-dash-assess-dashboard-usage.md).
+ Konsistensi dengan desain.
+ Gunakan pustaka skrip untuk menghasilkan dasbor, memastikan konsistensi dalam pola dan gaya.
  + grafonnet (Jsonnet)
  + grafanalib (Python)
+ Tidak ada pengeditan di browser. Pemirsa dasbor mengubah tampilan dengan variabel.
+ Menjelajahi dasbor adalah pengecualian, bukan aturannya.
+ Lakukan eksperimen dan pengujian dalam instance Grafana terpisah yang didedikasikan untuk tujuan itu, bukan instance produksi Anda. Jika dasbor di lingkungan pengujian terbukti berguna, tambahkan dasbor itu ke instance Grafana utama Anda.

## Praktik terbaik untuk membuat dasbor
<a name="v10-dash-best-practices-for-creating-dashboards"></a>

Bagian ini menguraikan beberapa praktik terbaik untuk diikuti saat membuat dasbor Grafana.

**Sebelum Anda memulai**

 Berikut adalah beberapa prinsip yang perlu dipertimbangkan sebelum Anda membuat dasbor. 

**Dasbor harus menceritakan kisah atau menjawab pertanyaan**

Kisah apa yang ingin Anda ceritakan dengan dasbor Anda? Cobalah untuk membuat perkembangan data yang logis, seperti besar ke kecil atau umum ke spesifik. Apa tujuan dari dasbor ini? (Petunjuk: Jika dasbor tidak memiliki tujuan, tanyakan pada diri Anda apakah Anda benar-benar membutuhkan dasbor.)

Buat grafik Anda sederhana dan fokus untuk menjawab pertanyaan yang Anda ajukan. Misalnya, jika pertanyaan Anda adalah “server mana yang bermasalah?” , maka mungkin Anda tidak perlu menampilkan semua data server. Cukup tampilkan data untuk mereka yang bermasalah.

**Dasbor harus mengurangi beban kognitif, bukan menambahkannya**

*Beban kognitif* pada dasarnya adalah seberapa sulit Anda perlu memikirkan sesuatu untuk mengetahuinya. Buat dasbor Anda mudah ditafsirkan. Pengguna lain dan future Anda (ketika Anda mencoba mencari tahu apa yang rusak pada 2AM) akan menghargainya.

 Tanyakan pada diri sendiri: 
+ Dapatkah saya memberi tahu persis apa yang diwakili oleh setiap grafik? Apakah sudah jelas, atau apakah saya harus memikirkannya?
+ Jika saya menunjukkan ini kepada orang lain, berapa lama waktu yang dibutuhkan mereka untuk mengetahuinya? Apakah mereka akan tersesat?

**Memiliki Strategi Monitoring**

Sangat mudah untuk membuat dasbor baru. Lebih sulit untuk mengoptimalkan pembuatan dasbor dan mematuhi rencana, tetapi itu sepadan. Strategi ini harus mengatur skema dasbor Anda secara keseluruhan dan menegakkan konsistensi dalam desain dasbor individual.

Lihat [strategi observabilitas umum](#v10-dash-common-observability-strategies) dan [tingkat kematangan manajemen Dasbor](#v10-dash-management-maturity-model) untuk informasi lebih lanjut.

**Tuliskan**

Setelah Anda memiliki strategi atau pedoman desain, tuliskan untuk membantu menjaga konsistensi dari waktu ke waktu.

**Praktik terbaik untuk diikuti**
+ Saat membuat dasbor baru, pastikan itu memiliki nama yang berarti.
  + Jika Anda membuat dasbor untuk bermain atau bereksperimen, maka masukkan `TMP` kata `TEST` atau namanya.
  + Pertimbangkan untuk memasukkan nama atau inisiasi Anda di nama dasbor atau sebagai tag sehingga orang tahu siapa yang memiliki dasbor.
  + Hapus dasbor eksperimen sementara setelah Anda selesai menggunakannya.
+ Jika Anda membuat banyak dasbor terkait, pikirkan cara mereferensikan silang untuk navigasi yang mudah. Untuk informasi selengkapnya, lihat [Praktik terbaik untuk mengelola dasbor](#v10-dash-best-practices-for-managing-dashboards), nanti di bagian ini.
+ Grafana mengambil data dari sumber data. Pemahaman dasar [Connect ke sumber data](AMG-data-sources.md) secara umum, dan sumber data spesifik Anda adalah penting.
+ Hindari penyegaran dasbor yang tidak perlu untuk mengurangi beban pada jaringan atau backend. Misalnya, jika data Anda berubah setiap jam, maka Anda tidak perlu mengatur kecepatan refresh dasbor menjadi 30 detik.
+ Gunakan sumbu Y kiri dan kanan saat menampilkan deret waktu dengan satuan atau rentang yang berbeda.
+ Tambahkan dokumentasi ke dasbor dan panel.
  + Untuk menambahkan dokumentasi ke dasbor, tambahkan [visualisasi panel Teks](v10-panels-text.md) ke dasbor. Rekam hal-hal seperti tujuan dasbor, tautan sumber daya yang berguna, dan instruksi apa pun yang mungkin diperlukan pengguna untuk berinteraksi dengan dasbor.
  + Untuk menambahkan dokumentasi ke panel, edit pengaturan panel dan tambahkan deskripsi. Teks apa pun yang Anda tambahkan akan muncul jika Anda mengarahkan kursor ke atas yang kecil `i` di sudut kiri atas panel.
+ Gunakan kembali dasbor Anda dan terapkan konsistensi dengan menggunakan [templat](v10-dash-variables.md) dan variabel.
+ Hati-hati dengan menumpuk data grafik. Visualisasi dapat menyesatkan, dan menyembunyikan data penting. Kami merekomendasikan untuk mematikannya dalam banyak kasus.

## Praktik terbaik untuk mengelola dasbor
<a name="v10-dash-best-practices-for-managing-dashboards"></a>

 Halaman ini menguraikan beberapa praktik terbaik untuk diikuti saat mengelola dasbor Grafana. 

**Sebelum Anda memulai**

Berikut adalah beberapa prinsip yang perlu dipertimbangkan sebelum Anda mulai mengelola dasbor.

**Observabilitas strategis**

Ada beberapa [strategi observabilitas umum](#v10-dash-common-observability-strategies). Anda harus meneliti mereka dan memutuskan apakah salah satu dari mereka bekerja untuk Anda atau jika Anda ingin membuat sendiri. Either way, punya rencana, menuliskannya, dan menaatinya.

Sesuaikan strategi Anda untuk mengubah kebutuhan seperlunya.

**Tingkat kedewasaan**

Apa tingkat kematangan dasbor Anda? Analisis pengaturan dasbor Anda saat ini dan bandingkan dengan [model kematangan manajemen Dasbor](#v10-dash-management-maturity-model). Memahami di mana Anda berada dapat membantu Anda memutuskan bagaimana menuju ke tempat yang Anda inginkan.

**Praktik terbaik untuk diikuti**
+ Hindari penyebaran dasbor, yang berarti pertumbuhan dasbor yang tidak terkendali. Dashboard sprawl berdampak negatif pada waktu untuk menemukan dasbor yang tepat. Menduplikasi dasbor dan mengubah “satu hal” (lebih buruk lagi: menyimpan tag asli) adalah jenis penyebaran yang paling mudah.
  + Tinjau dasbor secara berkala dan hapus yang tidak perlu.
  + Jika Anda membuat dasbor sementara, mungkin untuk menguji sesuatu, awali nama dengan`TEST:`. Hapus dasbor saat Anda selesai.
+ Menyalin dasbor tanpa perubahan signifikan bukanlah ide yang baik.
  + Anda kehilangan pembaruan ke dasbor asli, seperti perubahan dokumentasi, perbaikan bug, atau penambahan metrik.
  + Dalam banyak kasus salinan sedang dibuat untuk hanya menyesuaikan tampilan dengan mengatur parameter template. Ini seharusnya dilakukan dengan mempertahankan tautan ke dasbor utama dan menyesuaikan tampilan dengan [parameter URL](v10-panels-configure-data-links.md#v10-panels-data-link-variables).
+ Ketika Anda harus menyalin dasbor, ganti nama dengan jelas dan *jangan* menyalin tag dasbor. Tag adalah metadata penting untuk dasbor yang digunakan selama pencarian. Menyalin tag dapat menghasilkan kecocokan palsu.
+ Pertahankan dasbor dasbor atau dasbor referensi silang. Ini dapat dilakukan dengan beberapa cara: 
  + Buat tautan dasbor, panel, atau tautan data. Tautan dapat pergi ke dasbor lain atau ke sistem eksternal. Untuk informasi selengkapnya, lihat [Mengelola tautan dasbor](v10-dash-manage-dashboard-links.md).
  +  Tambahkan [panel daftar Dashboard](v10-panels-dashboard-list.md). Anda kemudian dapat menyesuaikan apa yang Anda lihat dengan melakukan pencarian tag atau folder.
  + Tambahkan [panel Teks](v10-panels-dashboard-list.md) dan gunakan penurunan harga untuk menyesuaikan tampilan. 

# Mengelola dasbor
<a name="v10-dash-managing-dashboards"></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)

Pada halaman **Dasbor** ruang kerja Anda (tersedia dengan memilih **Dasbor** dari menu kiri), Anda dapat melakukan tugas manajemen dasbor, termasuk mengatur dasbor Anda ke dalam folder.

Untuk informasi selengkapnya tentang membuat dasbor, lihat[Membangun dasbor](v10-dash-building-dashboards.md).

## Jelajahi dasbor
<a name="v10-dash-browse-dashboards"></a>

Di halaman **Dasbor**, Anda dapat menelusuri dan mengelola folder dan dasbor. Ini termasuk opsi untuk:
+ Buat folder dan dasbor.
+ Pindahkan dasbor antar folder.
+ Hapus beberapa dasbor dan folder.
+ Arahkan ke folder.
+ Kelola izin folder. Untuk informasi selengkapnya, lihat [Izin dasbor dan folder](dashboard-and-folder-permissions.md).

## Membuat folder dasbor
<a name="v10-dash-create-dashboard-folder"></a>

Folder membantu Anda mengatur dan mengelompokkan dasbor, yang berguna ketika Anda memiliki banyak dasbor atau beberapa tim menggunakan instance Grafana yang sama. Subfolder memungkinkan Anda membuat hierarki bersarang di organisasi dasbor Anda.

**Prasyarat**

Pastikan Anda memiliki izin Admin Grafana. Untuk informasi selengkapnya tentang izin dasbor, lihat[Izin dasbor dan folder](dashboard-and-folder-permissions.md).

**Untuk membuat folder dasbor**

1. Masuk ke Grafana. 

1. Di menu sebelah kiri, pilih **Dasbor**.

1. Pada halaman **Dasbor**, pilih **Baru** lalu pilih **Folder baru** di drop-down.

1. Masukkan nama unik dan klik **Buat**.

**catatan**  
Saat Anda menyimpan dasbor, Anda dapat memilih folder untuk dasbor yang akan disimpan atau membuat folder baru.

**Untuk mengedit nama folder**

1. Pilih **Dasbor** di menu sebelah kiri.

1. Pilih folder yang akan diganti namanya

1. Pilih ikon **Edit judul** (pensil) di header dan perbarui nama folder.

   Nama folder baru disimpan secara otomatis.

**Izin folder**

Anda dapat menetapkan izin ke folder. Dasbor di folder mewarisi izin apa pun yang telah Anda tetapkan ke folder. Anda dapat menetapkan izin untuk peran organisasi, tim, dan pengguna.

**Untuk mengubah izin untuk folder**

1. Pilih **Dasbor** dari menu kiri.

1. Pilih folder dalam daftar.

1. Pada halaman detail folder, pilih **Tindakan folder** dan pilih **Kelola izin** di daftar drop-down.

1. Perbarui izin sesuai keinginan.

Perubahan disimpan secara otomatis.

# Mengelola daftar putar
<a name="v10-dash-managing-playlists"></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)

*Daftar putar* adalah daftar dasbor yang ditampilkan secara berurutan. Anda dapat menggunakan daftar putar untuk membangun kesadaran situasional atau untuk menyajikan metrik Anda kepada tim atau pengunjung Anda. Grafana secara otomatis menskalakan dasbor ke resolusi apa pun, yang membuatnya sempurna untuk layar besar. Anda dapat mengakses fitur daftar putar dari menu samping Grafana di submenu **Dasbor**.

## Mengakses, berbagi, dan mengendalikan daftar putar
<a name="v10-dash-access-share-control-playlist"></a>

Gunakan informasi di bagian ini untuk mengakses daftar putar yang ada. Mulai dan kendalikan tampilan daftar putar menggunakan salah satu dari lima mode yang tersedia.

**Untuk mengakses daftar putar**

1. Pilih **Daftar Putar** dari menu sebelah kiri.

1. Pilih daftar putar dari daftar putar yang ada.

**Memulai daftar putar**

Anda dapat memulai daftar putar dalam lima mode tampilan berbeda. Mode tampilan menentukan bagaimana menu dan bilah navigasi muncul di dasbor.

Secara default, setiap dasbor ditampilkan untuk jumlah waktu yang dimasukkan di bidang **Interval**, yang Anda atur saat membuat atau mengedit daftar putar. Setelah Anda memulai daftar putar, Anda dapat mengontrolnya dengan bilah navigasi di bagian atas halaman.

**Untuk memulai daftar putar**

1. Akses halaman daftar putar untuk melihat daftar putar yang ada.

1. Temukan daftar putar yang ingin Anda mulai, lalu klik **Mulai daftar putar**.

   Kotak dialog daftar putar mulai akan terbuka.

1. Pilih salah satu dari lima mode daftar putar yang tersedia berdasarkan informasi dalam tabel berikut.

1. Klik **Mulai**<playlist name>.

Daftar putar menampilkan setiap dasbor untuk waktu yang ditentukan di `Interval` bidang, diatur saat membuat atau mengedit daftar putar. Setelah daftar putar dimulai, Anda dapat mengontrolnya menggunakan bilah navigasi di bagian atas layar Anda.


| Modus | Deskripsi | 
| --- | --- | 
| Modus normal |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/v10-dash-managing-playlists.html)  | 
| Modus TV |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/v10-dash-managing-playlists.html)  | 
| Mode TV (dengan panel auto fit) |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/v10-dash-managing-playlists.html)  | 
| Mode kios |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/v10-dash-managing-playlists.html)  | 
| Mode kios (dengan panel auto fit) |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/v10-dash-managing-playlists.html)  | 

**Mengontrol daftar putar**

Anda dapat mengontrol daftar putar dalam mode **Normal** atau **TV** setelah dimulai, menggunakan bilah navigasi di bagian atas layar Anda. Tekan `Esc` tombol di keyboard Anda untuk menghentikan daftar putar.


| Tombol | Tindakan | 
| --- | --- | 
| Berikutnya (panah kanan ganda) | Maju ke dasbor berikutnya. | 
| Kembali (panah kiri) | Kembali ke dasbor sebelumnya. | 
| Berhenti (persegi) | Mengakhiri daftar putar, dan keluar ke dasbor saat ini. | 
| Mode tampilan siklus (ikon monitor) | Memutar tampilan dasbor dalam mode tampilan yang berbeda. | 
| Rentang waktu | Menampilkan data dalam rentang waktu. Ini dapat diatur untuk menampilkan 5 menit terakhir hingga 5 tahun yang lalu, atau rentang waktu khusus, menggunakan panah bawah. | 
| Segarkan (panah lingkaran) | Muat ulang dasbor, untuk menampilkan data saat ini. Ini dapat diatur untuk memuat ulang secara otomatis setiap 5 detik hingga 1 hari, menggunakan panah tarik-turun. | 

## Membuat daftar putar
<a name="v10-dash-create-playlist"></a>

Anda dapat membuat daftar putar untuk menyajikan dasbor secara berurutan dengan urutan yang ditetapkan dan interval waktu antar dasbor.

**Untuk membuat daftar putar**

1. Pilih **Dasbor** dari menu kiri.

1. Pilih **Daftar Putar** di halaman daftar putar.

1. Pilih **Daftar putar baru**.

1. Masukkan nama deskriptif di kotak teks **Nama**.

1. Masukkan interval waktu di kotak teks **Interval**. Dasbor yang Anda tambahkan tercantum dalam urutan berurutan.

1. Di **Dasbor**, tambahkan dasbor yang ada ke daftar putar menggunakan opsi tarik-turun **Tambahkan berdasarkan judul** dan **Tambahkan berdasarkan tag**.

1. Opsional:
   + Cari dasbor dengan namanya, ekspresi reguler, atau tag.
   + Filter hasil Anda berdasarkan status atau tag berbintang.
   + Atur ulang urutan dasbor yang telah Anda tambahkan menggunakan ikon panah atas dan bawah.
   + Hapus dasbor dari daftar putar dengan mengklik ikon **x** di samping dasbor.

1. Pilih **Simpan** untuk menyimpan perubahan Anda.

## Menyimpan daftar putar
<a name="v10-dash-save-playlist"></a>

Anda dapat menyimpan daftar putar dan menambahkannya ke halaman **Daftar Putar** Anda, tempat Anda dapat memulainya.

**penting**  
Pastikan semua dasbor yang ingin Anda tampilkan di daftar putar ditambahkan saat membuat atau mengedit daftar putar sebelum menyimpannya.

**Untuk menyimpan daftar putar**

1. Pilih **Dasbor** di menu sebelah kiri.

1. Pilih **Daftar Putar** untuk melihat daftar putar yang tersedia untuk Anda.

1. Pilih daftar putar pilihan Anda.

1. Edit daftar putar.

1. Periksa apakah daftar putar memiliki **Nama**, **Interval**, dan setidaknya satu **Dasbor** yang ditambahkan ke dalamnya.

1. Pilih **Simpan** untuk menyimpan perubahan Anda.

## Mengedit atau menghapus daftar putar
<a name="v10-dash-edit-delete-playlist"></a>

Anda dapat mengedit daftar putar dengan memperbarui namanya, interval waktu, dan dengan menambahkan, menghapus, dan mengatur ulang urutan dasbor, atau Anda dapat menghapus daftar putar.

**Untuk mengedit daftar putar**

1. Pilih **Edit daftar putar** di halaman daftar putar.

1. Perbarui nama dan interval waktu, lalu tambahkan atau hapus dasbor dari daftar putar menggunakan instruksi di Buat daftar putar, di atas.

1. Pilih **Simpan** untuk menyimpan perubahan Anda.

**Untuk menghapus daftar putar**

1. Pilih **Daftar Putar**.

1. Pilih **Hapus** di samping daftar putar yang ingin Anda hapus.

**Untuk mengatur ulang urutan dasbor dalam daftar putar**

1. Di sebelah dasbor yang ingin Anda pindahkan, klik panah atas atau bawah.

1. Pilih **Simpan** untuk menyimpan perubahan Anda.

**Untuk menghapus dasbor**

1. Pilih **Hapus** untuk menghapus dasbor dari daftar putar.

1. Pilih **Simpan** untuk menyimpan perubahan Anda.

## Berbagi daftar putar dalam mode tampilan
<a name="v10-dash-share-playlist-view-mode"></a>

Anda dapat membagikan daftar putar dengan menyalin alamat tautan pada mode tampilan yang Anda inginkan, dan menempelkan URL ke tujuan Anda.

**Untuk berbagi daftar putar dalam mode tampilan**

1. Dari menu sisi kiri **Dasbor**, pilih Daftar **Putar**.

1. Pilih **Mulai daftar putar di samping daftar** putar yang ingin Anda bagikan.

1. Di dropdown, klik kanan mode tampilan yang Anda inginkan.

1. Pilih **Salin Alamat Tautan** untuk menyalin URL ke clipboard Anda.

1. Tempel URL ke tujuan Anda.

# Berbagi dasbor dan panel
<a name="v10-dash-sharing"></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)

Grafana memungkinkan Anda untuk berbagi dasbor dan panel dengan pengguna lain dalam suatu organisasi dan dalam situasi tertentu, secara publik di Web. Anda dapat berbagi menggunakan:
+ Tautan langsung
+ Sebuah snapshot
+ Tautan ekspor (hanya untuk dasbor)

Anda harus memiliki izin penampil resmi untuk melihat gambar yang diberikan oleh tautan langsung.

Saat Anda membagikan panel atau dasbor sebagai snapshot, snapshot (yang merupakan panel atau dasbor saat Anda mengambil snapshot) tersedia untuk umum di web. Siapa pun yang memiliki tautan ke sana dapat mengaksesnya. Karena snapshot tidak memerlukan otorisasi apa pun untuk melihat, Grafana menghapus informasi yang terkait dengan akun asalnya, serta data sensitif apa pun dari snapshot.

## Berbagi dasbor
<a name="v10-dash-share-dashboard"></a>

Anda dapat membagikan dasbor sebagai tautan langsung atau sebagai snapshot. Anda juga dapat mengekspor dasbor.

**catatan**  
Jika Anda mengubah dasbor, pastikan Anda menyimpan perubahan sebelum berbagi.

**Untuk Berbagi dasbor**

1. Pilih **Dasbor** dari menu kiri di ruang kerja Anda.

1. Pilih dasbor yang ingin Anda bagikan.

1. Pilih ikon bagikan di bagian atas layar.

   Kotak dialog berbagi terbuka dan menampilkan tab **Tautan**.

**Berbagi tautan langsung**

Tab **Link** menunjukkan rentang waktu saat ini, variabel template, dan tema default. Anda juga dapat membagikan URL yang dipersingkat.

**Untuk berbagi tautan langsung**

1. Pilih **Salin**. Tindakan ini menyalin URL default atau singkat ke clipboard.

1. Kirim URL yang disalin ke pengguna Grafana dengan otorisasi untuk melihat tautan.

**Menerbitkan snapshot**

Snapshot dasbor membagikan dasbor interaktif secara publik. Grafana menghapus data sensitif seperti kueri (metrik, templat, dan anotasi) dan tautan panel, hanya menyisakan data metrik yang terlihat dan nama seri yang disematkan di dasbor. Snapshot dasbor dapat diakses oleh siapa saja yang memiliki tautan.

Anda dapat mempublikasikan snapshot ke instans lokal Anda.

**Untuk mempublikasikan snapshot**

1. Pilih tab **Snapshot**.

1. Pilih **Snapshot Lokal**.

1. Grafana menghasilkan tautan snapshot. Salin tautan snapshot, dan bagikan di dalam organisasi Anda atau secara publik di web.

**Mengekspor dasbor**

Dasbor Grafana dapat dengan mudah diekspor dan diimpor. Untuk informasi selengkapnya, lihat bagian impor dan ekspor di[Membangun dasbor](v10-dash-building-dashboards.md).

## Berbagi panel
<a name="v10-dash-share-panel"></a>

Anda dapat berbagi panel sebagai tautan langsung, atau sebagai snapshot. Anda juga dapat membuat panel perpustakaan menggunakan opsi **Bagikan** pada panel apa pun.

**Untuk berbagi panel**

1. Pilih judul panel panel yang ingin Anda bagikan. Menu panel terbuka.

1. Pilih **Bagikan**. Kotak dialog berbagi akan terbuka dan menampilkan tab **Tautan**.

**Menggunakan tautan langsung**

Tab **Link** menunjukkan rentang waktu saat ini, variabel template, dan tema default. Anda dapat mengaktifkan URL singkat untuk dibagikan secara opsional.

**Untuk menggunakan tautan langsung**

1. Pilih **Salin** untuk menyalin default atau URL singkat ke clipboard. 

1. Kirim URL yang disalin ke pengguna Grafana dengan otorisasi untuk melihat tautan.

**Menerbitkan snapshot panel**

Snapshot panel adalah bagian dari panel interaktif secara publik. Grafana menghapus data sensitif hanya menyisakan data metrik yang terlihat dan nama seri yang tertanam di dasbor. Snapshot panel dapat diakses oleh siapa saja yang memiliki tautan.

Anda dapat mempublikasikan snapshot ke instans lokal Anda.

**Untuk mempublikasikan snapshot panel**

1. Di kotak dialog **Share Panel**, pilih tab **Snapshot**.

1. Pilih **Snapshot Lokal**. Grafana menghasilkan tautan snapshot.

1. Salin tautan snapshot, dan bagikan di dalam organisasi Anda atau secara publik di web.

Jika Anda membuat snapshot secara tidak sengaja, klik **Hapus snapshot untuk menghapus snapshot** dari instance Grafana Anda.

**Membuat panel perpustakaan**

Untuk membuat panel pustaka dari kotak dialog **Share Panel**.

**Untuk membuat panel perpustakaan**

1. Pilih **panel Perpustakaan**.

1. Di **nama panel Perpustakaan**, masukkan nama.

1. Di **Simpan dalam folder**, pilih folder untuk menyimpan panel perpustakaan. Secara default, folder root dipilih.

1. Pilih **Buat panel perpustakaan** untuk menyimpan perubahan Anda.

1. Simpan dasbor.

# Variabel
<a name="v10-dash-variables"></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)

Variabel adalah placeholder untuk suatu nilai. Anda dapat menggunakan variabel dalam kueri metrik dan judul panel. Jadi saat Anda mengubah nilainya, menggunakan dropdown di bagian atas dasbor, kueri metrik panel Anda akan berubah untuk mencerminkan nilai baru.

Variabel memungkinkan Anda membuat dasbor yang lebih interaktif dan dinamis. Alih-alih hard-coding hal-hal seperti server, aplikasi, dan nama sensor dalam kueri metrik Anda, Anda dapat menggunakan variabel di tempatnya. Variabel ditampilkan sebagai daftar dropdown di bagian atas dasbor. Dropdown ini memudahkan untuk mengubah data yang ditampilkan di dasbor Anda.

Ini bisa sangat berguna bagi administrator yang ingin mengizinkan pemirsa Grafana menyesuaikan visualisasi dengan cepat tetapi tidak ingin memberi mereka izin pengeditan penuh. Grafana Viewers dapat menggunakan variabel.

Variabel dan template juga memungkinkan Anda untuk dasbor sumber tunggal. Jika Anda memiliki beberapa sumber data atau server yang identik, Anda dapat membuat satu dasbor dan menggunakan variabel untuk mengubah apa yang Anda lihat. Ini sangat menyederhanakan pemeliharaan dan pemeliharaan.

**Template**

Template adalah kueri yang berisi variabel. Misalnya, jika Anda mengelola dasbor untuk memantau beberapa server, Anda dapat membuat dasbor untuk setiap server, atau Anda dapat membuat satu dasbor dan menggunakan panel dengan kueri templat, seperti berikut ini.

```
wmi_system_threads{instance=~"$server"}
```

<varname>Nilai variabel selalu disinkronkan ke URL menggunakan sintaks var- =value.

**Contoh**

Variabel tercantum dalam daftar dropdown di bagian atas layar. Pilih variabel yang berbeda untuk melihat bagaimana visualisasi berubah.

Untuk melihat pengaturan variabel, navigasikan ke **Pengaturan Dasbor > Variabel**. Klik variabel dalam daftar untuk melihat pengaturannya.

Variabel dapat digunakan dalam judul, deskripsi, panel teks, dan kueri. Kueri dengan teks yang dimulai dengan `$` adalah template. Tidak semua panel akan memiliki kueri template.

**Praktik terbaik variabel**
+ Daftar dropdown variabel ditampilkan dalam urutan mereka tercantum dalam daftar variabel di pengaturan **Dashboard**.
+ Letakkan variabel yang akan sering Anda ubah di bagian atas, sehingga akan ditampilkan terlebih dahulu (paling kiri di dasbor).
+ Variabel memilih nilai paling atas dalam daftar dropdown secara default. Jika Anda ingin memilih nilai kosong sebagai gantinya, ubah pengaturan variabel, sebagai berikut:

  1. Pilih kotak centang **Sertakan Semua Opsi**.

  1. Di bidang **Kustom semua nilai**, masukkan nilai`+`.

**Topics**
+ [Menambahkan dan mengelola variabel](v10-dash-variable-add.md)
+ [Periksa Variabel](v10-dash-variable-add-inspect.md)
+ [Sintaks variabel](v10-dash-variable-syntax.md)

# Menambahkan dan mengelola variabel
<a name="v10-dash-variable-add"></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)

Tabel berikut mencantumkan jenis variabel di Grafana.


| Jenis variabel | Deskripsi | 
| --- | --- | 
| Kueri | Daftar nilai yang dihasilkan kueri seperti nama metrik, nama server, sensor IDs, pusat data, dan sebagainya. | 
| Khusus | Tentukan opsi variabel secara manual menggunakan daftar yang dipisahkan koma. | 
| Kotak teks | Menampilkan kolom input teks gratis dengan nilai default opsional. | 
| Konstan | Tentukan konstanta tersembunyi. | 
| Sumber data | Ubah sumber data dengan cepat untuk seluruh dasbor. | 
| Interval | Variabel interval mewakili rentang waktu. | 
| Filter ad hoc | Filter nilai kunci yang secara otomatis ditambahkan ke semua kueri metrik untuk sumber data (Prometheus, Loki, InfluxDB, dan Elasticsearch saja). | 
| Variabel global | Variabel bawaan yang dapat digunakan dalam ekspresi di editor kueri. | 
| Variabel yang dirantai | Kueri variabel dapat berisi variabel lain. | 

**Topics**
+ [Memasuki opsi Umum](#v10-dash-variable-options)
+ [Menambahkan variabel kueri](#v10-dash-variable-add-query)
+ [Menambahkan variabel kustom](#v10-dash-variable-add-custom)
+ [Menambahkan variabel kotak teks](#v10-dash-variable-add-text)
+ [Menambahkan variabel konstan](#v10-dash-variable-add-constant)
+ [Menambahkan variabel sumber data](#v10-dash-variable-add-datasource)
+ [Menambahkan variabel interval](#v10-dash-variable-add-internal)
+ [Menambahkan filter ad hoc](#v10-dash-variable-add-adhoc)
+ [Konfigurasikan opsi pemilihan variabel](#v10-dash-variable-add-selection)
+ [Variabel global](#v10-dash-variable-add-global)
+ [Variabel yang dirantai](#v10-dash-variable-add-chained)
+ [Kelola variabel](#v10-dash-variable-add-manage)
+ [Filter variabel dengan regex](#v10-dash-variable-add-filter)

## Memasuki opsi Umum
<a name="v10-dash-variable-options"></a>

Anda harus memasukkan opsi umum untuk semua jenis variabel yang Anda buat.

**Untuk memasukkan opsi umum**

1. Arahkan ke dasbor yang ingin Anda buat variabel dan pilih ikon **Pengaturan Dasbor** (roda gigi) di bagian atas halaman.

1. Pada tab **Variables**, pilih **Variabel baru**.

1. Masukkan **Nama** untuk variabel.

1. Dalam daftar **Type**, pilih **Query**.

1. (Opsional) Di **Label**, masukkan nama tampilan dropdown variabel.

   Jika Anda tidak memasukkan nama tampilan, maka label dropdown adalah nama variabel.

1. Pilih opsi **Sembunyikan**:
   + **Tidak ada pilihan (kosong)** - Variabel dropdown menampilkan variabel **Nama** atau nilai **Label**.
   + **Label** - Variabel dropdown hanya menampilkan nilai variabel yang dipilih dan panah bawah.
   + **Variabel** - Tidak ada dropdown variabel yang ditampilkan di dasbor.

## Menambahkan variabel kueri
<a name="v10-dash-variable-add-query"></a>

Variabel kueri memungkinkan Anda menulis kueri sumber data yang dapat mengembalikan daftar nama metrik, nilai tag, atau kunci. Misalnya, variabel kueri mungkin mengembalikan daftar nama server, sensor IDs, atau pusat data. Nilai variabel berubah saat mereka secara dinamis mengambil opsi dengan kueri sumber data.

Variabel kueri umumnya hanya didukung untuk string. Jika kueri Anda mengembalikan angka atau tipe data lainnya, Anda mungkin perlu mengonversinya menjadi string untuk menggunakannya sebagai variabel. Untuk sumber data Azure, misalnya, Anda dapat menggunakan fungsi [tostring](https://docs.microsoft.com/en-us/azure/data-explorer/kusto/query/tostringfunction) untuk tujuan ini.

Ekspresi kueri dapat berisi referensi ke variabel lain dan pada dasarnya membuat variabel terkait. Grafana mendeteksi ini dan secara otomatis menyegarkan variabel ketika salah satu variabel tertaut berubah.

**catatan**  
Ekspresi kueri berbeda untuk setiap sumber data. Untuk informasi selengkapnya, lihat dokumentasi untuk [sumber data](AMG-data-sources.md) Anda.

**Untuk menambahkan variabel kueri**

1. Masukkan opsi umum, seperti di atas.

1. Dalam daftar **Sumber data**, pilih sumber data target untuk kueri.

1. Dalam daftar **Refresh**, pilih kapan variabel harus memperbarui opsi.
   + **On Dashboard Load** — Query sumber data setiap kali dashboard dimuat. Ini memperlambat pemuatan dasbor, karena kueri variabel perlu diselesaikan sebelum dasbor dapat diinisialisasi.
   + **Perubahan Rentang Waktu** — Menanyakan sumber data saat rentang waktu dasbor berubah. Hanya gunakan opsi ini jika kueri opsi variabel Anda berisi filter rentang waktu atau bergantung pada rentang waktu dasbor.

1. Di bidang **Query**, masukkan kueri.
   + Bidang kueri bervariasi sesuai dengan sumber data Anda. Beberapa sumber data memiliki editor kueri khusus.
   + Query harus mengembalikan nilai bernama `__text` dan`__value`. Misalnya, di SQL, Anda dapat menggunakan kueri seperti`SELECT hostname AS __text, id AS __value from MyTable`. Kueri untuk bahasa lain akan bervariasi tergantung pada sintaks.
   + Jika Anda membutuhkan lebih banyak ruang dalam editor kueri bidang input tunggal, arahkan kursor Anda ke garis di sudut kanan bawah bidang dan seret ke bawah untuk memperluas.

1. (Opsional) Di bidang **Regex**, ketik ekspresi regex untuk memfilter atau menangkap bagian tertentu dari nama yang dikembalikan oleh kueri sumber data Anda. Untuk melihat contoh, lihat [Filter variabel dengan regex](#v10-dash-variable-add-filter).

1. Dalam daftar **Urutkan**, pilih urutan pengurutan untuk nilai yang akan ditampilkan dalam daftar dropdown. Opsi default, **Dinonaktifkan**, berarti urutan opsi yang dikembalikan oleh kueri sumber data Anda akan digunakan.

1. (Opsional) Masukkan [Pilihan Pilihan](#v10-dash-variable-add-selection).

1. Di **Pratinjau nilai**, Grafana menampilkan daftar nilai variabel saat ini. Tinjau mereka untuk memastikan mereka sesuai dengan apa yang Anda harapkan.

1. Pilih **Tambah** untuk menambahkan variabel ke dasbor.

## Menambahkan variabel kustom
<a name="v10-dash-variable-add-custom"></a>

Gunakan variabel *kustom* untuk nilai yang tidak berubah, seperti angka atau string.

Misalnya, jika Anda memiliki nama server atau nama Wilayah yang tidak pernah berubah, Anda mungkin ingin membuatnya sebagai variabel kustom daripada variabel kueri. Karena mereka tidak berubah, Anda dapat menggunakannya dalam [variabel berantai daripada variabel](#v10-dash-variable-add-chained) kueri lainnya. Itu akan mengurangi jumlah kueri yang harus dikirim Grafana ketika variabel berantai diperbarui.

**Untuk menambahkan variabel kustom**

1. Masukkan opsi umum, seperti di atas.

1. Dalam daftar **Nilai dipisahkan oleh koma**, masukkan nilai untuk variabel ini dalam daftar yang dipisahkan koma. Anda dapat menyertakan angka, string, atau pasangan kunci-nilai yang dipisahkan oleh spasi dan titik dua. Misalnya, `key1 : value1,key2 : value2`.

1. (Opsional) Masukkan [Pilihan Pilihan](#v10-dash-variable-add-selection).

1. Di **Pratinjau nilai**, Grafana menampilkan daftar nilai variabel saat ini. Tinjau mereka untuk memastikan mereka sesuai dengan apa yang Anda harapkan.

1. Pilih **Tambah** untuk menambahkan variabel ke dasbor.

## Menambahkan variabel kotak teks
<a name="v10-dash-variable-add-text"></a>

Variabel *kotak teks* menampilkan bidang input teks gratis dengan nilai default opsional. Ini adalah variabel yang paling fleksibel, karena Anda dapat memasukkan nilai apa pun. Gunakan jenis variabel ini jika Anda memiliki metrik dengan kardinalitas tinggi atau jika Anda ingin memperbarui beberapa panel di dasbor secara bersamaan.

**Untuk menambahkan variabel kotak teks**

1. Masukkan opsi umum, seperti di atas.

1. (Opsional) Di bidang **Nilai default**, pilih nilai default untuk variabel. Jika Anda tidak memasukkan apa pun di bidang ini, Grafana menampilkan kotak teks kosong bagi pengguna untuk mengetik teks.

1. Di **Pratinjau nilai**, Grafana menampilkan daftar nilai variabel saat ini. Tinjau mereka untuk memastikan mereka sesuai dengan apa yang Anda harapkan.

1. Pilih **Tambah** untuk menambahkan variabel ke dasbor.

## Menambahkan variabel konstan
<a name="v10-dash-variable-add-constant"></a>

Variabel *konstan* memungkinkan Anda untuk menentukan konstanta tersembunyi. Ini berguna untuk awalan jalur metrik untuk dasbor yang ingin Anda bagikan. Saat Anda mengekspor dasbor, variabel konstan dikonversi ke opsi impor.

Variabel konstan *tidak* fleksibel. Setiap variabel konstan hanya memiliki satu nilai, dan tidak dapat diperbarui kecuali Anda memperbarui pengaturan variabel.

Variabel konstan berguna ketika Anda memiliki nilai kompleks yang perlu Anda sertakan dalam kueri tetapi tidak ingin mengetik ulang di setiap kueri. Misalnya, jika Anda memiliki jalur server yang disebut`i-0b6a61efe2ab843gg`, maka Anda bisa menggantinya dengan variabel yang disebut`$path_gg`.

**Untuk menambahkan variabel konstan**

1. Masukkan opsi umum, seperti di atas.

1. Di bidang **Nilai**, masukkan nilai variabel. Anda dapat memasukkan huruf, angka, dan simbol. Anda bahkan dapat menggunakan wildcard jika Anda menggunakan [format mentah](v10-dash-variable-syntax.md#v10-dash-variable-syntax-raw).

1. Di **Pratinjau nilai**, Grafana menampilkan daftar nilai variabel saat ini. Tinjau mereka untuk memastikan mereka sesuai dengan apa yang Anda harapkan.

1. Pilih **Tambah** untuk menambahkan variabel ke dasbor.

## Menambahkan variabel sumber data
<a name="v10-dash-variable-add-datasource"></a>

Variabel *sumber data* memungkinkan Anda mengubah sumber data dengan cepat untuk seluruh dasbor. Mereka berguna jika Anda memiliki beberapa contoh sumber data, mungkin di lingkungan yang berbeda.

**Untuk menambahkan variabel sumber data**

1. Masukkan opsi umum, seperti di atas.

1. Dalam daftar **Jenis**, pilih sumber data target untuk variabel.

   Anda juga dapat memilih **Buka pemilih sumber data lanjutan** untuk melihat opsi lainnya, termasuk menambahkan sumber data (Khusus admin). Untuk informasi selengkapnya, lihat [Connect ke sumber data](AMG-data-sources.md).

1. (Opsional) Dalam **filter nama Instance**, masukkan filter regex untuk contoh sumber datanya untuk dipilih dalam daftar dropdown nilai variabel. Biarkan bidang ini kosong untuk menampilkan semua instance.

1. (Opsional) Masukkan [Pilihan Pilihan](#v10-dash-variable-add-selection).

1. Di **Pratinjau nilai**, Grafana menampilkan daftar nilai variabel saat ini. Tinjau mereka untuk memastikan mereka sesuai dengan apa yang Anda harapkan.

1. Pilih **Tambah** untuk menambahkan variabel ke dasbor.

## Menambahkan variabel interval
<a name="v10-dash-variable-add-internal"></a>

Gunakan variabel *interval* untuk mewakili rentang waktu seperti`1m`,`1h`, atau`1d`. Anda dapat menganggapnya sebagai *grup di seluruh dasbor berdasarkan* perintah waktu. Variabel interval mengubah cara data dikelompokkan dalam visualisasi. Anda juga dapat menggunakan Opsi Otomatis untuk mengembalikan sejumlah titik data per rentang waktu.

Anda dapat menggunakan variabel interval sebagai parameter untuk mengelompokkan berdasarkan waktu (untuk InfluxDB), interval histogram tanggal (untuk Elasticsearch), atau sebagai parameter fungsi ringkasan (untuk Grafit).

**Untuk menambahkan variabel interval**

1. Masukkan opsi umum, seperti di atas.

1. Di bidang **Nilai**, masukkan interval rentang waktu yang ingin Anda tampilkan di daftar dropdown variabel. Unit waktu berikut didukung:`s (seconds)`,,`m (minutes)`,`h (hours)`, `d (days)``w (weeks)`,`M (months)`, dan`y (years)`. Anda juga dapat menerima atau mengedit nilai default:`1m,10m,30m,1h,6h,12h,1d,7d,14d,30d`.

1. (Opsional) Nyalakan **Opsi Otomatis** jika Anda ingin menambahkan `auto` opsi ke daftar. Opsi ini memungkinkan Anda untuk menentukan berapa kali rentang waktu saat ini harus dibagi untuk menghitung rentang `auto` waktu saat ini. Jika Anda menyalakannya, maka dua opsi lagi muncul:
   + **Jumlah langkah** - Pilih berapa kali rentang waktu saat ini akan dibagi untuk menghitung nilainya, mirip dengan opsi kueri **poin data Maks**. Misalnya, jika rentang waktu yang terlihat saat ini adalah 30 menit, maka `auto` interval mengelompokkan data menjadi 30 peningkatan satu menit. Nilai default adalah 30 langkah.
   + **Interval Min** — Ambang minimum di bawah mana interval hitungan langkah tidak akan membagi waktu. Untuk melanjutkan contoh 30 menit, jika interval minimum diatur ke 2m, maka Grafana akan mengelompokkan data menjadi 15 kenaikan dua menit.

1. Di **Pratinjau nilai**, Grafana menampilkan daftar nilai variabel saat ini. Tinjau mereka untuk memastikan mereka sesuai dengan apa yang Anda harapkan.

1. Pilih **Tambah** untuk menambahkan variabel ke dasbor.

**Contoh variabel interval**

Contoh berikut menunjukkan variabel template `myinterval` dalam fungsi Graphite:

```
summarize($myinterval, sum, false)
```

## Menambahkan filter ad hoc
<a name="v10-dash-variable-add-adhoc"></a>

Filter *ad hoc memungkinkan Anda menambahkan filter* nilai kunci yang secara otomatis ditambahkan ke semua kueri metrik yang menggunakan sumber data yang ditentukan. Tidak seperti variabel lain, Anda tidak menggunakan filter ad hoc dalam kueri. Sebagai gantinya, Anda menggunakan filter ad hoc untuk menulis filter untuk kueri yang ada.

**catatan**  
Variabel filter ad hoc hanya berfungsi dengan sumber data Prometheus, Loki, InfluxDB, dan Elasticsearch.

1. Masukkan opsi umum, seperti di atas.

1. Dalam daftar **Sumber data**, pilih sumber data target.

   Anda juga dapat memilih **Buka pemilih sumber data lanjutan** untuk melihat opsi lainnya, termasuk menambahkan sumber data (Khusus admin). Untuk informasi selengkapnya, lihat [Connect ke sumber data](AMG-data-sources.md).

1. Pilih **Tambah** untuk menambahkan variabel ke dasbor.

**Buat filter ad hoc**

Filter ad hoc adalah salah satu opsi variabel paling kompleks dan fleksibel yang tersedia. Alih-alih daftar opsi variabel reguler, variabel ini memungkinkan Anda membuat kueri ad hoc di seluruh dasbor. Filter yang Anda terapkan dengan cara ini diterapkan ke semua panel di dasbor.

## Konfigurasikan opsi pemilihan variabel
<a name="v10-dash-variable-add-selection"></a>

*Pilihan Pilihan* adalah fitur yang dapat Anda gunakan untuk mengelola pilihan opsi variabel. Semua opsi pilihan adalah opsional, dan mereka mati secara default.

### Variabel multi-nilai
<a name="v10-dash-variable-add-selection-multi"></a>

Interpolasi variabel dengan beberapa nilai yang dipilih rumit karena tidak langsung bagaimana memformat beberapa nilai menjadi string yang valid dalam konteks tertentu di mana variabel digunakan. Grafana mencoba menyelesaikan ini dengan mengizinkan setiap plugin sumber data untuk memberi tahu mesin interpolasi template format apa yang akan digunakan untuk beberapa nilai.

**catatan**  
Opsi **Kustom semua nilai** pada variabel harus kosong agar Grafana memformat semua nilai menjadi satu string. Jika dibiarkan kosong, maka Grafana menggabungkan (menambahkan bersama) semua nilai dalam kueri. Misalnya, `value1,value2,value3`. Jika `all` nilai kustom digunakan, maka sebaliknya nilainya akan menjadi `*` atau`all`.

**Variabel multi-nilai dengan sumber data Grafit**

Grafit menggunakan ekspresi glob. *Variabel dengan beberapa nilai, dalam hal ini, diinterpolasi `{host1,host2,host3}` seolah-olah nilai variabel saat ini iss *host1, host2**, dan host3*.*

**Variabel multi-nilai dengan sumber data Prometheus atau InfluxDB**

InfluxDB dan Prometheus menggunakan ekspresi regex, sehingga variabel yang sama diinterpolasi sebagai. `(host1|host2|host3)` Setiap nilai juga regex lolos. Jika tidak, nilai dengan karakter kontrol regex akan merusak ekspresi regex.

**Variabel multi-nilai dengan sumber data Elastis**

Elasticsearch menggunakan sintaks kueri lucene, sehingga variabel yang sama diformat sebagai. `("host1" OR "host2" OR "host3")` Dalam hal ini, setiap nilai diloloskan sehingga nilainya hanya berisi kata-kata kontrol lucene dan tanda kutip.

**Memecahkan masalah variabel multi-nilai**

Pelarian dan pemformatan otomatis dapat menyebabkan masalah dan sulit untuk memahami logika di baliknya. Khusus untuk InfluxDB dan Prometheus di mana penggunaan sintaks regex mengharuskan variabel digunakan dalam konteks operator regex.

Jika Anda tidak ingin Grafana melakukan pelolosan dan pemformatan regex otomatis ini, maka Anda harus melakukan salah satu hal berikut:
+ Matikan **opsi **Multi-nilai** atau Sertakan Semua**.
+ Gunakan [format mentah](v10-dash-variable-syntax.md#v10-dash-variable-syntax-raw).

### Sertakan Semua opsi
<a name="v10-dash-variable-add-multi-all"></a>

Grafana menambahkan `All` opsi ke daftar dropdown variabel. Jika pengguna memilih opsi ini, maka semua opsi variabel dipilih.

### Kustom semua nilai
<a name="v10-dash-variable-add-multi-custom"></a>

Opsi ini hanya terlihat jika **opsi Sertakan Semua** dipilih.

Masukkan sintaks regex, gumpalan, atau lucene di bidang **Kustom semua nilai** untuk menentukan nilai opsi. `All`

Secara default `All` nilai mencakup semua opsi dalam ekspresi gabungan. Ini bisa menjadi sangat panjang dan dapat memiliki masalah kinerja. Terkadang lebih baik untuk menentukan nilai semua kustom, seperti regex wildcard.

Untuk memiliki sintaks regex, gumpalan, atau lucene khusus di opsi **Kustom semua nilai**, itu tidak pernah lolos sehingga Anda harus memikirkan nilai yang valid untuk sumber data Anda.

## Variabel global
<a name="v10-dash-variable-add-global"></a>

Grafana memiliki variabel bawaan global yang dapat digunakan dalam ekspresi di editor kueri. Topik ini mencantumkannya dalam urutan abjad dan mendefinisikannya. Variabel ini berguna dalam kueri, tautan dasbor, tautan panel, dan tautan data.

**\$1 \$1\$1dasbor**

Variabel ini adalah nama dasbor saat ini.

**\$1\$1\$1from dan \$1\$1\$1to**

Grafana memiliki dua variabel rentang waktu bawaan: `$__from` dan. `$__to` Mereka saat ini selalu diinterpolasi sebagai milidetik epoch secara default, tetapi Anda dapat mengontrol pemformatan tanggal.


| Sintaksis | Contoh hasil | Deskripsi | 
| --- | --- | --- | 
|  `${__from}`  |  1594671549254  |  Epoch unix milidetik  | 
|  `${__from:date}`  |  2020-07-13T 20:19:09.254 Z  |  Tidak ada argumen, default ke ISO 8601/RFC 3339  | 
|  `${__from:date:iso}`  |  2020-07-13T 20:19:09.254 Z  |  ISO 8601/RFC 3339  | 
|  `${__from:date:seconds}`  |  1594671549  |  Epoch detik Unix  | 
|  `${__from:date:YYYY-MM}`  |  2020-07  |  Format tanggal kustom apa pun yang tidak menyertakan karakter:  | 

Sintaks di atas juga berfungsi dengan`${__to}`.

**\$1 \$1\$1interval**

*Anda dapat menggunakan `$__interval` variabel sebagai parameter untuk mengelompokkan berdasarkan waktu (untuk InfluxDB, MySQL, Postgres, MSSQL), interval histogram Tanggal (untuk Elasticsearch), atau sebagai parameter fungsi ringkasan (untuk Graphite).*

Grafana secara otomatis menghitung interval yang dapat digunakan untuk mengelompokkan berdasarkan waktu dalam kueri. Ketika ada lebih banyak titik data daripada yang dapat ditampilkan pada grafik, kueri dapat dibuat lebih efisien dengan mengelompokkan dengan interval yang lebih besar. Misalnya, jika Anda melihat grafik data senilai 3 bulan, Anda mungkin tidak dapat melihat detail pada tingkat menit. Pengelompokan berdasarkan jam atau hari membuat kueri lebih efisien tanpa mempengaruhi apa yang ditunjukkan grafik. `$__interval`Itu dihitung menggunakan rentang waktu dan lebar grafik (jumlah piksel).

Perhitungan Perkiraan: `(to - from) / resolution`

Misalnya, ketika rentang waktu adalah 1 jam dan grafik layar penuh, maka interval dapat dihitung menjadi `2m` - titik dikelompokkan dalam interval 2 menit. Jika rentang waktu 6 bulan dan grafiknya layar penuh, maka intervalnya mungkin `1d` (1 hari) - poin dikelompokkan berdasarkan hari.

Dalam sumber data InfluxDB, variabel warisan `$interval` adalah variabel yang sama. `$__interval`harus digunakan sebagai gantinya.

Sumber data InfluxDB dan Elasticsearch memiliki `Group by time interval` bidang yang digunakan untuk membuat kode keras interval atau untuk menetapkan batas minimum untuk `$__interval` variabel (dengan menggunakan `>` sintaks, misalnya). `>10m`

**\$1 \$1\$1interval\$1ms**

Variabel ini adalah `$__interval` variabel dalam milidetik, bukan string yang diformat interval waktu. Misalnya, jika `$__interval` adalah `20m` maka `$__interval_ms` adalah`1200000`.

**\$1\$1\$1org**

Variabel ini adalah ID dari organisasi saat ini. `${__org.name}`adalah nama organisasi saat ini.

**\$1 \$1\$1pengguna**

`${__user.id}`adalah ID pengguna saat ini. `${__user.login}`adalah pegangan login dari pengguna saat ini. `${__user.email}`adalah email untuk pengguna saat ini.

**\$1 \$1\$1kisaran**

Hanya didukung untuk sumber data Prometheus dan Loki. Variabel ini mewakili rentang untuk dasbor saat ini. Itu dihitung oleh`to - from`. Ini memiliki milidetik dan representasi kedua disebut `$__range_ms` dan`$__range_s`.

**\$1 \$1\$1rate\$1interval**

Hanya didukung untuk sumber data Prometheus. `$__rate_interval`Variabel dimaksudkan untuk digunakan dalam fungsi laju.

**\$1 TimeFilter atau \$1 \$1\$1TimeFilter**

`$timeFilter`Variabel mengembalikan rentang waktu yang dipilih saat ini sebagai ekspresi. Misalnya, `Last 7 days` ekspresi interval rentang waktu adalah`time > now() - 7d`.

Ini digunakan di beberapa tempat, termasuk:
+ Klausul WHERE untuk sumber data InfluxDB. Grafana menambahkannya secara otomatis ke kueri InfluxDB saat dalam mode Query Editor. Anda dapat menambahkannya secara manual dalam mode Editor Teks:`WHERE $timeFilter`.
+ Kueri log Analytics di sumber data Azure Monitor.
+ Kueri SQL di MySQL, Postgres, dan MSSQL.
+ `$__timeFilter`Variabel ini digunakan dalam sumber data MySQL.

**\$1 \$1\$1zona waktu**

`$__timezone`Variabel mengembalikan zona waktu yang dipilih saat ini, baik `utc` atau entri basis data zona waktu IANA (misalnya,`America/New_York`).

Jika zona waktu yang dipilih saat ini adalah *Waktu Browser*, Grafana akan mencoba menentukan zona waktu browser Anda.

## Variabel yang dirantai
<a name="v10-dash-variable-add-chained"></a>

*Variabel berantai*, juga disebut *variabel terkait atau variabel* *bersarang, adalah variabel* kueri dengan satu atau lebih variabel lain dalam kueri variabelnya.

Kueri variabel berantai berbeda untuk setiap sumber data, tetapi premisnya sama untuk semua. Anda dapat menggunakan kueri variabel berantai di sumber data apa pun yang memungkinkan mereka.

Dasbor templat tertaut yang sangat kompleks dimungkinkan, kedalaman 5 atau 10 tingkat. Secara teknis, tidak ada batasan seberapa dalam atau kompleks Anda dapat pergi, tetapi semakin banyak tautan yang Anda miliki, semakin besar beban kueri.

**Praktik dan kiat terbaik**

Praktik berikut akan membuat dasbor dan variabel Anda lebih mudah digunakan.

**Membuat variabel terkait baru**
+ Variabel rantai membuat parent/child dependensi. Anda dapat membayangkan mereka sebagai tangga atau pohon.
+ Cara termudah untuk membuat variabel berantai baru adalah dengan menyalin variabel yang ingin Anda dasarkan pada yang baru. Dalam daftar variabel, klik ikon **variabel Duplikat** di sebelah kanan entri variabel untuk membuat salinan. Anda kemudian dapat menambahkan ke kueri untuk variabel induk.
+ Variabel baru yang dibuat dengan cara ini muncul di bagian bawah daftar. Anda mungkin perlu menyeretnya ke posisi yang berbeda dalam daftar untuk memasukkannya ke dalam urutan logis.

**Urutan variabel**

Anda dapat mengubah urutan variabel dalam daftar variabel dasbor dengan mengklik panah atas dan bawah di sisi kanan setiap entri. Grafana mencantumkan dropdown variabel dari kiri ke kanan sesuai dengan daftar ini, dengan variabel di bagian atas di paling kiri.
+ Buat daftar variabel yang tidak memiliki dependensi di bagian atas, sebelum variabel anak mereka.
+ Setiap variabel harus mengikuti salah satu yang bergantung padanya.
+ Ingat tidak ada indikasi di UI variabel mana yang memiliki hubungan ketergantungan. Buat daftar variabel dalam urutan logis untuk memudahkan pengguna lain (dan diri Anda sendiri).

**Pertimbangan kompleksitas**

Semakin banyak lapisan ketergantungan yang Anda miliki dalam variabel, semakin lama waktu yang dibutuhkan untuk memperbarui dasbor setelah Anda mengubah variabel.

Misalnya, jika Anda memiliki serangkaian empat variabel tertaut (negara, Wilayah, server, metrik) dan Anda mengubah nilai variabel root (negara), maka Grafana harus menjalankan kueri untuk semua variabel dependen sebelum memperbarui visualisasi di dasbor.

## Kelola variabel
<a name="v10-dash-variable-add-manage"></a>

Halaman variabel memungkinkan Anda menambahkan variabel dan mengelola variabel yang ada. Hal ini juga memungkinkan Anda untuk [memeriksa](v10-dash-variable-add-inspect.md) variabel dan mengidentifikasi apakah variabel sedang direferensikan (atau digunakan) dalam variabel lain atau dashboard.

**Pindah** - Anda dapat memindahkan variabel ke atas atau ke bawah daftar menggunakan drag and drop.

**Klon** - Untuk mengkloning variabel, klik ikon klon dari kumpulan ikon di sebelah kanan. Ini menciptakan salinan variabel dengan nama variabel asli yang diawali dengan`copy_of_`.

**Hapus** - Untuk menghapus variabel, klik ikon sampah dari kumpulan ikon di sebelah kanan.

## Filter variabel dengan regex
<a name="v10-dash-variable-add-filter"></a>

Menggunakan opsi Regex Query, Anda memfilter daftar opsi yang dikembalikan oleh kueri variabel atau memodifikasi opsi yang dikembalikan.

Halaman ini menunjukkan cara menggunakan regex ke filter/modify nilai dalam dropdown variabel.

Menggunakan Opsi Kueri Regex, Anda memfilter daftar opsi yang dikembalikan oleh kueri Variabel atau memodifikasi opsi yang dikembalikan. Untuk informasi selengkapnya, lihat panduan Mozilla tentang [ekspresi Reguler](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions).

Contoh berikut menunjukkan pemfilteran pada daftar opsi berikut

```
backend_01
backend_02
backend_03
backend_04
```

**Filter sehingga hanya opsi yang diakhiri dengan `01` atau `02` dikembalikan**

Regex:

```
/
(
01|02 
) 
$/
```

Hasil:

```
backend_01
backend_02
```

**Filter dan ubah opsi menggunakan grup tangkapan regex untuk mengembalikan bagian teks**

Regex:

```
/.* 
(
01|02 
)
/
```

Hasil:

```
01
02
```

**Filter dan modifikasi - Contoh Prometheus**

Untuk daftar opsi ini:

```
up{instance="demo.robustperception.io:9090",job="prometheus"} 1 1521630638000
up{instance="demo.robustperception.io:9093",job="alertmanager"} 1 1521630638000
up{instance="demo.robustperception.io:9100",job="node"} 1 1521630638000
```

Regex ini:

```
/. *instance="
(
[^"]*
)
.*/
```

Mengembalikan hasil ini:

```
demo.robustperception.io:9090
demo.robustperception.io:9093
demo.robustperception.io:9100
```

**Filter dan modifikasi menggunakan teks bernama dan grup penangkap nilai**

Menggunakan grup tangkapan bernama, Anda dapat menangkap bagian 'teks' dan 'nilai' terpisah dari opsi yang dikembalikan oleh kueri variabel. Hal ini memungkinkan daftar dropdown variabel berisi nama ramah untuk setiap nilai yang dapat dipilih.

Misalnya, saat menanyakan metrik `node_hwmon_chip_names` Prometheus, nilainya jauh lebih ramah `chip_name` daripada nilainya. `chip` Jadi hasil query variabel berikut:

```
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_0",chip_name="enp216s0f0np0"} 1
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_1",chip_name="enp216s0f0np1"} 1
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_2",chip_name="enp216s0f0np2"} 1
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_3",chip_name="enp216s0f0np3"} 1
```

Melewati Regex berikut:

```
/chip_name="(?<text>[ ^ " ] + ) |chip=" (?<value >[ ^ " ] + )/g
```

Akan menghasilkan daftar dropdown berikut:

```
Display Name          Value
------------          -------------------------
enp216s0f0np0         0000:d7:00_0_0000:d8:00_0
enp216s0f0np1         0000:d7:00_0_0000:d8:00_1
enp216s0f0np2         0000:d7:00_0_0000:d8:00_2
enp216s0f0np3         0000:d7:00_0_0000:d8:00_3
```

Hanya `text` dan `value` menangkap nama grup yang didukung.

# Periksa Variabel
<a name="v10-dash-variable-add-inspect"></a>

Halaman variabel memungkinkan Anda dengan mudah mengidentifikasi apakah variabel sedang direferensikan (atau digunakan) dalam variabel atau dasbor lain.

Setiap variabel yang direferensikan atau digunakan memiliki tanda centang hijau di sebelahnya, sementara variabel yang tidak direferensikan memiliki ikon peringatan oranye di sebelahnya. Selain itu, semua variabel yang direferensikan memiliki ikon ketergantungan di sebelah tanda centang hijau. Anda dapat memilih ikon untuk melihat peta ketergantungan. Peta ketergantungan dapat dipindahkan. Anda dapat memperbesar atau memperkecil dengan roda mouse atau yang setara.

# Sintaks variabel
<a name="v10-dash-variable-syntax"></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)

Judul panel dan kueri metrik dapat merujuk ke variabel menggunakan dua sintaks yang berbeda.
+ `$varname`— Sintaks ini mudah dibaca, tetapi tidak memungkinkan Anda untuk menggunakan variabel di tengah kata.

  **Contoh:** `apps.frontend.$server.requests.count`
+ `${var_name}`— Gunakan sintaks ini ketika Anda ingin menggunakan variabel di tengah ekspresi.
+ `${var_name:<format>}`— Format ini memberi Anda kontrol lebih besar atas bagaimana Grafana menafsirkan nilai. Untuk informasi selengkapnya, lihat *Opsi format variabel lanjutan*, mengikuti daftar ini.
+ `[[varname]]`- Jangan gunakan. Sintaks ini sudah tua dan sudah usang. Ini akan dihapus dalam rilis future.

Sebelum kueri dikirim ke sumber data Anda, kueri *diinterpolasi*, artinya variabel diganti dengan nilai saat ini. Selama interpolasi, nilai variabel mungkin *lolos* agar sesuai dengan sintaks bahasa kueri dan di mana ia digunakan. Misalnya, variabel yang digunakan dalam ekspresi regex dalam kueri InfluxDB atau Prometheus akan diloloskan regex.

**Opsi format variabel lanjutan**

Pemformatan interpolasi variabel tergantung pada sumber data, tetapi ada beberapa situasi di mana Anda mungkin ingin mengubah format default.

Misalnya, default untuk sumber data MySQL adalah menggabungkan beberapa nilai sebagai dipisahkan koma dengan tanda kutip:. `'server01','server02'` Dalam beberapa kasus, Anda mungkin ingin memiliki string yang dipisahkan koma tanpa tanda kutip:. `server01,server02` Anda dapat mewujudkannya dengan opsi pemformatan variabel lanjutan yang tercantum di bawah ini.

**Sintaks umum**

Sintaks: `${var_name:option}`

Jika ada opsi pemformatan yang tidak valid ditentukan, maka `glob` adalah opsi. default/fallback 

**CSV**

Memformat variabel dengan beberapa nilai sebagai string yang dipisahkan koma.

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:csv}'
Interpolation result:  'test1,test2'
```

**Didistribusikan - OpenTSDB**

Memformat variabel dengan beberapa nilai dalam format khusus untuk OpenTSDB.

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:distributed}'
Interpolation result:  'test1,servers=test2'
```

**Kutipan ganda**

Memformat variabel tunggal dan multi-nilai menjadi string yang dipisahkan koma, lolos `"` di setiap nilai dengan `\"` dan mengutip setiap nilai dengan. `"`

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:doublequote}'
Interpolation result:  '"test1","test2"'
```

**Glob - Grafit**

Memformat variabel dengan beberapa nilai menjadi gumpalan (untuk kueri Grafit).

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:glob}'
Interpolation result:  '{test1,test2}'
```

**JSON**

Memformat variabel dengan beberapa nilai sebagai string yang dipisahkan koma.

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:json}'
Interpolation result:  '["test1", "test2"]'
```

**Lucene - Elasticsearch**

Memformat variabel dengan beberapa nilai dalam format Lucene untuk Elasticsearch.

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:lucene}'
Interpolation result:  '("test1" OR "test2")'
```

**Kode Persentase**

Memformat variabel tunggal dan multivalued untuk digunakan dalam parameter URL.

```
servers = [ 'foo()bar BAZ',  'test2' ]
String to interpolate:  '${servers:percentencode}'
Interpolation result:  'foo%28%29bar%20BAZ%2Ctest2'
```

**Pipa**

Memformat variabel dengan beberapa nilai menjadi string yang dipisahkan pipa.

```
servers = [ 'test1.',  'test2' ]
String to interpolate:  '${servers:pipe}'
Interpolation result:  'test1.|test2'
```

**Mentah**

Menonaktifkan pemformatan khusus sumber data, seperti tanda kutip tunggal dalam kueri SQL.

```
servers = [ 'test.1',  'test2' ]
String to interpolate:  '${var_name:raw}'
Interpolation result:  'test.1,test2'
```

**Regex**

Memformat variabel dengan beberapa nilai menjadi string regex.

```
servers = [ 'test1.',  'test2' ]
String to interpolate:  '${servers:regex}'
Interpolation result:  '(test1\.|test2)'
```

**Singlequote**

Memformat variabel tunggal dan multi-nilai menjadi string yang dipisahkan koma, lolos `'` di setiap nilai dengan `\'` dan mengutip setiap nilai dengan. `'`

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:singlequote}'
Interpolation result:  "'test1','test2'"
```

**Sqlstring**

Memformat variabel tunggal dan multi-nilai menjadi string yang dipisahkan koma, lolos `'` di setiap nilai dengan `''` dan mengutip setiap nilai dengan. `'`

```
servers = [ "test'1",  "test2" ]
String to interpolate:  '${servers:sqlstring}'
Interpolation result:  "'test''1','test2'"
```

**Teks**

Memformat variabel tunggal dan multi-nilai ke dalam representasi teks mereka. Untuk satu variabel, itu hanya akan mengembalikan representasi teks. Untuk variabel multi-nilai, itu akan mengembalikan representasi teks yang digabungkan dengan`+`.

```
servers = [ "test1",  "test2" ]
String to interpolate:  '${servers:text}'
Interpolation result:  "test1 + test2"
```

**Parameter kueri**

Memformat variabel tunggal dan multi-nilai ke dalam representasi parameter kueri mereka. Contoh: `var-foo=value1&var-foo=value2`

```
servers = [ "test1",  "test2" ]
String to interpolate:  '${servers:queryparam}'
Interpolation result:  "var-servers=test1&var-servers=test2"
```

# Menilai penggunaan dasbor
<a name="v10-dash-assess-dashboard-usage"></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)

Untuk setiap dasbor dan sumber data, Anda dapat mengakses informasi penggunaan.

**Wawasan dasbor**

Untuk melihat informasi penggunaan dasbor, pilih **Wawasan dasbor** di bilah atas.

Wawasan dasbor menunjukkan informasi berikut.
+ **Statistik** — Jumlah kueri dan kesalahan harian selama 30 hari terakhir.
+ **Pengguna & aktivitas** — Jumlah tampilan harian selama 30 hari terakhir; aktivitas terakhir di dasbor dan pengguna terbaru (dengan batas 20).

**Wawasan sumber data**

Wawasan sumber data memberikan informasi tentang bagaimana sumber data telah digunakan dalam 30 hari terakhir, seperti:
+ Pertanyaan per hari
+ Kesalahan per hari
+ Waktu muat kueri per hari (dirata-ratakan dalam ms)

**Untuk menemukan wawasan sumber data**

1. Pilih **Koneksi** di navigasi utama ruang kerja Anda.

1. Pilih **Sumber data**.

1. Pilih sumber data.

1. Pilih tab **Wawasan**.

## Indikator kehadiran
<a name="v10-dash-presence-indicator"></a>

Saat Anda masuk dan melihat dasbor, Anda dapat mengetahui siapa yang melihat dasbor yang sama dengan Anda melalui indikator kehadiran, yang menampilkan avatar pengguna yang baru saja berinteraksi dengan dasbor. Jangka waktu default adalah 10 menit. Untuk melihat nama pengguna, arahkan kursor ke avatar pengguna. Avatar berasal dari [Gravatar](https://gravatar.com/) berdasarkan email pengguna.

Ketika ada lebih banyak pengguna aktif di dasbor daripada yang dapat masuk dalam indikator kehadiran, klik **ikon\$1X**. Melakukan hal ini akan membuka wawasan dasbor, yang berisi detail lebih lanjut tentang aktivitas pengguna terbaru.

## Menyortir dasbor dengan menggunakan data wawasan
<a name="v10-dash-sort-dashboards"></a>

Di tampilan penelusuran, Anda dapat menggunakan data wawasan untuk membantu menemukan dasbor yang paling sering digunakan, rusak, dan tidak digunakan. Anda dapat mengurutkan dasbor berdasarkan berikut ini.
+ Tampilan
+ Kesalahan
+ Tampilan
+ Waktu yang dibuat
+ Waktu yang diperbarui

# Memecahkan masalah dasbor
<a name="v10-dash-troubleshoot"></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)

 Gunakan strategi berikut untuk membantu Anda memecahkan masalah dasbor umum. 

## Dashboard lambat
<a name="v10-dash-dashboard-is-slow"></a>
+ Apakah Anda mencoba merender lusinan (atau ratusan atau ribuan) deret waktu pada grafik? Ini dapat menyebabkan browser tertinggal. Coba gunakan fungsi seperti `highestMax` (dalam Graphite) untuk mengurangi jumlah seri yang dikembalikan.
+ Terkadang nama seri bisa sangat besar. Ini menyebabkan ukuran respons yang lebih besar. Coba gunakan `alias` untuk mengurangi ukuran nama seri yang dikembalikan.
+ Apakah Anda menanyakan banyak deret waktu atau rentang waktu yang lama? Kedua kondisi ini dapat menyebabkan Grafana atau sumber data Anda menarik banyak data, yang dapat memperlambat dasbor. Coba kurangi salah satu atau keduanya.
+ Mungkin ada beban tinggi pada infrastruktur jaringan Anda. Jika kelambatan tidak konsisten, ini mungkin masalahnya.

## Masalah kecepatan penyegaran dasbor
<a name="v10-dash-refresh-rate-issues"></a>

Secara default, Grafana menanyakan sumber data Anda setiap 30 detik. Namun, menyetel kecepatan refresh rendah pada dasbor Anda memberi tekanan yang tidak perlu pada backend. Dalam banyak kasus, kueri ini sering tidak diperlukan karena sumber data tidak mengirim data cukup sering sehingga ada perubahan setiap 30 detik.

Sebaiknya lakukan hal berikut:
+ Hanya aktifkan penyegaran otomatis di dasbor, panel, atau variabel jika perlu. Pengguna dapat me-refresh browser mereka secara manual.
+ Jika Anda memerlukan penyegaran otomatis, maka atur kecepatan refresh ke periode waktu yang lebih lama yang masuk akal, seperti sekali dalam satu menit, setiap 10 menit, atau setiap jam.
+ Periksa rentang waktu dasbor Anda. Jika dasbor Anda memiliki rentang waktu yang lebih lama, seperti seminggu, maka Anda benar-benar tidak perlu penyegaran otomatis dan Anda harus menonaktifkannya.

## Menangani atau merender data nol salah atau membingungkan
<a name="v10-dash-handling-or-rendering-null-data-is-wrong-or-confusing"></a>

Beberapa aplikasi mempublikasikan data sebentar-sebentar; misalnya, mereka hanya memposting metrik ketika suatu peristiwa terjadi. Secara default, grafik Grafana menghubungkan garis antara titik data, tetapi ini bisa menipu.

Grafik yang memiliki opsi **Connect null values** disetel ke **Always**, akan menghubungkan garis di mana ada nilai yang hilang.

Salah satu cara untuk memperbaikinya adalah dengan menggunakan bilah alih-alih garis dan mengatur opsi **No value** (di bawah **opsi Standar**)`0`. Dalam hal ini, data yang hilang akan muncul sebagai area grafik tanpa data.

# Mencari Dasbor di Grafana versi 10
<a name="v10-search"></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 mencari dasbor berdasarkan nama dasbor dan judul panel. Saat Anda mencari dasbor, sistem mengembalikan semua dasbor yang tersedia dalam instance Grafana, bahkan jika Anda tidak memiliki izin untuk melihat konten dasbor.

## Cari dasbor menggunakan nama dasbor
<a name="v10-search-by-name"></a>

Masukkan bagian mana pun dari nama dasbor di bilah pencarian. Pencarian mengembalikan hasil untuk setiap kecocokan string sebagian secara real-time, saat Anda mengetik.

Pencarian dasbor adalah:
+ Real-time
+ *Tidak* peka huruf besar/kecil
+ Fungsional di seluruh dasbor yang disimpan dan berbasis file.

**Tip**  
Anda dapat menggunakan tombol panah keyboard untuk menavigasi hasil dan tekan `Enter` untuk membuka dasbor yang dipilih.

## Cari dasbor menggunakan judul panel
<a name="v10-search-by-title"></a>

Anda dapat mencari dasbor dengan judul panel yang muncul di dasbor. Jika judul panel cocok dengan kueri penelusuran Anda, dasbor akan muncul di hasil penelusuran.

## Filter hasil pencarian dasbor berdasarkan tag
<a name="v10-search-by-tag"></a>

Tag adalah cara yang bagus untuk mengatur dasbor Anda, terutama karena jumlah dasbor bertambah. Anda dapat menambahkan dan mengelola tag di **Pengaturan** dasbor.

Saat Anda memilih beberapa tag, Grafana menampilkan dasbor yang menyertakan semua tag yang dipilih.

Untuk memfilter hasil pencarian dasbor dengan tag, selesaikan salah satu langkah berikut:
+ Untuk memfilter hasil pencarian dasbor berdasarkan tag, pilih tag yang muncul di kolom kanan hasil pencarian.

  Anda dapat melanjutkan pemfilteran dengan memilih tag tambahan.
+ Untuk melihat daftar semua tag yang tersedia, klik menu dropdown **Filter by tags** dan pilih tag.

  Semua tag akan ditampilkan, dan ketika Anda memilih tag, pencarian dasbor akan langsung disaring.

**Tip**  
Saat hanya menggunakan keyboard, tekan `tab` tombol dan arahkan ke menu dropdown **Filter by tag**, tekan tombol panah bawah untuk mengaktifkan menu dan menemukan tag, dan tekan `Enter` untuk memilih tag.

## Palet perintah
<a name="v10-search-palette"></a>

Anda dapat menggunakan palet perintah untuk melakukan hal berikut:
+ Cari dan buka dasbor dan folder.
+ Buat dasbor dan aturan peringatan.
+ Temukan halaman dalam Grafana.
+ Ubah tema menjadi gelap atau terang.

Buka palet perintah atas, masukkan `ctrl+k` (`cmd+k`di macOS). Anda juga dapat memilih input pencarian di bilah navigasi Grafana.

**catatan**  
Untuk pergi ke langkah sebelumnya, tekan `backspace` dengan palet perintah kosong.

# Panel dan visualisasi dalam Grafana versi 10
<a name="v10-panels"></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)

*Panel* adalah blok bangunan visualisasi dasar di Grafana. Setiap panel memiliki editor kueri khusus untuk sumber data yang dipilih di panel. Editor kueri memungkinkan Anda membuat kueri yang mengembalikan data yang ingin Anda visualisasikan.

Ada berbagai macam pilihan styling dan format untuk setiap panel. Panel dapat diseret, dijatuhkan, dan diubah ukurannya untuk mengatur ulang mereka di dasbor.

Sebelum Anda menambahkan panel, pastikan Anda telah mengonfigurasi sumber data.

Jenis panel tambahan mungkin tersedia dengan menginstal [plugin tambahan ke ruang](grafana-plugins.md) kerja Anda.

Untuk detail tentang penggunaan sumber data tertentu, lihat[Connect ke sumber data](AMG-data-sources.md).

**Topics**
+ [Ikhtisar editor panel](v10-panels-editor-overview.md)
+ [Tampilan inspeksi panel](v10-panels-panel-inspector.md)
+ [Kueri dan transformasi data](v10-panels-query-xform.md)
+ [Konfigurasikan opsi panel](v10-panels-configure-panel-options.md)
+ [Konfigurasikan opsi standar](v10-panels-configure-standard-options.md)
+ [Konfigurasikan legenda](v10-panels-configure-legend.md)
+ [Konfigurasikan tautan data](v10-panels-configure-data-links.md)
+ [Konfigurasikan pemetaan nilai](v10-panels-configure-value-mappings.md)
+ [Konfigurasikan ambang batas](v10-panels-configure-thresholds.md)
+ [Konfigurasikan penggantian bidang](v10-panels-configure-overrides.md)
+ [Visualisasi tersedia dalam Grafana versi 10](v10-panels-viz.md)

# Ikhtisar editor panel
<a name="v10-panels-editor-overview"></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)

Di editor panel, Anda dapat memperbarui semua elemen visualisasi, termasuk sumber data, kueri, rentang waktu, dan opsi tampilan.

Untuk menambahkan panel ke dasbor baru, pilih **\$1 Tambahkan visualisasi** di tengah dasbor. Untuk menambahkan panel ke dasbor yang ada, pilih **Tambahkan** di header dasbor dan pilih **Visualisasi** di drop-down. Anda juga dapat menyalin dan menempelkan panel yang ada dari dasbor yang sama atau berbeda.

## Menu panel
<a name="v10-panels-editor-menu"></a>

Untuk mengakses editor panel, arahkan kursor ke sudut kanan atas panel mana pun. Pilih ikon menu panel yang muncul dan pilih **Edit**.

Menu panel juga memberi Anda akses ke tindakan berikut:
+ **Lihat** - Lihat panel di layar penuh.
+ **Edit** - Buka editor panel untuk mengedit panel dan opsi visualisasi.
+ **Bagikan** — Bagikan panel sebagai tautan, atau panel perpustakaan.
+ **Jelajahi** — Buka panel di **Jelajahi**, di mana Anda dapat fokus pada kueri Anda.
+ **Inspect** — Buka laci **Inspect**, tempat Anda dapat meninjau data panel, statistik, metadata, JSON, dan kueri.
  + **Data** — Buka laci **Inspect** di tab **Data**.
  + **Query** - Buka laci **Inspect** di tab **Query**.
  + **Panel JSON** **- Buka laci **Inspect** di tab JSON.**
+ **Ekstensi** — Akses tindakan lain yang disediakan oleh aplikasi yang diinstal, seperti mendeklarasikan insiden. Opsi ini hanya muncul jika Anda menginstal plugin aplikasi yang berkontribusi ekstensi ke menu panel.
+ **Lainnya** - Akses tindakan panel lainnya.
  + **Duplikat** — Buat salinan panel. Panel duplikat menanyakan data secara terpisah dari panel asli. Jika Anda ingin menggunakan hasil kueri yang sama, Anda dapat menggunakan sumber `Dashboard` data di panel kedua.
  + **Salin** — Salin panel ke clipboard.
  + **Buat panel pustaka** — Buat panel yang dapat diimpor ke dasbor lain.
  + **Buat peringatan** — Buka halaman konfigurasi aturan **peringatan di Peringatan, tempat Anda dapat membuat peringatan** yang [dikelola Grafana berdasarkan kueri](v10-alerts.md) panel.
  + **Sembunyikan legenda** - Sembunyikan legenda panel.
  + **Dapatkan bantuan** — Kirim snapshot atau data panel ke Grafana Labs Technical Support.
+ **Hapus** - Hapus panel dari dasbor.

## Editor panel
<a name="v10-panels-editor-view"></a>

Bagian ini menjelaskan area editor panel Grafana.
+ Header panel - Bagian header mencantumkan dasbor tempat panel muncul dan kontrol berikut:
  + **Buang** — Buang perubahan yang telah Anda buat pada panel sejak terakhir kali Anda menyimpan dasbor.
  + **Simpan** - Menyimpan perubahan yang Anda buat ke panel.
  + **Terapkan - Menerapkan** perubahan yang Anda buat dan menutup editor panel, mengembalikan Anda ke dasbor. Anda harus menyimpan dasbor untuk mempertahankan perubahan yang diterapkan.
+ Pratinjau visualisasi - Bagian pratinjau visualisasi berisi opsi berikut:
  + **Tampilan tabel** - Ubah visualisasi apa pun ke tabel sehingga Anda dapat melihat datanya. Tampilan tabel sangat membantu untuk pemecahan masalah. Tampilan ini hanya berisi data mentah. Ini tidak termasuk transformasi yang mungkin telah Anda terapkan pada data atau opsi pemformatan yang tersedia dalam visualisasi [Tabel](v10-panels-table.md).
  + **Isi - Pratinjau** visualisasi mengisi ruang yang tersedia. Jika Anda mengubah lebar panel samping atau tinggi panel bawah, visualisasi berubah untuk mengisi ruang yang tersedia.
  + **Aktual** - Pratinjau visualisasi akan memiliki ukuran yang tepat seperti ukuran di dasbor. Jika tidak cukup ruang yang tersedia, visualisasi akan mengurangi menjaga rasio aspek.
  + **Kontrol rentang waktu** — **Default** adalah zona waktu lokal browser atau zona waktu yang dipilih pada tingkat yang lebih tinggi.
+ Bagian data — Bagian data berisi tab tempat Anda memasukkan kueri, mengubah data, dan membuat aturan peringatan (jika berlaku).
  + **Tab kueri** — Pilih sumber data Anda dan masukkan kueri di sini. Untuk informasi selengkapnya, lihat [Kueri dan transformasi data](v10-panels-query-xform.md). Saat Anda pertama kali membuat dasbor, Anda diminta untuk memilih sumber data. Anda dapat memperbarui sumber data atau kueri di tab ini.
  + **Tab Transform** - Terapkan transformasi data. Untuk informasi selengkapnya, lihat [Kueri dan transformasi data](v10-panels-query-xform.md).
  + **Tab peringatan** - Tulis aturan peringatan. Untuk informasi selengkapnya, lihat [Peringatan di Grafana versi 10](v10-alerts.md).
+ Opsi tampilan panel - Bagian opsi tampilan berisi tab tempat Anda mengonfigurasi hampir setiap aspek visualisasi data Anda. Detailnya bervariasi berdasarkan jenis visualisasi yang dipilih.

## Panel memeriksa laci
<a name="v10-panels-editor-inspect"></a>

Laci inspeksi membantu Anda memahami dan memecahkan masalah panel Anda. Anda dapat melihat data mentah untuk panel apa pun, mengekspor data tersebut ke file nilai yang dipisahkan koma (CSV), melihat permintaan kueri, dan mengekspor panel dan data JSON.

**catatan**  
Tidak semua jenis panel menyertakan semua tab. Misalnya, panel daftar dasbor tidak memiliki data mentah untuk diperiksa, sehingga tidak menampilkan tab Statistik, Data, atau Kueri.

Inspektur panel terdiri dari opsi-opsi berikut:
+ Panel memeriksa tampilan laci sebagai laci di sisi kanan. Pilih panah di sudut kanan atas untuk memperluas atau mengurangi panel laci.
+ **Tab data** - Menampilkan data mentah yang dikembalikan oleh kueri dengan transformasi yang diterapkan. Opsi bidang seperti penggantian dan pemetaan nilai tidak diterapkan secara default.
+ **Tab Statistik** - Menunjukkan berapa lama kueri Anda dan berapa banyak yang dikembalikan.
+ **Tab JSON** - Memungkinkan Anda untuk melihat dan menyalin panel JSON, panel data JSON, dan struktur bingkai data JSON. Ini berguna jika Anda menyediakan atau mengelola Grafana.
+ **Tab kueri** — Menampilkan permintaan ke server yang dikirim saat Grafana menanyakan sumber data.
+ **Tab kesalahan** - Menampilkan kesalahan yang dikembalikan oleh kueri. Tab hanya terlihat ketika kueri mengembalikan kesalahan.

# Tampilan inspeksi panel
<a name="v10-panels-panel-inspector"></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)

Tampilan inspeksi panel, yang dapat Anda buka melalui menu panel, membantu Anda memahami dan memecahkan masalah panel Anda. Anda dapat memeriksa data mentah untuk panel Grafana Terkelola Amazon, mengekspor data tersebut ke file nilai yang dipisahkan koma (CSV), melihat permintaan kueri, serta mengekspor panel dan data JSON.

**catatan**  
Tidak semua jenis panel menyertakan semua tab. Misalnya, panel daftar dasbor tidak memiliki data mentah untuk diperiksa, sehingga tidak menampilkan tab Statistik, Data, atau Kueri.

Inspektur panel terdiri dari opsi-opsi berikut:

1. Inspektur panel menampilkan **Inspect:** di bagian atas panel. Pilih panah di sudut kanan atas untuk memperluas atau mengurangi panel.

1. **Tab data** - Menampilkan data mentah yang dikembalikan oleh kueri dengan transformasi yang diterapkan. Opsi bidang seperti penggantian dan pemetaan nilai tidak diterapkan secara default.

1. **Tab Statistik** - Menunjukkan berapa lama kueri Anda dan berapa banyak yang dikembalikan.

1. **Tab JSON** - Memungkinkan Anda untuk melihat dan menyalin panel JSON, panel data JSON, dan struktur bingkai data JSON. Ini berguna jika Anda menyediakan atau mengelola Grafana.

1. **Tab kueri** — Menampilkan permintaan yang dikirim ke server saat Grafana menanyakan sumber data.

1. **Tab kesalahan** - Menampilkan kesalahan apa pun. Hanya terlihat ketika kueri mengembalikan kesalahan.

## Mengunduh hasil kueri mentah
<a name="v10-panels-raw-query-results"></a>

Grafana yang Dikelola Amazon menghasilkan file CSV yang berisi data Anda, termasuk transformasi apa pun pada data tersebut. Anda dapat memilih untuk melihat data sebelum atau setelah panel menerapkan opsi bidang atau penggantian opsi bidang.

**Untuk mengunduh hasil kueri mentah**

1. Edit panel yang berisi data kueri yang ingin Anda unduh.

1. Di editor kueri, pilih **Query Inspector**.

1. Pilih **Data**.

   Jika panel Anda berisi beberapa kueri atau kueri beberapa node, maka Anda memiliki opsi tambahan.
   + **Pilih hasil** - Pilih data set hasil yang ingin Anda lihat.
   + **Mengubah data**
   + **Bergabung berdasarkan waktu** - Lihat data mentah dari semua kueri Anda sekaligus, satu set hasil per kolom. Pilih judul kolom untuk menyusun ulang data.

1. Untuk melihat data sebelum sistem menerapkan penggantian bidang, pilih sakelar Data yang **diformat.**

1. Untuk mengunduh file CSV yang diformat khusus untuk Excel, pilih tombol **Unduh untuk Excel**.

1. Pilih **Unduh CSV**.

## Memeriksa kinerja kueri
<a name="v10-panels-query-performance"></a>

Tab **Statistik** menampilkan statistik yang memberi tahu Anda berapa lama kueri Anda, berapa banyak kueri yang Anda kirim, dan jumlah baris yang dikembalikan. Informasi ini dapat membantu Anda memecahkan masalah pertanyaan Anda, terutama jika ada angka yang tiba-tiba tinggi atau rendah.

**Untuk memeriksa kinerja kueri**

1. Edit panel yang berisi kueri dengan kinerja yang ingin Anda periksa.

1. Di editor kueri, pilih **Query Inspector**.

1. Pilih **Statistik.**

Statistik ditampilkan dalam format read-only.

## Memeriksa permintaan dan respons kueri
<a name="v10-panels-query-request-response"></a>

Anda dapat memeriksa permintaan kueri dan data respons saat ingin memecahkan masalah kueri yang mengembalikan hasil yang tidak terduga, atau gagal mengembalikan hasil yang diharapkan.

1. Edit panel yang berisi kueri yang ingin Anda ekspor.

1. Di editor kueri, pilih **Query Inspector**.

1. Pilih **Segarkan**.

   Panel diisi dengan data respons.

1. Lakukan penyesuaian, seperlunya dan jalankan kembali kueri.

1. Untuk mengunduh permintaan kueri dan data respons, klik ikon **Salin ke clipboard** dan tempel hasilnya ke aplikasi lain.

# Kueri dan transformasi data
<a name="v10-panels-query-xform"></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)

Grafana yang Dikelola Amazon mendukung banyak jenis sumber [data](AMG-data-sources.md). *Kueri* sumber data mengembalikan data yang *dapat* diubah dan divisualisasikan Grafana. Setiap sumber data menggunakan bahasa kueri sendiri, dan plugin sumber data masing-masing menerapkan antarmuka pengguna yang membangun kueri yang disebut editor kueri.

**Topics**
+ [Tentang pertanyaan](#v10-panels-query-xform-about)
+ [Menavigasi tab kueri](#v10-panels-query-xform-navigate)
+ [Menambahkan kueri](#v10-panels-query-xform-add)
+ [Kelola kueri](#v10-panels-query-xform-manage)
+ [Opsi kueri](#v10-panels-query-xform-options)
+ [Tulis kueri ekspresi](v10-panels-query-xform-expressions.md)
+ [Bagikan hasil kueri dengan panel lain](v10-panels-query-share.md)
+ [Mengubah data](v10-panels-xform.md)
+ [Memecahkan masalah kueri](v10-panels-query-troubleshoot.md)
+ [Jenis perhitungan](v10-panels-calculation-types.md)

## Tentang pertanyaan
<a name="v10-panels-query-xform-about"></a>

Panel Grafana berkomunikasi dengan sumber data melalui kueri, yang mengambil data untuk visualisasi. Query adalah pertanyaan yang ditulis dalam bahasa query yang digunakan oleh sumber data.

Anda dapat mengonfigurasi frekuensi kueri dan batas pengumpulan data dalam opsi sumber data panel. Grafana mendukung hingga 26 kueri per panel.

Anda dapat menemukan informasi selengkapnya tentang bahasa kueri setiap sumber [data di bagian Sumber data](AMG-data-sources.md).

**Editor kueri**

Setiap *editor kueri* sumber data menyediakan antarmuka pengguna yang disesuaikan yang membantu Anda menulis kueri yang memanfaatkan kemampuan uniknya.

Karena perbedaan antara bahasa kueri, setiap editor kueri sumber data terlihat dan berfungsi secara berbeda. Bergantung pada sumber data Anda, editor kueri mungkin menyediakan fitur pelengkapan otomatis, nama metrik, saran variabel, atau antarmuka pembuatan kueri visual.

Untuk detail tentang fitur editor kueri unik sumber data tertentu, termasuk informasi tentang kueri dan sintaks, lihat dokumentasi sumber data:
+ Untuk sumber data yang disertakan dengan Grafana Terkelola Amazon, lihat Sumber [data bawaan](AMG-data-sources-builtin.md).
+ Untuk sumber data yang disertakan dengan Grafana Enterprise, lihat. [Connect ke sumber data Enterprise](AMG-data-sources-enterprise.md)
+ Untuk plugin sumber data lain yang Anda instal melalui[Temukan plugin dengan katalog plugin](grafana-plugins.md#plugin-catalog), dokumentasi ditautkan dalam daftar di katalog plugin.

**Sintaks kueri**

Sumber data menggunakan bahasa kueri yang berbeda untuk meminta data. Untuk detail tentang bahasa kueri unik sumber data tertentu, lihat dokumentasinya.

**Contoh PostgreSQL:**

```
SELECT hostname FROM host WHERE region IN($region)
```

**Contoh PromQL:**

```
query_result(max_over_time(<metric>[${__range_s}s]) != <state>)
```

**Sumber data khusus**

**Grafana juga mencakup tiga sumber data khusus: **Grafana**, **Campuran**, dan Dasbor.** Untuk informasi selengkapnya, lihat [Connect ke sumber data](AMG-data-sources.md).

## Menavigasi tab kueri
<a name="v10-panels-query-xform-navigate"></a>

Tab **Query** panel terdiri dari elemen-elemen berikut:
+ **Pemilih sumber data** - Memilih sumber data untuk kueri.
+ **Opsi kueri** - Menetapkan parameter pengambilan data maksimum dan interval waktu menjalankan kueri.
+ **Tombol inspektur kueri** — Membuka panel inspektur kueri, tempat Anda dapat melihat dan mengoptimalkan kueri Anda.
+ **Daftar editor kueri** - Daftar kueri yang telah Anda tulis.
+ **Ekspresi** - Menggunakan pembuat ekspresi untuk membuat ekspresi peringatan. Untuk informasi selengkapnya tentang ekspresi, lihat[Tulis kueri ekspresi](v10-panels-query-xform-expressions.md).

## Menambahkan kueri
<a name="v10-panels-query-xform-add"></a>

Kueri mengembalikan data yang divisualisasikan Grafana di panel dasbor. Saat Anda membuat panel, Grafana secara otomatis memilih sumber data default.

**Untuk menambahkan kueri**

1. Edit panel tempat Anda menambahkan kueri.

1. Pilih tab **Kueri**.

1. Pilih menu tarik-turun **Sumber data** dan pilih sumber data.

1. Pilih **opsi Kueri** untuk mengonfigurasi jumlah maksimum titik data yang Anda butuhkan. Untuk informasi selengkapnya tentang opsi kueri, lihat[Opsi kueri](#v10-panels-query-xform-options).

1. Tulis kueri menggunakan editor kueri.

1. Pilih **Terapkan**.

Grafana menanyakan sumber data dan memvisualisasikan data.

## Kelola kueri
<a name="v10-panels-query-xform-manage"></a>

Grafana mengatur kueri dalam baris kueri yang dapat dilipat. Setiap baris kueri berisi editor kueri dan diidentifikasi dengan huruf (A, B, C, dan sebagainya).

Untuk mengelola kueri, Anda dapat menyalin kueri, menyembunyikan kueri, menghapus kueri, menyusun ulang kueri, dan beralih bantuan untuk editor kueri.

## Opsi kueri
<a name="v10-panels-query-xform-options"></a>

Pilih **Opsi kueri** di sebelah pemilih sumber data untuk melihat pengaturan sumber data yang dipilih. Perubahan yang Anda buat di sini hanya memengaruhi kueri yang dibuat di panel ini.

Grafana menetapkan default yang ditampilkan dalam teks abu-abu gelap. Perubahan ditampilkan dalam teks putih. Untuk mengembalikan bidang ke pengaturan default, hapus teks putih dari bidang.

Opsi kueri sumber data panel meliputi:
+ **Titik data maksimum** - Jika sumber data mendukungnya, ini menetapkan jumlah maksimum titik data untuk setiap seri yang dikembalikan. Jika kueri mengembalikan lebih banyak titik data daripada pengaturan titik data maks, maka sumber data mengurangi jumlah poin yang dikembalikan dengan menggabungkannya bersama dengan rata-rata, maks, atau fungsi lain.

  Anda dapat membatasi jumlah poin untuk meningkatkan kinerja kueri atau menghaluskan garis yang divisualisasikan. Nilai default adalah lebar (atau jumlah piksel) grafik, karena Anda hanya dapat memvisualisasikan titik data sebanyak panel grafik memiliki ruang untuk ditampilkan.

  Dengan streaming data, Grafana menggunakan nilai titik data maksimal untuk buffer bergulir. Streaming adalah aliran data yang berkelanjutan, dan buffering membagi aliran menjadi beberapa bagian.
+ **Interval min** - Menetapkan batas minimum untuk interval yang dihitung secara otomatis, yang biasanya merupakan interval pengikisan minimum. Jika titik data disimpan setiap 15 detik, Anda tidak mendapat manfaat dari interval yang lebih rendah dari itu. Anda juga dapat mengatur ini ke minimum yang lebih tinggi daripada interval scrape untuk mengambil kueri yang lebih kasar dan berfungsi dengan baik.
+ **Interval** - Menetapkan rentang waktu yang dapat Anda gunakan saat menggabungkan atau mengelompokkan titik data berdasarkan waktu.

  Grafana secara otomatis menghitung interval yang sesuai yang dapat Anda gunakan sebagai variabel dalam kueri templat. Variabel diukur dalam detik (`$__interval`) atau milidetik (`$__interval_ms`).

  Interval biasanya digunakan dalam fungsi agregasi seperti jumlah atau rata-rata. Misalnya, ini adalah kueri Prometheus yang menggunakan variabel interval:. `rate(http_requests_total[$__interval])`

  Interval otomatis ini dihitung berdasarkan lebar grafik. Saat pengguna memperkecil visualisasi, interval tumbuh, menghasilkan agregasi yang lebih kasar. Demikian juga, jika pengguna memperbesar, intervalnya berkurang, menghasilkan agregasi yang lebih halus.

  Untuk informasi selengkapnya, lihat [Variabel global](v10-dash-variable-add.md#v10-dash-variable-add-global).
+ **Waktu relatif** — Mengganti rentang waktu relatif untuk panel individu, yang menyebabkannya berbeda dari yang dipilih di pemilih waktu dasbor di sudut kanan atas dasbor. Anda dapat menggunakan ini untuk menampilkan metrik dari periode waktu atau hari yang berbeda di dasbor yang sama.
**catatan**  
Penggantian waktu panel tidak berpengaruh ketika rentang waktu dasbor mutlak.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/v10-panels-query-xform.html)
+ **Pergeseran waktu** — Mengganti rentang waktu untuk panel individu dengan menggeser awal dan akhir relatif terhadap pemilih waktu. Misalnya, Anda dapat menggeser rentang waktu panel menjadi dua jam lebih awal dari pemilih waktu dasbor.
**catatan**  
Penggantian waktu panel tidak berpengaruh ketika rentang waktu dasbor mutlak.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/v10-panels-query-xform.html)
+ Batas **waktu cache** — *(Terlihat hanya jika tersedia di sumber data)* Mengganti batas waktu cache default jika toko deret waktu Anda memiliki cache kueri. Tentukan nilai ini sebagai nilai numerik dalam hitungan detik.

# Tulis kueri ekspresi
<a name="v10-panels-query-xform-expressions"></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)

Ekspresi sisi server memungkinkan Anda memanipulasi data yang dikembalikan dari kueri dengan matematika dan operasi lainnya. Ekspresi membuat data baru dan tidak memanipulasi data yang dikembalikan oleh sumber data.

## Tentang ekspresi
<a name="v10-panels-query-about"></a>

Ekspresi sisi server memungkinkan Anda memanipulasi data yang dikembalikan dari kueri dengan matematika dan operasi lainnya. Ekspresi membuat data baru dan tidak memanipulasi data yang dikembalikan oleh sumber data, selain dari beberapa restrukturisasi data kecil untuk membuat input data yang dapat diterima untuk ekspresi.

**Menggunakan ekspresi**

Ekspresi paling sering digunakan oleh peringatan [Grafana](v10-alerts.md). Pemrosesan dilakukan sisi server, sehingga ekspresi dapat beroperasi tanpa sesi browser. Namun, ekspresi juga dapat digunakan dengan sumber data backend dan visualisasi.

**catatan**  
Ekspresi tidak berfungsi dengan peringatan dasbor lama.

Ekspresi dimaksudkan untuk menambah sumber data dengan memungkinkan kueri dari sumber data yang berbeda untuk digabungkan atau dengan menyediakan operasi yang tidak tersedia di sumber data.

**catatan**  
Jika memungkinkan, Anda harus melakukan pemrosesan data di dalam sumber data. Menyalin data dari penyimpanan ke server Grafana untuk diproses tidak efisien, sehingga ekspresi ditargetkan pada pemrosesan data ringan.

Ekspresi bekerja dengan kueri sumber data yang mengembalikan deret waktu atau data numerik. Mereka juga beroperasi pada data [multi-dimensi](getting-started-grafanaui.md#time-series-dimensions). Misalnya, kueri yang mengembalikan beberapa seri, di mana setiap seri diidentifikasi oleh label atau tag.

Ekspresi individu mengambil satu atau lebih kueri atau ekspresi lain sebagai input dan menambahkan data ke hasilnya. Setiap ekspresi atau kueri individu diwakili oleh variabel yang merupakan pengidentifikasi bernama yang dikenal sebagai ReFID-nya (misalnya, huruf `A` default atau). `B`

Untuk mereferensikan output dari ekspresi individu atau kueri sumber data dalam ekspresi lain, pengidentifikasi ini digunakan sebagai variabel.

**Jenis ekspresi**

Ekspresi bekerja dengan dua jenis data.
+ Koleksi deret waktu.
+ Kumpulan angka, di mana setiap nomor adalah item.

Setiap koleksi dikembalikan dari kueri atau ekspresi sumber data tunggal dan diwakili oleh ReFID. Setiap koleksi adalah satu set, di mana setiap item dalam set diidentifikasi secara unik oleh dimensinya yang disimpan sebagai [label](getting-started-grafanaui.md#labels) atau pasangan nilai kunci.

**Kueri sumber data**

Ekspresi sisi server hanya mendukung kueri sumber data untuk sumber data backend. Data umumnya diasumsikan diberi label data deret waktu. 

Kueri sumber data, bila digunakan dengan ekspresi, dijalankan oleh mesin ekspresi. Ketika melakukan ini, ia merestrukturisasi data menjadi satu deret waktu atau satu angka per frame data. Jadi misalnya jika menggunakan sumber data yang mengembalikan beberapa seri pada satu bingkai dalam tampilan tabel, Anda mungkin melihat itu terlihat berbeda saat dijalankan dengan ekspresi.

Saat ini, satu-satunya format seri non-waktu (angka) yang didukung saat menggunakan bingkai data adalah Anda memiliki respons tabel yang mengembalikan bingkai data tanpa waktu, kolom string, dan satu kolom angka:

Contoh tabel berikut menghasilkan angka yang bekerja dengan ekspresi. Kolom string menjadi label dan kolom nomor nilai yang sesuai. Misalnya `{"Loc": "MIA", "Host": "A"}` dengan nilai 1.


| Loc | Host | AVG\$1CPU | 
| --- | --- | --- | 
| MIA | A | 1 | 
| NYC | B | 2 | 

**Operasi**

Anda dapat menggunakan operasi berikut dalam ekspresi: matematika, kurangi, dan sampel ulang.

**Matematika**

Matematika adalah untuk rumus matematika bentuk bebas pada deret waktu atau data angka. Operasi matematika mengambil angka dan deret waktu sebagai masukan dan mengubahnya menjadi angka dan deret waktu yang berbeda.

Data dari kueri atau ekspresi lain direferensikan dengan awalan ReFID dengan tanda dolar, misalnya. `$A` Jika variabel memiliki spasi dalam nama, maka Anda dapat menggunakan sintaks kurung kurung seperti. `${my variable}`

Konstanta numerik bisa dalam desimal (`2.24`), oktal (dengan nol terkemuka seperti`072`), atau hex (dengan seperti 0x terkemuka). `0x2A` Eksponensial dan tanda juga didukung (misalnya,). `-0.8e-2`

**Operator**

Operator aritmatika (`+`, biner dan unary`-`,,`*`,`/`,`%`, eksponen`**`), relasional (,`<`,,,`>`,`<=`) `==``!=`, `>=` dan logis (,, dan unary) `&&` didukung`||`. `!`

Bagaimana operasi berperilaku dengan data tergantung pada apakah itu adalah data angka atau deret waktu.

Dengan operasi biner`$A || $B`, seperti `$A + $B` atau, operator diterapkan dengan cara berikut tergantung pada jenis data:
+ Jika keduanya `$A` dan `$B` merupakan angka, maka operasi dilakukan antara dua angka.
+ Jika satu variabel adalah angka, dan variabel lainnya adalah deret waktu, maka operasi antara nilai setiap titik dalam deret waktu dan angka dilakukan.
+ Jika keduanya `$A` dan `$B` merupakan data deret waktu, maka operasi antara setiap nilai dalam dua seri dilakukan untuk setiap cap waktu yang ada di keduanya `$A` dan`$B`. `Resample`Operasi ini dapat digunakan untuk menyusun stempel waktu.

Ringkasan:
+ Nomor <Operation>nomor = angka
+ Nomor <Operation>seri = seri
+ Seri <Operation>seri = seri

Karena ekspresi bekerja dengan beberapa seri atau angka yang diwakili oleh satu variabel, operasi biner juga melakukan penyatuan (gabungan) antara dua variabel. Ini dilakukan berdasarkan label pengenal yang terkait dengan setiap seri atau nomor individu.

Jadi jika Anda memiliki angka dengan label seperti `{host=web01}` in `$A` dan nomor lain `$B` dengan label yang sama maka operasi dilakukan antara dua item dalam setiap variabel, dan hasilnya akan berbagi label yang sama. Aturan untuk perilaku serikat ini adalah sebagai berikut:
+ Item tanpa label akan bergabung dengan apa pun.
+ Jika keduanya `$A` dan `$B` masing-masing hanya berisi satu item (satu seri, atau satu nomor), mereka akan bergabung.
+ Jika label sama persis, mereka akan bergabung.
+ Jika label adalah bagian dari yang lain, misalnya item di `$A` diberi label `{host=A,dc=MIA}` dan item di `$B` diberi label, `{host=A}` mereka akan bergabung.
+ Jika dalam variabel seperti `$A` ada kunci tag yang berbeda untuk setiap item, perilaku bergabung tidak terdefinisi.

Operator relasional dan logis mengembalikan 0 untuk false 1 untuk true.

**Fungsi Matematika**

Sementara sebagian besar fungsi ada dalam operasi ekspresi sendiri, operasi matematika memang memiliki beberapa fungsi yang mirip dengan operator matematika atau simbol. Ketika fungsi dapat mengambil angka atau seri, dari jenis yang sama dengan argumen akan dikembalikan. Ketika itu adalah seri, operasi dilakukan untuk nilai setiap titik dalam seri.

*perut*

abs mengembalikan nilai absolut dari argumennya yang dapat berupa angka atau seri. Misalnya, `abs(-1)` atau `abs($A)`.

*is\$1inf*

is\$1inf mengambil angka atau seri dan mengembalikan `1` `Inf` nilai (negatif atau positif) dan `0` untuk nilai lainnya. Sebagai contoh, `is_inf($A)`.

**catatan**  
Jika Anda perlu secara khusus memeriksa ketidakterbatasan negatif misalnya, Anda dapat melakukan perbandingan seperti`$A == infn()`.

*is\$1nan*

is\$1nan mengambil angka atau seri dan mengembalikan `1` `NaN` nilai dan `0` nilai lainnya. Sebagai contoh, `is_nan($A)`. Fungsi ini diperlukan untuk pemeriksaan ini karena `NaN` tidak sama dengan`NaN`.

*adalah\$1null*

is\$1null mengambil angka atau seri dan mengembalikan `1` `null` nilai dan nilai lainnya`0`. Sebagai contoh, `is_null($A)`.

*is\$1number*

is\$1number mengambil angka atau seri dan mengembalikan `1` untuk semua nilai bilangan real dan `0` untuk nilai lainnya (yaitu`null`,, `Inf+``Inf-`, dan`NaN`). Sebagai contoh, `is_number($A)`.

*log*

Log mengembalikan logaritma natural dari argumennya yang dapat berupa angka atau seri. Jika nilainya kurang dari 0, `NaN` dikembalikan. Misalnya, `log(-1)` atau `log($A)`.

*inf, infn, nan, dan null*

Fungsi inf, infn, nan, dan null semuanya mengembalikan satu nilai nama. Mereka terutama ada untuk pengujian. Contoh:`null()`.

*bulat*

Round mengembalikan nilai integer bulat. Misalnya, `round(3.123)` atau `round($A)`.

*ceil*

Ceil membulatkan angka ke nilai integer terdekat. Misalnya, `ceil(3.123)` mengembalikan `4`.

*lantai*

Lantai membulatkan angka ke bawah ke nilai integer terdekat. Misalnya,`floor(3.123`) kembali`3`.

**Mengurangi**

Reduce mengambil satu atau lebih deret waktu yang dikembalikan dari kueri atau ekspresi dan mengubah setiap seri menjadi satu nomor. Label deret waktu disimpan sebagai label pada setiap angka yang dikurangi yang dikeluarkan.

*Bidang:*
+ **Fungsi — Fungsi** reduksi yang digunakan
+ **Input** - Variabel (ReFID (seperti`A`)) untuk sampel ulang
+ **Mode** - Memungkinkan perilaku kontrol fungsi reduksi ketika seri berisi nilai non-numerik (null, NaN, \$1-Inf)

**Fungsi Reduksi**

*Hitungan*

Hitung mengembalikan jumlah poin di setiap seri.

*Berarti*

Mean mengembalikan total semua nilai dalam setiap seri dibagi dengan jumlah poin dalam seri itu. Dalam `strict` mode jika ada nilai dalam seri nol atau nan, atau jika seri kosong, NaN dikembalikan.

*Min dan Max*

Min dan Max mengembalikan nilai terkecil atau terbesar dalam seri masing-masing. Dalam `strict` mode jika ada nilai dalam seri nol atau nan, atau jika seri kosong, NaN dikembalikan.

*Jumlah*

Jumlah mengembalikan total semua nilai dalam seri. Jika seri memiliki panjang nol, jumlahnya akan menjadi 0. Dalam `strict` mode jika ada nilai NaN atau Null dalam seri, NaN dikembalikan.

*Terakhir*

Terakhir mengembalikan nomor terakhir dalam seri. Jika seri tidak memiliki nilai maka kembali NaN.

**Mode Pengurangan**

*Ketat*

Dalam mode Ketat, seri input diproses apa adanya. Jika ada nilai dalam seri non-numerik (null, NaN atau \$1-Inf), NaN dikembalikan.

*Jatuhkan Non-Numerik*

Dalam mode ini semua nilai non-numerik (null, NaN atau \$1-Inf) dalam seri input disaring sebelum menjalankan fungsi reduksi.

*Ganti Non-Numerik*

Dalam mode ini semua nilai non-numerik diganti dengan nilai yang telah ditentukan sebelumnya.

**Sampel ulang**

Sampel ulang mengubah stempel waktu di setiap deret waktu agar memiliki interval waktu yang konsisten. Kasus penggunaan utama adalah agar Anda dapat mengambil sampel ulang deret waktu yang tidak berbagi stempel waktu yang sama sehingga matematika dapat dilakukan di antara mereka. Ini dapat dilakukan dengan mengambil sampel ulang masing-masing dari dua seri, dan kemudian dalam operasi Matematika yang merujuk variabel sampel ulang.

*Bidang:*
+ **Input** - Variabel data deret waktu (ReFID (seperti`A`)) untuk sampel ulang
+ **Sampel ulang** ke — Durasi waktu untuk melakukan resample ke, misalnya. `10s` Unit bisa `s` untuk detik, `m` menit, `h` berjam-jam, `d` berhari-hari, `w` berminggu-minggu, dan `y` bertahun-tahun.
+ **Downsample** - Fungsi reduksi untuk digunakan ketika ada lebih dari satu titik data per sampel jendela. Lihat operasi reduksi untuk detail perilaku.
+ **Upsample** — Metode yang digunakan untuk mengisi sampel jendela yang tidak memiliki titik data.
  + **pad** diisi dengan nilai knowm terakhir
  + **isi ulang** dengan nilai yang diketahui berikutnya
  + **fillna** untuk mengisi jendela sampel kosong dengan NaNs

## Tulis ekspresi
<a name="v10-panels-query-write"></a>

Jika sumber data Anda mendukungnya, Grafana menampilkan tombol **Ekspresi dan menampilkan ekspresi** yang ada dalam daftar editor kueri.

**Untuk menulis ekspresi**

1. Buka panelnya.

1. Di bawah kueri, pilih **Ekspresi**.

1. Di bidang **Operasi**, pilih jenis ekspresi yang ingin Anda tulis.

1. Tulis ekspresinya.

1. Pilih **Terapkan**.

## Kasus khusus
<a name="v10-panels-query-special"></a>

Ketika sumber data yang ditanyakan tidak mengembalikan seri atau angka, mesin ekspresi kembali`NoData`. Misalnya, jika permintaan berisi dua kueri sumber data yang digabungkan dengan ekspresi, jika `NoData` dikembalikan oleh setidaknya salah satu kueri sumber data, maka hasil yang dikembalikan untuk seluruh kueri adalah. `NoData` Untuk informasi selengkapnya tentang cara Grafana Alerting memproses `NoData` hasil, lihat. [Konfigurasikan aturan peringatan terkelola Grafana](v10-alerting-configure-grafanamanaged.md)

Dalam kasus menggunakan ekspresi pada beberapa kueri, mesin ekspresi mengharuskan semua kueri mengembalikan stempel waktu yang identik. Misalnya, jika menggunakan matematika untuk menggabungkan hasil beberapa kueri SQL yang digunakan masing-masing`SELECT NOW() AS "time"`, ekspresi hanya akan berfungsi jika semua kueri mengevaluasi `NOW()` ke stempel waktu yang identik, yang tidak selalu terjadi. Untuk mengatasi hal ini, Anda dapat mengganti `NOW()` dengan waktu sewenang-wenang, seperti`SELECT 1 AS "time"`, atau stempel waktu UNIX valid lainnya.

# Bagikan hasil kueri dengan panel lain
<a name="v10-panels-query-share"></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)

Grafana memungkinkan Anda menggunakan hasil kueri dari satu panel untuk panel lain di dasbor. Berbagi hasil kueri di seluruh panel mengurangi jumlah kueri yang dibuat ke sumber data Anda, yang dapat meningkatkan kinerja dasbor Anda.

Sumber data *Dasbor* memungkinkan Anda memilih panel di dasbor yang berisi kueri yang ingin Anda bagikan hasilnya. Alih-alih mengirim kueri terpisah untuk setiap panel, Grafana mengirim satu kueri dan panel lainnya menggunakan hasil kueri untuk membangun visualisasi.

Strategi ini dapat secara drastis mengurangi jumlah kueri yang dibuat ketika Anda misalnya memiliki beberapa panel yang memvisualisasikan data yang sama.

**Untuk berbagi hasil kueri**

1. [Buat dasbor](v10-dash-creating.md).

1. Ubah judul menjadi`Source panel`. Anda akan menggunakan panel ini sebagai sumber untuk panel lainnya.

1. Tentukan kueri atau kueri yang ingin Anda bagikan.

   Jika Anda tidak memiliki sumber data yang tersedia, gunakan sumber data **Grafana**, yang mengembalikan deret waktu acak yang dapat Anda gunakan untuk pengujian.

1. Tambahkan panel kedua dan pilih sumber data **Dasbor** di editor kueri.

1. Dalam **daftar Gunakan hasil dari panel**, pilih panel pertama yang Anda buat.

Semua query didefinisikan dalam panel sumber sekarang tersedia untuk panel baru. Kueri yang dibuat di panel sumber dapat dibagikan dengan beberapa panel.

Anda dapat mengklik salah satu kueri untuk pergi ke panel tempat mereka ditentukan.

# Mengubah data
<a name="v10-panels-xform"></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)

Transformasi adalah cara ampuh untuk memanipulasi data yang dikembalikan oleh kueri sebelum sistem menerapkan visualisasi. Menggunakan transformasi, Anda dapat:
+ Ganti nama bidang
+ Bergabunglah dengan data deret waktu
+ Lakukan operasi matematika di seluruh kueri
+ Gunakan output dari satu transformasi sebagai masukan ke transformasi lain

Untuk pengguna yang mengandalkan beberapa tampilan dari kumpulan data yang sama, transformasi menawarkan metode yang efisien untuk membuat dan memelihara banyak dasbor.

Anda juga dapat menggunakan output dari satu transformasi sebagai masukan ke transformasi lain, yang menghasilkan peningkatan kinerja.

**catatan**  
Terkadang sistem tidak dapat membuat grafik data yang ditransformasikan. Ketika itu terjadi, klik tombol **Tampilan tabel** di atas visualisasi untuk beralih ke tampilan tabel data. Ini dapat membantu Anda memahami hasil akhir dari transformasi Anda.

## Jenis transformasi
<a name="v10-panels-xform-types"></a>

Grafana menyediakan sejumlah cara agar Anda dapat mengubah data. Ada daftar lengkap fungsi transformasi di bawah ini.

## Urutan transformasi
<a name="v10-panels-xform-order"></a>

Ketika ada beberapa transformasi, Grafana menerapkannya dalam urutan yang terdaftar. Setiap transformasi menciptakan set hasil yang kemudian diteruskan ke transformasi berikutnya dalam pipa pemrosesan.

Urutan di mana Grafana menerapkan transformasi secara langsung berdampak pada hasil. Misalnya, jika Anda menggunakan transformasi Reduce untuk memadatkan semua hasil dari satu kolom menjadi satu nilai, maka Anda hanya dapat menerapkan transformasi ke nilai tunggal itu.

## Menambahkan fungsi transformasi ke data
<a name="v10-panels-xform-add"></a>

Langkah-langkah berikut memandu Anda dalam menambahkan transformasi ke data. Dokumentasi ini tidak menyertakan langkah-langkah untuk setiap jenis transformasi.

**Untuk menambahkan transformasi ke panel**

1. Arahkan ke panel tempat Anda ingin menambahkan satu atau lebih transformasi.

1. Arahkan kursor ke bagian mana pun dari panel untuk menampilkan menu tindakan di sudut kanan atas.

1. Dari menu tindakan pilih **Edit**.

1. Pilih tab **Transform**.

1. Pilih transformasi. Baris transformasi muncul di mana Anda mengonfigurasi opsi transformasi.

1. Untuk menerapkan transformasi lain, Pilih **Tambahkan transformasi**. Transformasi ini bekerja pada set hasil yang dikembalikan oleh transformasi sebelumnya.

## Debug transformasi
<a name="v10-panels-xform-debug"></a>

Untuk melihat input dan set hasil output transformasi, pilih ikon debug (bug) di sisi kanan baris transformasi. Ini akan menampilkan data input, dan hasil transformasi sebagai output.

Set hasil input dan output dapat membantu Anda men-debug transformasi.

## Nonaktifkan transformasi
<a name="v10-panels-xform-disable"></a>

Anda dapat menonaktifkan atau menyembunyikan transformasi dengan memilih ikon show (eye) di kanan atas baris transformasi. Ini menonaktifkan tindakan yang diterapkan dari transformasi spesifik itu dan dapat membantu mengidentifikasi masalah ketika Anda mengubah beberapa transformasi satu demi satu.

## Filter transformasi
<a name="v10-panels-xform-filter"></a>

Jika transformasi Anda menggunakan lebih dari satu kueri, Anda dapat memfilter ini, dan menerapkan transformasi yang dipilih hanya ke salah satu kueri. Untuk melakukan ini, pilih ikon filter di kanan atas baris transformasi. Ini membuka dropdown dengan daftar query yang digunakan pada panel. Dari sini, Anda dapat memilih kueri yang ingin Anda ubah.

Anda juga dapat memfilter berdasarkan anotasi (yang mencakup contoh) untuk menerapkan transformasi padanya. Ketika Anda melakukannya, daftar bidang berubah untuk mencerminkan yang ada dalam anotasi atau tooltip contoh.

Ikon filter selalu ditampilkan jika panel Anda memiliki lebih dari satu kueri atau sumber data (yaitu data panel atau anotasi), tetapi mungkin tidak berfungsi jika transformasi sebelumnya untuk menggabungkan output kueri diterapkan. Ini karena satu transformasi mengambil output dari yang sebelumnya.

## Hapus transformasi
<a name="v10-panels-xform-delete"></a>

Kami menyarankan Anda menghapus transformasi yang tidak Anda butuhkan. Saat Anda menghapus transformasi, Anda menghapus data dari visualisasi.

Prasyarat:

Identifikasi semua dasbor yang bergantung pada transformasi dan informasikan pengguna dasbor yang terkena dampak.

**Untuk menghapus transformasi**

1. Buka panel untuk mengedit.

1. Pilih tab **Transform**.

1. Pilih ikon sampah di sebelah transformasi yang ingin Anda hapus.

# Fungsi transformasi
<a name="v10-panels-xform-functions"></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 melakukan transformasi berikut pada data Anda.

## Tambahkan bidang dari perhitungan
<a name="v10-panels-xform-funcs-add"></a>

Gunakan transformasi ini untuk menambahkan bidang baru yang dihitung dari dua bidang lainnya. Setiap transformasi memungkinkan Anda menambahkan satu bidang baru.
+ **Mode** - Pilih mode:
  + **Kurangi baris** - Terapkan perhitungan yang dipilih pada setiap baris bidang yang dipilih secara independen.
  + **Operasi biner** — Terapkan operasi biner dasar (misalnya, jumlah atau kalikan) pada nilai dalam satu baris dari dua bidang yang dipilih.
  + **Operasi unary** - Terapkan operasi unary dasar pada nilai dalam satu baris dari bidang yang dipilih. Operasi yang tersedia adalah:
    + **Nilai absolut (abs)** — Mengembalikan nilai absolut dari ekspresi yang diberikan. Ini mewakili jarak dari nol sebagai angka positif.
    + **Eksponensial alami (exp)** — Mengembalikan *e* dinaikkan ke kekuatan ekspresi yang diberikan.
    + **Logaritma natural (ln)** — Mengembalikan logaritma natural dari ekspresi yang diberikan.
    + **Floor (floor)** — Mengembalikan bilangan bulat terbesar kurang dari atau sama dengan ekspresi yang diberikan.
    + **Ceiling (ceil)** — mengembalikan bilangan bulat terkecil yang lebih besar dari atau sama dengan ekspresi yang diberikan.
  + **Fungsi kumulatif** — Terapkan fungsi pada baris saat ini dan semua baris sebelumnya.
    + **Total** — Menghitung total kumulatif hingga dan termasuk baris saat ini.
    + **Mean** — Menghitung mean hingga dan termasuk baris saat ini.
  + **Fungsi jendela** - Terapkan fungsi jendela. Jendela bisa *tertinggal atau *terpusat**. Dengan jendela trailing baris saat ini akan menjadi baris terakhir di jendela. Dengan jendela tengah, jendela akan dipusatkan pada baris saat ini. Untuk ukuran jendela genap, jendela akan berada di tengah antara baris saat ini dan baris sebelumnya.
    + **Mean** — Menghitung rata-rata bergerak atau rata-rata berjalan.
    + ****— Menghitung deviasi standar bergerak.
    + **Varians** — Hitung varians bergerak.
  + **Indeks baris** - Sisipkan bidang dengan indeks baris.
+ **Nama bidang** - Pilih nama bidang yang ingin Anda gunakan dalam perhitungan untuk bidang baru.
+ **Perhitungan** - Jika Anda memilih mode **Kurangi baris**, maka bidang **Perhitungan** akan muncul. Pilih bidang untuk melihat daftar pilihan perhitungan yang dapat Anda gunakan untuk membuat bidang baru. Untuk informasi tentang perhitungan yang tersedia, lihat [Jenis perhitungan](v10-panels-calculation-types.md).
+ **Operasi** — Jika Anda memilih **operasi biner** atau mode **operasi Unary**, maka bidang **Operasi** akan muncul. Bidang ini memungkinkan Anda melakukan operasi matematika dasar pada nilai dalam satu baris dari dua bidang yang dipilih. Anda juga dapat menggunakan nilai numerik untuk operasi biner.
+ **Sebagai persentil** — Jika Anda memilih mode **indeks baris**, maka sakelar **persentil As** muncul. Sakelar ini memungkinkan Anda untuk mengubah indeks baris sebagai persentase dari jumlah total baris.
+ **Alias** — (Opsional) Masukkan nama bidang baru Anda. Jika Anda membiarkan ini kosong, maka bidang akan diberi nama agar sesuai dengan perhitungan.
+ **Ganti semua bidang** — (Opsional) Pilih opsi ini jika Anda ingin menyembunyikan semua bidang lain dan hanya menampilkan bidang terhitung Anda dalam visualisasi.

**catatan**  
Fungsi **kumulatif dan fungsi** **Jendela** saat ini dalam pratinjau publik. Grafana Labs menawarkan dukungan terbatas, dan perubahan yang melanggar mungkin terjadi sebelum fitur tersedia secara umum.

## Bidang gabungan
<a name="v10-panels-xform-funcs-concat"></a>

**Bidang gabungan**

Gunakan transformasi ini untuk menggabungkan semua bidang dari semua frame menjadi satu hasil.

Misalnya, jika Anda memiliki kueri terpisah yang mengambil data suhu dan waktu aktif (kueri A) dan indeks kualitas udara dan informasi kesalahan (kueri b), menerapkan transformasi gabungan menghasilkan kerangka data terkonsolidasi dengan semua informasi yang relevan dalam satu tampilan.

Pertimbangkan dua berikut ini.

*Kueri A:*


| Temp | Uptime | 
| --- | --- | 
| 15.4 | 1230233 | 

*Kueri B:*


| AQI | Kesalahan | 
| --- | --- | 
| 3.2 | 5 | 

Setelah Anda menggabungkan bidang, bingkai data akan menjadi:


| Temp | Uptime | AQI | Kesalahan | 
| --- | --- | --- | --- | 
| 15.4 | 1230233 | 3.2 | 5 | 

Transformasi ini menyederhanakan proses penggabungan data dari berbagai sumber, memberikan pandangan komprehensif untuk analisis dan visualisasi.

## Config dari hasil kueri
<a name="v10-panels-xform-funcs-config"></a>

**Config dari hasil kueri**

Gunakan transformasi ini untuk memilih satu kueri dan mengekstrak opsi standar seperti **Min**, **Max**, **Unit** dan **Thresholds** dan menerapkannya ke hasil kueri lainnya. Ini memungkinkan konfigurasi visualisasi dinamis, berdasarkan data yang dikembalikan oleh kueri tertentu.

**Pilihan**
+ **Query Config** - Pilih kueri yang mengembalikan data yang ingin Anda gunakan sebagai konfigurasi.
+ **Terapkan ke** - Pilih bidang atau seri yang konfigurasi harus diterapkan.
+ **Terapkan ke opsi** - Tentukan jenis bidang atau gunakan nama bidang regex, tergantung pada pilihan Anda di **Terapkan** ke.

**Tabel pemetaan lapangan**

Di bawah opsi konfigurasi, Anda akan menemukan tabel pemetaan bidang. Tabel ini mencantumkan semua bidang yang ditemukan dalam data yang dikembalikan oleh kueri konfigurasi, bersama dengan opsi **Gunakan sebagai** dan **Pilih**. Ini memberikan kontrol atas bidang pemetaan ke properti konfigurasi, dan untuk beberapa baris, ini memungkinkan Anda untuk memilih nilai mana yang akan dipilih.

Contoh berikut menunjukkan query input dan query yang digunakan sebagai konfigurasi bidang.

*Permintaan masukan*


| Waktu | Nilai | 
| --- | --- | 
| 1626178119127 | 10 | 
| 1626178119129 | 30 | 

*Kueri Config*


| Waktu | Nilai | 
| --- | --- | 
| 1626178119127 | 100 | 
| 1626178119129 | 100 | 

*Kueri keluaran (sama seperti input, tetapi sekarang dengan konfigurasi pada bidang nilai)*


| Waktu | Nilai (konfigurasi: Maks = 100) | 
| --- | --- | 
| 1626178119127 | 10 | 
| 1626178119129 | 30 | 

Setiap bidang sekarang memiliki set opsi konfigurasi maksimum. Pilihan seperti **Min**, **Max**, **Unit**, dan **Thresholds** adalah bagian dari konfigurasi lapangan. Jika diatur, mereka digunakan oleh visualisasi alih-alih opsi apa pun yang dikonfigurasi secara manual di panel opsi editor panel.

**Pemetaan nilai**

Anda juga dapat mengubah hasil kueri menjadi pemetaan nilai. Dengan opsi ini, setiap baris dalam hasil kueri konfigurasi mendefinisikan satu baris pemetaan nilai. Lihat contoh berikut ini.

*Hasil kueri Config*


| Nilai | Teks | Warna | 
| --- | --- | --- | 
| L | Rendah | biru | 
| M | Sedang | hijau | 
| H | Tinggi | merah | 

*Dalam pemetaan bidang, tentukan:*


| Bidang | Gunakan sebagai | Pilih | 
| --- | --- | --- | 
| Nilai | Pemetaan nilai/Nilai | Semua nilai | 
| Teks | Pemetaan nilai/Teks | Semua nilai | 
| Warna | Pemetaan nilai/Warna | Semua nilai | 

Grafana membangun pemetaan nilai dari hasil kueri Anda dan menerapkannya ke hasil kueri data nyata. Anda akan melihat nilai yang dipetakan dan diwarnai sesuai dengan hasil kueri konfigurasi.

## Mengkonversi jenis bidang
<a name="v10-panels-xform-funcs-convert"></a>

Gunakan transformasi ini untuk memodifikasi jenis bidang bidang yang ditentukan.

Transformasi ini memiliki opsi berikut:
+ **Bidang** - Pilih dari bidang yang tersedia.
+ **as** — Pilih FieldType untuk dikonversi ke.
  + **Numerik** — mencoba untuk membuat angka nilai.
  + **String** - akan membuat nilai string.
  + **Waktu** — mencoba mengurai nilai sebagai waktu.
    + Akan menampilkan opsi untuk menentukan DateFormat sebagai input oleh string, seperti `yyyy-mm-dd` atau`DD MM YYYY hh:mm:ss`.
  + **Boolean** - akan membuat nilai-nilai Boolean.
  + **Enum** — akan membuat nilai enum.
    + Akan menampilkan tabel untuk mengelola enum.
  + **Lainnya** — mencoba mengurai nilai sebagai json.

Misalnya pertimbangkan kueri berikut yang dapat dimodifikasi dengan memilih bidang waktu, sebagai **Waktu**, dan Format Tanggal sebagai`YYYY`.


| Waktu | Tandai | Nilai | 
| --- | --- | --- | 
| 2017-07-01 | atas | 25 | 
| 2018-08-02 | di bawah ini | 22 | 
| 2019-09-02 | di bawah ini | 29 | 
| 2020-10-04 | atas | 22 | 

Hasilnya:


| Waktu | Tandai | Nilai | 
| --- | --- | --- | 
| 2017-01-01 00:00:00 | atas | 25 | 
| 2018-01-01 00:00:00 | di bawah ini | 22 | 
| 2019-01-01 00:00:00 | di bawah ini | 29 | 
| 2020-01-01 00:00:00 | atas | 22 | 

Transformasi ini memungkinkan Anda untuk secara fleksibel menyesuaikan tipe data Anda, memastikan kompatibilitas dan konsistensi dalam visualisasi Anda.

## Ekstrak Bidang
<a name="v10-panels-xform-funcs-extract"></a>

Gunakan transformasi ini untuk memilih sumber data dan mengekstrak konten darinya dalam format yang berbeda. Transformasi ini memiliki bidang-bidang berikut:
+ **Sumber** — Pilih bidang untuk sumber data.
+ **Format** - Pilih salah satu dari berikut ini:
  + **JSON** - Parse konten JSON dari sumbernya.
  + **Pasangan kunci\$1nilai** — Parse konten dalam format `a=b` atau `c:d` dari sumber.
  + **Otomatis** — Temukan bidang secara otomatis.
+ **Ganti Semua Bidang** - (Opsional) Pilih opsi ini untuk menyembunyikan semua bidang lain dan hanya menampilkan bidang terhitung Anda dalam visualisasi.
+ **Pertahankan Waktu** - (Opsional) Hanya tersedia jika **Ganti Semua Bidang** benar. Menyimpan bidang waktu dalam output.

Pertimbangkan kumpulan data berikut:

**Contoh Dataset**


| Stempel waktu | json\$1data | 
| --- | --- | 
| 1636678740000000000 | \$1"nilai”: 1\$1 | 
| 1636678680000000000 | \$1"nilai”: 5\$1 | 
| 1636678620000000000 | \$1"nilai”: 12\$1 | 

Anda dapat menyiapkan data yang akan digunakan oleh [panel Time series](v10-panels-time-series.md) dengan konfigurasi ini:
+ Sumber: json\$1data
+ Format: JSON
  + Bidang: nilai
  + Alias: my\$1value
+ Ganti semua bidang: true
+ Pertahankan waktu: benar

Ini akan menghasilkan output sebagai berikut:

**Data yang Diubah**


| Stempel waktu | nilai\$1my\$1 | 
| --- | --- | 
| 1636678740000000000 | 1 | 
| 1636678680000000000 | 5 | 
| 1636678620000000000 | 12 | 

Dengan transformasi ini, Anda dapat mengekstrak dan memformat data dengan berbagai cara. Anda dapat menyesuaikan format ekstraksi berdasarkan kebutuhan data spesifik Anda.

## Bidang pencarian dari sumber daya
<a name="v10-panels-xform-funcs-lookup"></a>

Gunakan transformasi ini untuk memperkaya nilai bidang dengan mencari bidang tambahan dari sumber eksternal.

Transformasi ini memiliki bidang-bidang berikut:
+ **Bidang** - Pilih bidang teks dari kumpulan data Anda.
+ **Pencarian** — Pilih dari **Negara, Negara** **Bagian AS**, dan **Bandara**.

**catatan**  
Transformasi ini hanya mendukung data spasial.

Misalnya, jika Anda memiliki data ini:

**Contoh Dataset**


| Lokasi | Nilai | 
| --- | --- | 
| AL | 0 | 
| AK | 10 | 
| Arizona | 5 | 
| Arkansas | 1 | 
| Di suatu tempat | 5 | 

Dengan konfigurasi ini:
+ Bidang: lokasi
+ Pencarian: Amerika Serikat

Anda akan mendapatkan output sebagai berikut:

**Data yang Diubah**


| Lokasi | ID | Nama | Lng | Lat | Nilai | 
| --- | --- | --- | --- | --- | --- | 
| AL | AL | Alabama | -80.891064 | 12.448457 | 0 | 
| AK | AK | Arkansas | -100.891064 | 24.448457 | 10 | 
| Arizona |  |  |  |  | 5 | 
| Arkansas |  |  |  |  | 1 | 
| Di suatu tempat |  |  |  |  | 5 | 

Transformasi ini memungkinkan Anda menambah data Anda dengan mengambil informasi tambahan dari sumber eksternal, menyediakan kumpulan data yang lebih komprehensif untuk analisis dan visualisasi.

## Filter data berdasarkan kueri ReFID
<a name="v10-panels-xform-funcs-queryrefid"></a>

Gunakan transformasi ini untuk menyembunyikan satu atau beberapa kueri di panel yang memiliki beberapa kueri.

Grafana menampilkan surat identifikasi kueri dalam teks abu-abu gelap. Pilih pengenal kueri untuk beralih pemfilteran. Jika surat kueri berwarna putih, maka hasilnya ditampilkan. Jika surat kueri gelap, maka hasilnya disembunyikan.

**catatan**  
Transformasi ini tidak tersedia untuk Graphite karena sumber data ini tidak mendukung korelasi data yang dikembalikan dengan kueri.

## Filter data berdasarkan nilai
<a name="v10-panels-xform-funcs-values"></a>

Gunakan transformasi ini untuk secara selektif memfilter titik data langsung dalam visualisasi Anda. Transformasi ini menyediakan opsi untuk menyertakan atau mengecualikan data berdasarkan satu atau beberapa kondisi yang diterapkan pada bidang yang dipilih.

Transformasi ini sangat berguna jika sumber data Anda tidak secara native memfilter berdasarkan nilai. Anda juga dapat menggunakan ini untuk mempersempit nilai untuk ditampilkan jika Anda menggunakan kueri bersama.

Kondisi yang tersedia untuk semua bidang adalah:
+ **Regex - Cocokkan ekspresi regex**.
+ **Apakah Null** — Cocokkan jika nilainya nol.
+ **Is Not Null** — Cocokkan jika nilainya tidak null.
+ **Sama** - Cocokkan jika nilainya sama dengan nilai yang ditentukan.
+ **Berbeda** - Cocokkan jika nilainya berbeda dari nilai yang ditentukan.

Ketentuan tambahan yang tersedia untuk bidang angka adalah:
+ **Lebih besar** — Cocokkan jika nilainya lebih besar dari nilai yang ditentukan.
+ **Lower** — Cocokkan jika nilainya lebih rendah dari nilai yang ditentukan.
+ **Lebih besar atau sama** — Cocokkan jika nilainya lebih besar atau sama.
+ **Lebih rendah atau sama** — Cocokkan jika nilainya lebih rendah atau sama.
+ **Rentang** - Cocokkan rentang antara minimum dan maksimum yang ditentukan, termasuk min dan maks.

Pertimbangkan kumpulan data berikut:


| Waktu | Temperatur | Ketinggian | 
| --- | --- | --- | 
| 2020-07-07 11:34:23 | 32 | 101 | 
| 2020-07-07 11:34:22 | 28 | 125 | 
| 2020-07-07 11:34:21 | 26 | 110 | 
| 2020-07-07 11:34:20 | 23 | 98 | 
| 2020-07-07 10:32:24 | 31 | 95 | 
| 2020-07-07 10:31:22 | 20 | 85 | 
| 2020-07-07 09:30:57 | 19 | 101 | 

Jika Anda **Sertakan** titik data yang memiliki suhu di bawah 30° C, konfigurasi akan terlihat sebagai berikut:
+ Jenis Filter: 'Sertakan'
+ Kondisi: Baris di mana 'Suhu' cocok dengan 'Lebih Rendah Dari' '30'

Dan Anda akan mendapatkan hasil berikut, di mana hanya suhu di bawah 30° C yang disertakan:

**Data yang Diubah**


| Waktu | Temperatur | Ketinggian | 
| --- | --- | --- | 
| 2020-07-07 11:34:22 | 28 | 125 | 
| 2020-07-07 11:34:21 | 26 | 110 | 
| 2020-07-07 11:34:20 | 23 | 98 | 
| 2020-07-07 10:31:22 | 20 | 85 | 
| 2020-07-07 09:30:57 | 19 | 101 | 

Anda dapat menambahkan lebih dari satu kondisi ke filter. Misalnya, Anda mungkin ingin memasukkan data hanya jika ketinggiannya lebih besar dari 100. Untuk melakukannya, tambahkan kondisi itu ke konfigurasi berikut:
+ Jenis filter: 'Sertakan' baris yang kondisi 'Cocokkan Semua'
+ Kondisi 1: Baris di mana 'Suhu' cocok dengan 'Lebih Rendah' dari '30'
+ Kondisi 2: Baris di mana 'Ketinggian' cocok dengan 'Lebih Besar' dari '100'

Bila Anda memiliki lebih dari satu kondisi, Anda dapat memilih apakah Anda ingin tindakan (sertakan/kecualikan) diterapkan pada baris yang **Cocokkan semua kondisi atau Cocokkan** **salah** satu kondisi yang Anda tambahkan.

Pada contoh di atas, kami memilih **Match all** karena kami ingin memasukkan baris yang memiliki suhu lebih rendah dari 30° C *DAN* ketinggian lebih tinggi dari 100. Jika kami ingin memasukkan baris yang memiliki suhu lebih rendah dari 30° C *ATAU* ketinggian lebih tinggi dari 100 sebagai gantinya, maka kami akan memilih **Match any**. Ini akan mencakup baris pertama dalam data asli, yang memiliki suhu 32° C (tidak cocok dengan kondisi pertama) tetapi ketinggian 101 (yang cocok dengan kondisi kedua), sehingga disertakan.

Kondisi yang tidak valid atau tidak lengkap dikonfigurasi diabaikan.

Transformasi pemfilteran data serbaguna ini memungkinkan Anda memasukkan atau mengecualikan titik data secara selektif berdasarkan kondisi tertentu. Sesuaikan kriteria untuk menyesuaikan presentasi data Anda untuk memenuhi kebutuhan analitis unik Anda.

## Filter bidang berdasarkan nama
<a name="v10-panels-xform-funcs-name"></a>

Gunakan transformasi ini untuk menghapus bagian dari hasil kueri Anda. Ada tiga cara untuk memfilter nama bidang:
+ Masukkan ekspresi reguler.
+ Pilih bidang yang disertakan secara manual.
+ Gunakan variabel dasbor.

*Gunakan ekspresi reguler*

Saat Anda memfilter menggunakan ekspresi reguler, nama bidang yang cocok dengan ekspresi reguler disertakan. Misalnya, menggunakan ekspresi reguler hanya `'prod.*'` akan mengembalikan bidang yang dimulai `prod`

Ekspresi reguler dapat menyertakan variabel dasbor yang diinterpolasi menggunakan sintaks. `${variableName}`

*Pilih bidang yang disertakan secara manual*

Pilih atau batal pilihan nama bidang untuk menghapusnya dari hasil. Jika ekspresi reguler juga disertakan, bidang yang cocok dengan ekspresi akan disertakan, meskipun tidak dicentang.

*Gunakan variabel dasbor*

Pilih **Dari variabel** untuk memungkinkan Anda memilih variabel dasbor yang digunakan untuk menyertakan bidang. Dengan menyiapkan variabel dasbor dengan beberapa pilihan, bidang yang sama dapat ditampilkan di beberapa visualisasi.

Transformasi ini memberikan fleksibilitas dalam menyesuaikan hasil kueri Anda agar fokus pada bidang spesifik yang Anda butuhkan untuk analisis dan visualisasi yang efektif.

## Format string
<a name="v10-panels-xform-funcs-string"></a>

Gunakan transformasi ini untuk menyesuaikan output dari bidang string. Transformasi ini memiliki bidang-bidang berikut:
+ **Huruf** besar - Memformat seluruh string dalam karakter huruf besar.
+ **Huruf** kecil - Memformat seluruh string dalam karakter huruf kecil.
+ **Kasus kalimat** - Memformat karakter pertama string dalam huruf besar.
+ **Kasus judul** - Memformat karakter pertama dari setiap kata dalam string dalam huruf besar.
+ **Kasus Pascal** - Memformat karakter pertama dari setiap kata dalam string dalam huruf besar dan tidak menyertakan spasi di antara kata-kata.
+ **Kasus unta** - Memformat karakter pertama dari setiap kata dalam string dalam huruf besar, kecuali kata pertama, dan tidak termasuk spasi di antara kata-kata.
+ **Kasus ular** - Memformat semua karakter dalam string dalam huruf kecil dan menggunakan garis bawah alih-alih spasi di antara kata-kata.
+ **Kasus keb** — Memformat semua karakter dalam string dalam huruf kecil dan menggunakan tanda hubung alih-alih spasi di antara kata-kata.
+ **Trim** - Menghapus semua spasi depan dan belakang dari string.
+ **Substring** - Mengembalikan substring string, menggunakan posisi awal dan akhir yang ditentukan.

Transformasi ini menyediakan cara mudah untuk membakukan dan menyesuaikan penyajian data string untuk visualisasi dan analisis yang lebih baik.

**catatan**  
Transformasi ini saat ini dalam pratinjau publik. Grafana Labs menawarkan dukungan terbatas, dan perubahan yang melanggar mungkin terjadi sebelum fitur tersedia secara umum.

## Format waktu
<a name="v10-panels-xform-funcs-time"></a>

Gunakan transformasi ini untuk menyesuaikan output dari bidang waktu. Output dapat diformat menggunakan [string format Moment.js](https://momentjs.com/docs/#/displaying/). Misalnya, jika Anda hanya ingin menampilkan tahun bidang waktu, string format 'YYYY' dapat digunakan untuk menampilkan tahun kalender (misalnya, 1999 atau 2012).

**Sebelum Transformasi:**


| Stempel waktu | Peristiwa | 
| --- | --- | 
| 1636678740000000000 | Sistem Mulai | 
| 1636678680000000000 | Login Pengguna | 
| 1636678620000000000 | Data Diperbarui | 

**Setelah menerapkan 'YYYY-MM-DD HH: mm: SS':**


| Stempel waktu | Peristiwa | 
| --- | --- | 
| 2021-11-12 14:25:40 | Sistem Mulai | 
| 2021-11-12 14:24:40 | Login Pengguna | 
| 2021-11-12 14:23:40 | Data Diperbarui | 

Transformasi ini memungkinkan Anda menyesuaikan representasi waktu dalam visualisasi Anda, memberikan fleksibilitas dan presisi dalam menampilkan data temporal.

**catatan**  
Transformasi ini tersedia di ruang kerja compatbile dengan Grafana v10 sebagai fitur alfa.

## Grup oleh
<a name="v10-panels-xform-funcs-group"></a>

Transformasi ini mengelompokkan data dengan nilai bidang (kolom) tertentu dan memproses perhitungan pada setiap grup. Pilih untuk melihat daftar pilihan perhitungan.

Berikut adalah contoh data asli.


| Waktu | ID Server | Suhu CPU | Status Server | 
| --- | --- | --- | --- | 
| 7/7/2020 11:34:20AM | server 1 | 80 | Matikan | 
| 7/7/2020 11:34:20AM | server 3 | 62 | OK | 
| 7/7/2020 10:32:20AM | server 2 | 90 | Kelebihan | 
| 7/7/2020 10:31:22AM | server 3 | 55 | OK | 
| 7/7/2020 9:30:57AM | server 3 | 62 | Rebooting | 
| 7/7/2020 9:30:05AM | server 2 | 88 | OK | 
| 7/7/2020 9:28:06AM | server 1 | 80 | OK | 
| 7/7/2020 9:25:05AM | server 2 | 88 | OK | 
| 7/7/2020 9:23:07AM | server 1 | 86 | OK | 

Transformasi ini berjalan dalam dua langkah. Pertama, Anda menentukan satu atau beberapa bidang untuk mengelompokkan data berdasarkan. Ini akan mengelompokkan semua nilai yang sama dari bidang tersebut bersama-sama, seolah-olah Anda mengurutkannya. Misalnya jika kita mengelompokkan berdasarkan bidang ID Server, maka itu akan mengelompokkan data dengan cara ini:


| Waktu | ID Server | Suhu CPU | Status Server | 
| --- | --- | --- | --- | 
| 7/7/2020 11:34:20AM | server 1 | 80 | Matikan | 
| 7/7/2020 9:28:06AM | server 1 | 80 | OK | 
| 7/7/2020 9:23:07AM | server 1 | 86 | OK | 
| 7/7/2020 10:32:20AM | server 2 | 90 | Kelebihan | 
| 7/7/2020 9:30:05AM | server 2 | 88 | OK | 
| 7/7/2020 9:25:05AM | server 2 | 88 | OK | 
| 7/7/2020 11:34:20AM | server 3 | 62 | OK | 
| 7/7/2020 10:31:22AM | server 3 | 55 | OK | 
| 7/7/2020 9:30:57AM | server 3 | 62 | Rebooting | 

Semua baris dengan nilai ID Server yang sama dikelompokkan bersama.

Setelah memilih bidang mana Anda ingin mengelompokkan data Anda, Anda dapat menambahkan berbagai perhitungan pada bidang lain, dan menerapkan perhitungan untuk setiap kelompok baris. Misalnya, kita bisa menghitung suhu CPU rata-rata untuk masing-masing server tersebut. Jadi kita dapat menambahkan perhitungan *rata-rata* yang diterapkan pada bidang Suhu CPU untuk mendapatkan yang berikut:


| ID Server | Suhu CPU (rata-rata) | 
| --- | --- | 
| server 1 | 82 | 
| server 2 | 88,6 | 
| server 3 | 59,6 | 

Dan kita dapat menambahkan lebih dari satu perhitungan. Misalnya:
+ Untuk bidang Waktu, kita dapat menghitung nilai *Terakhir*, untuk mengetahui kapan titik data terakhir diterima untuk setiap server
+ Untuk bidang Status Server, kita dapat menghitung nilai *Terakhir* untuk mengetahui berapa nilai status terakhir untuk setiap server
+ Untuk bidang Temperatur, kita juga dapat menghitung nilai *Terakhir* untuk mengetahui berapa suhu yang dipantau terbaru untuk setiap server

Kami kemudian akan mendapatkan:


| ID Server | Suhu CPU (rata-rata) | Suhu CPU (terakhir) | Waktu (terakhir) | Status Server (terakhir) | 
| --- | --- | --- | --- | --- | 
| server 1 | 82 | 80 | 7/7/2020 11:34:20AM | Matikan | 
| server 2 | 88,6 | 90 | 7/7/2020 10:32:20AM | Kelebihan | 
| server 3 | 59,6 | 62 | 7/7/2020 11:34:20AM | OK | 

Transformasi ini memungkinkan Anda untuk mengekstrak informasi penting dari deret waktu Anda dan menampilkannya dengan cara yang nyaman.

## Pengelompokan ke matriks
<a name="v10-panels-xform-funcs-groupmatrix"></a>

Gunakan transformasi ini untuk menggabungkan tiga bidang—yang digunakan sebagai masukan untuk **kolom nilai Kolom****, **Baris**, dan Sel** dari output kueri—dan buat matriks. Matriks dihitung sebagai berikut:

**Data asli**


| ID Server | Suhu CPU | Status Server | 
| --- | --- | --- | 
| server 1 | 82 | OK | 
| server 2 | 88,6 | OK | 
| server 3 | 59,6 | Matikan | 

Kita dapat menghasilkan matriks menggunakan nilai `Server Status` sebagai nama kolom, `Server ID` nilai sebagai nama baris, dan `CPU Temperature` sebagai isi dari setiap sel. Isi setiap sel akan muncul untuk kolom (`Server Status`) dan kombinasi baris (`Server ID`) yang ada. Untuk sisa sel, Anda dapat memilih nilai mana yang akan ditampilkan antara: **Null**, **True**, **False**, atau **Empty**.

**Keluaran**


|  IDServer Status Server | OK | Matikan | 
| --- | --- | --- | 
| server 1 | 82 |  | 
| server 2 | 88,6 |  | 
| server 3 |  | 59,6 | 

Gunakan transformasi ini untuk membangun matriks dengan menentukan bidang dari hasil kueri Anda. Output matriks mencerminkan hubungan antara nilai-nilai unik di bidang ini. Ini membantu Anda menyajikan hubungan yang kompleks dalam format matriks yang jelas dan terstruktur.

## Kelompokkan ke tabel bersarang
<a name="v10-panels-xform-funcs-grouptable"></a>

Gunakan transformasi ini untuk mengelompokkan data dengan nilai bidang (kolom) tertentu dan perhitungan proses pada setiap grup. Rekaman dihasilkan yang berbagi nilai bidang dikelompokkan yang sama, untuk ditampilkan dalam tabel bersarang.

Untuk menghitung statistik bidang, pilih kotak di sebelah bidang dan pilih opsi **Hitung**. Ini akan menambahkan kotak pilihan lain dengan statistik yang akan dipilih.

Tabel berikut menunjukkan data sampel.


| Waktu | ID Server | Suhu CPU | Status Server | 
| --- | --- | --- | --- | 
| 7/7/2020 11:34:20AM | server 1 | 80 | Matikan | 
| 7/7/2020 11:34:20AM | server 3 | 62 | OK | 
| 7/7/2020 10:32:20AM | server 2 | 90 | Kelebihan | 
| 7/7/2020 10:31:22AM | server 3 | 55 | OK | 
| 7/7/2020 9:30:57AM | server 3 | 62 | Rebooting | 
| 7/7/2020 9:30:05AM | server 2 | 88 | OK | 
| 7/7/2020 9:28:06AM | server 1 | 80 | OK | 
| 7/7/2020 9:25:05AM | server 2 | 88 | OK | 
| 7/7/2020 9:23:07AM | server 1 | 86 | OK | 

Transformasi ini memiliki dua langkah. Pertama, tentukan satu atau lebih bidang yang digunakan untuk mengelompokkan data. Ini mengelompokkan semua nilai yang sama dari bidang tersebut bersama-sama, seolah-olah Anda mengurutkannya Misalnya, jika Anda mengelompokkan berdasarkan `Server ID` bidang, Grafana mengelompokkan data dengan cara ini:


| ID Server | Data | 
| --- | --- | 
| Waktu | Suhu CPU | Status Server | 
| --- | --- | --- | 
| Waktu | Suhu CPU | Status Server | 
| --- | --- | --- | 
| Waktu | Suhu CPU | Status Server | 
| --- | --- | --- | 
| server 1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/v10-panels-xform-functions.html) | 
| server 2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/v10-panels-xform-functions.html) | 
| server 3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/v10-panels-xform-functions.html) | 
| 7/7/2020 11:34:20AM | 80 | Matikan | 
| 7/7/2020 9:28:06AM | 80 | OK | 
| 7/7/2020 9:23:07AM | 86 | OK | 
| 7/7/2020 10:32:20AM | 90 | Kelebihan | 
| 7/7/2020 9:30:05AM | 88 | OK | 
| 7/7/2020 9:25:05AM | 88 | OK | 
| 7/7/2020 11:34:20AM | 62 | OK | 
| 7/7/2020 10:31:22AM | 55 | OK | 
| 7/7/2020 9:30:57AM | 62 | Rebooting | 

Setelah memilih bidang yang ingin Anda kelompokkan data, Anda dapat menambahkan berbagai perhitungan di bidang lain dan menerapkan perhitungan ke setiap grup baris. Misalnya, Anda mungkin ingin menghitung suhu CPU rata-rata untuk masing-masing server tersebut. Untuk melakukannya, tambahkan perhitungan rata-rata yang diterapkan pada bidang Suhu CPU untuk mendapatkan hasil sebagai berikut:


| ID Server | Suhu CPU (rata-rata) |  | 
| --- | --- | --- | 
| Waktu | Status Server | 
| --- | --- | 
| Waktu | Status Server | 
| --- | --- | 
| Waktu | Status Server | 
| --- | --- | 
| server 1 | 82 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/v10-panels-xform-functions.html) | 
| server 2 | 88,6 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/v10-panels-xform-functions.html) | 
| server 3 | 59,6 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/v10-panels-xform-functions.html) | 
| 7/7/2020 11:34:20AM | Matikan | 
| 7/7/2020 9:28:06AM | OK | 
| 7/7/2020 9:23:07AM | OK | 
| 7/7/2020 10:32:20AM | Kelebihan | 
| 7/7/2020 9:30:05AM | OK | 
| 7/7/2020 9:25:05AM | OK | 
| 7/7/2020 11:34:20AM | OK | 
| 7/7/2020 10:31:22AM | OK | 
| 7/7/2020 9:30:57AM | Rebooting | 

## Buat peta panas
<a name="v10-panels-xform-funcs-heatmap"></a>

Gunakan transformasi ini untuk menyiapkan data histogram untuk memvisualisasikan tren dari waktu ke waktu. Mirip dengan visualisasi peta panas, transformasi ini mengubah metrik histogram menjadi bucket temporal.

**Ember X**

Pengaturan ini menentukan bagaimana sumbu x dibagi menjadi ember.
+ **Ukuran** - Tentukan interval waktu di bidang input. Misalnya, rentang waktu `1h` membuat sel selebar satu jam pada sumbu x.
+ **Hitung** - Untuk non-time-related seri, gunakan opsi ini untuk menentukan jumlah elemen dalam ember.

**Ember Y**

Pengaturan ini menentukan bagaimana sumbu y dibagi menjadi ember.
+ **Linear**
+ **Logaritmik** - Pilih antara basis log 2 atau basis log 10.
+ **Symlog — Menggunakan skala logaritmik** simetris. Pilih antara basis log 2 atau basis log 10, memungkinkan nilai negatif.

Asumsikan Anda memiliki kumpulan data berikut:


| Stempel waktu | Nilai | 
| --- | --- | 
| 2023-01-01 12:00:00 | 5 | 
| 2023-01-01 12:15:00 | 10 | 
| 2023-01-01 12:30:00 | 15 | 
| 2023-01-01 12:45:00 | 8 | 
+ Dengan X Bucket disetel ke `Size: 15m` dan Y Bucket as`Linear`, histogram mengatur nilai ke dalam interval waktu 15 menit pada sumbu x dan linier pada sumbu y.
+ Untuk X Bucket as `Count: 2` dan Y Bucket as`Logarithmic (base 10)`, histogram mengelompokkan nilai ke dalam ember dua pada sumbu x dan menggunakan skala logaritmik pada sumbu y.

## Histogram
<a name="v10-panels-xform-funcs-histogram"></a>

Gunakan transformasi ini untuk menghasilkan histogram berdasarkan data input, memungkinkan Anda memvisualisasikan distribusi nilai.
+ **Ukuran bucket** — Rentang antara item terendah dan tertinggi dalam ember (Xmin hingga XMax).
+ **Bucket offset** — Offset untuk non-zero-based ember.
+ **Gabungkan seri** - Buat histogram terpadu menggunakan semua seri yang tersedia.

**Data asli**

Seri 1:


| A | B | C | 
| --- | --- | --- | 
| 1 | 3 | 5 | 
| 2 | 4 | 6 | 
| 3 | 5 | 7 | 
| 4 | 6 | 8 | 
| 5 | 7 | 9 | 

Seri 2:


| C | 
| --- | 
| 5 | 
| 6 | 
| 7 | 
| 8 | 
| 9 | 

**Keluaran**


| xMin | XMax | A | B | C | C | 
| --- | --- | --- | --- | --- | --- | 
| 1 | 2 | 1 | 0 | 0 | 0 | 
| 2 | 3 | 1 | 0 | 0 | 0 | 
| 3 | 4 | 1 | 1 | 0 | 0 | 
| 4 | 5 | 1 | 1 | 0 | 0 | 
| 5 | 6 | 1 | 1 | 1 | 1 | 
| 6 | 7 | 0 | 1 | 1 | 1 | 
| 7 | 8 | 0 | 1 | 1 | 1 | 
| 8 | 9 | 0 | 0 | 1 | 1 | 
| 9 | 10 | 0 | 0 | 1 | 1 | 

Visualisasikan distribusi nilai menggunakan histogram yang dihasilkan, memberikan wawasan tentang penyebaran dan kepadatan data.

## Bergabung dengan bidang
<a name="v10-panels-xform-funcs-joinfield"></a>

Gunakan transformasi ini untuk menggabungkan beberapa hasil ke dalam satu tabel, memungkinkan konsolidasi data dari kueri yang berbeda.

Ini sangat berguna untuk mengubah beberapa hasil deret waktu menjadi satu tabel lebar dengan bidang waktu bersama.

**Gabung batin**

Gabungan bagian dalam menggabungkan data dari beberapa tabel di mana semua tabel berbagi nilai yang sama dari bidang yang dipilih. Jenis gabungan ini mengecualikan data di mana nilai tidak cocok di setiap hasil.

Gunakan transformasi ini untuk menggabungkan hasil dari beberapa kueri (menggabungkan pada bidang gabungan yang diteruskan atau kolom pertama kali) menjadi satu hasil, dan jatuhkan baris di mana gabungan yang berhasil tidak dapat terjadi.

Dalam contoh berikut, dua query mengembalikan data tabel. Ini divisualisasikan sebagai dua tabel terpisah sebelum menerapkan transformasi gabungan batin.

Kueri A:


| Waktu | Pekerjaan | Uptime | 
| --- | --- | --- | 
| 7/7/2020 11:34:20AM | simpul | 25260122 | 
| 7/7/2020 11:24:20AM | postgre | 123001233 | 
| 7/7/2020 11:14:20AM | postgre | 345001233 | 

Kueri B:


| Waktu | Server | Kesalahan | 
| --- | --- | --- | 
| 7/7/2020 11:34:20AM | server 1 | 15 | 
| 7/7/2020 11:24:20AM | server 2 | 5 | 
| 7/7/2020 11:04:20AM | server 3 | 10 | 

Hasil setelah menerapkan transformasi gabungan batin terlihat seperti berikut:


| Waktu | Pekerjaan | Uptime | Server | Kesalahan | 
| --- | --- | --- | --- | --- | 
| 7/7/2020 11:34:20AM | simpul | 25260122 | server 1 | 15 | 
| 7/7/2020 11:24:20AM | postgre | 123001233 | server 2 | 5 | 

*Bergabung di luar*

Gabungan luar mencakup semua data dari gabungan dalam dan baris di mana nilai tidak cocok di setiap input. Sementara gabungan bagian dalam bergabung dengan Kueri A dan Kueri B pada bidang waktu, gabungan luar mencakup semua baris yang tidak cocok di bidang waktu.

Dalam contoh berikut, dua query mengembalikan data tabel. Ini divisualisasikan sebagai dua tabel sebelum menerapkan transformasi gabungan luar.

Kueri A:


| Waktu | Pekerjaan | Uptime | 
| --- | --- | --- | 
| 7/7/2020 11:34:20AM | simpul | 25260122 | 
| 7/7/2020 11:24:20AM | postgre | 123001233 | 
| 7/7/2020 11:14:20AM | postgre | 345001233 | 

Kueri B:


| Waktu | Server | Kesalahan | 
| --- | --- | --- | 
| 7/7/2020 11:34:20AM | server 1 | 15 | 
| 7/7/2020 11:24:20AM | server 2 | 5 | 
| 7/7/2020 11:04:20AM | server 3 | 10 | 

Hasil setelah menerapkan transformasi gabungan luar terlihat seperti berikut:


| Waktu | Pekerjaan | Uptime | Server | Kesalahan | 
| --- | --- | --- | --- | --- | 
| 7/7/2020 11:04:20AM |  |  | server 3 | 10 | 
| 7/7/2020 11:14:20AM | postgre | 345001233 |  |  | 
| 7/7/2020 11:34:20AM | simpul | 25260122 | server 1 | 15 | 
| 7/7/2020 11:24:20AM | postgre | 123001233 | server 2 | 5 | 

## Bergabunglah dengan label
<a name="v10-panels-xform-funcs-joinlabel"></a>

Gunakan transformasi ini untuk menggabungkan beberapa hasil menjadi satu tabel.

Ini sangat berguna untuk mengubah beberapa hasil deret waktu menjadi satu tabel lebar dengan bidang **Label** bersama.
+ **Gabung** — Pilih label untuk bergabung di antara label yang tersedia atau umum di semua deret waktu.
+ **Nilai** — Nama untuk hasil output.

**Contoh**

Masukan 1: `series1{what='Temp', cluster='A', job='J1'}`


| Waktu | Nilai | 
| --- | --- | 
| 1 | 10 | 
| 2 | 200 | 

Masukan 2: `series2{what='Temp', cluster='B', job='J1'}`


| Waktu | Nilai | 
| --- | --- | 
| 1 | 10 | 
| 2 | 200 | 

Masukan 3: `series3{what='Speed', cluster='B', job='J1'}`


| Waktu | Nilai | 
| --- | --- | 
| 22 | 22 | 
| 28 | 77 | 

Config:

```
value: 'what'
```

Output:


| klaster | pekerjaan | Temp | Kecepatan | 
| --- | --- | --- | --- | 
| A | J1 | 10 |  | 
| A | J1 | 200 |  | 
| B | J1 | 10 | 22 | 
| B | J1 | 200 | 77 | 

Gabungkan dan atur data deret waktu secara efektif dengan transformasi ini untuk wawasan yang komprehensif.

## Label ke bidang
<a name="v10-panels-xform-funcs-labelstofields"></a>

Gunakan transformasi ini untuk mengonversi hasil deret waktu dengan label atau tag ke dalam tabel, termasuk kunci dan nilai setiap label dalam hasilnya. Tampilkan label sebagai kolom atau nilai baris untuk visualisasi data yang disempurnakan.

Diberikan hasil query dari dua deret waktu:
+ Seri 1 - label`Server=Server A`, `Datacenter=EU`
+ Seri 2 - label`Server=Server B`, `Datacenter=EU`

Dalam mode **Kolom**, hasilnya terlihat seperti ini:


| Waktu | Server | Pusat data | Nilai | 
| --- | --- | --- | --- | 
| 7/7/2020 11:34:20AM | Server A | EU | 1 | 
| 7/7/2020 11:34:20AM | Peladen B | EU | 2 | 

Dalam mode “Baris”, hasilnya memiliki tabel untuk setiap seri dan menunjukkan setiap nilai label seperti ini:


| label | nilai | 
| --- | --- | 
| Server | Server A | 
| Pusat data | EU | 


| label | nilai | 
| --- | --- | 
| Server | Peladen B | 
| Pusat data | EU | 

**Nama bidang nilai**

Jika Anda memilih Server sebagai **nama bidang Nilai**, maka Anda akan mendapatkan satu bidang untuk setiap nilai label Server.


| Waktu | Pusat data | Server A | Peladen B | 
| --- | --- | --- | --- | 
| 7/7/2020 11:34:20AM | EU | 1 | 2 | 

**Perilaku penggabungan**

Label ke bidang transformator secara internal adalah dua transformasi terpisah. Tindakan pertama pada seri tunggal dan mengekstrak label ke bidang. Yang kedua adalah transformasi gabungan yang menggabungkan semua hasil menjadi satu tabel. Transformasi gabungan mencoba bergabung di semua bidang yang cocok. Langkah penggabungan ini diperlukan dan tidak dapat dimatikan.

Untuk mengilustrasikan hal ini, berikut adalah contoh di mana Anda memiliki dua kueri yang mengembalikan deret waktu tanpa label yang tumpang tindih.
+ Seri 1 - label `Server=ServerA`
+ Seri 2 - label `Datacenter=EU`

Ini pertama-tama akan menghasilkan dua tabel ini:


| Waktu | Server | Nilai | 
| --- | --- | --- | 
| 7/7/2020 11:34:20AM | ServerA | 10 | 


| Waktu | Pusat data | Nilai | 
| --- | --- | --- | 
| 7/7/2020 11:34:20AM | EU | 20 | 

Setelah bergabung:


| Waktu | Server | Nilai | Pusat data | 
| --- | --- | --- | --- | 
| 7/7/2020 11:34:20AM | ServerA | 10 |  | 
| 7/7/2020 11:34:20AM |  | 20 | EU | 

## Kuota
<a name="v10-panels-xform-funcs-limit"></a>

Gunakan transformasi ini untuk membatasi jumlah baris yang ditampilkan, memberikan tampilan data yang lebih terfokus. Ini sangat berguna ketika berhadapan dengan dataset besar.

Berikut ini adalah contoh yang menggambarkan dampak transformasi **Limit** pada respons dari sumber data:


| Waktu | Metrik | Nilai | 
| --- | --- | --- | 
| 7/7/2020 11:34:20AM | Temperatur | 25 | 
| 7/7/2020 11:34:20AM | Kelembaban | 22 | 
| 7/7/2020 10:32:20AM | Kelembaban | 29 | 
| 7/7/2020 10:31:22AM | Temperatur | 22 | 
| 7/7/2020 9:30:57AM | Kelembaban | 33 | 
| 7/7/2020 9:30:05AM | Temperatur | 19 | 

Berikut adalah hasil setelah menambahkan transformasi Limit dengan nilai '3':


| Waktu | Metrik | Nilai | 
| --- | --- | --- | 
| 7/7/2020 11:34:20AM | Temperatur | 25 | 
| 7/7/2020 11:34:20AM | Kelembaban | 22 | 
| 7/7/2020 10:32:20AM | Kelembaban | 29 | 

Transformasi ini membantu Anda menyesuaikan presentasi visual data Anda untuk fokus pada data yang paling relevan.

## Gabungkan seri/tabel
<a name="v10-panels-xform-funcs-merge"></a>

Gunakan transformasi ini untuk menggabungkan hasil dari beberapa kueri menjadi satu hasil, yang sangat berguna saat menggunakan visualisasi panel tabel. Transformasi menggabungkan nilai ke dalam baris yang sama jika bidang bersama berisi data yang sama.

Berikut contoh ilustrasi dampak transformasi **Merge seri/tabel pada dua kueri yang mengembalikan data tabel**:

*Kueri A:*


| Waktu | Pekerjaan | Uptime | 
| --- | --- | --- | 
| 7/7/2020 11:34:20AM | simpul | 25260122 | 
| 7/7/2020 11:24:20AM | postgre | 123001233 | 

Kueri B:


| Waktu | Pekerjaan | Kesalahan | 
| --- | --- | --- | 
| 7/7/2020 11:34:20AM | simpul | 15 | 
| 7/7/2020 11:24:20AM | postgre | 5 | 

Berikut adalah hasilnya setelah menerapkan transformasi Merge:


| Waktu | Pekerjaan | Kesalahan | Uptime | 
| --- | --- | --- | --- | 
| 7/7/2020 11:34:20AM | simpul | 15 | 25260122 | 
| 7/7/2020 11:24:20AM | postgre | 5 | 123001233 | 

Transformasi ini menggabungkan nilai-nilai dari Query A dan Query B ke dalam tabel terpadu, meningkatkan presentasi untuk wawasan yang lebih baik.

## Atur bidang berdasarkan nama
<a name="v10-panels-xform-funcs-organize"></a>

Gunakan transformasi ini untuk mengganti nama, menyusun ulang, atau menyembunyikan bidang yang dikembalikan oleh satu kueri di panel Anda. Transformasi ini hanya berfungsi di panel dengan satu kueri. Jika panel Anda memiliki beberapa kueri, maka Anda harus menerapkan transformasi *gabungan Luar* atau menghapus kueri tambahan.

**Mengubah bidang**

Grafana menampilkan daftar bidang yang dikembalikan oleh kueri. Anda dapat:
+ **Ubah urutan bidang** - Seret bidang ke lokasi baru dalam daftar.
+ **Sembunyikan atau tampilkan bidang** — Gunakan ikon mata di samping nama bidang untuk mengaktifkan visibilitas bidang.
+ **Ganti nama bidang** - Ketik nama baru ke dalam kotak **Ganti Nama**.

**Contoh**

Mengingat hasil kueri awal ini:


| Waktu | Metrik | Nilai | 
| --- | --- | --- | 
| 2020-07-07 11:34:20 | Temperatur | 25 | 
| 2020-07-07 11:34:20 | Kelembaban | 22 | 
| 2020-07-07 10:32:20 | Kelembaban | 29 | 

Anda dapat menerapkan penggantian bidang ganti nama untuk membuat:


| Waktu | Sensor | Membaca | 
| --- | --- | --- | 
| 2020-07-07 11:34:20 | Temperatur | 25 | 
| 2020-07-07 11:34:20 | Kelembaban | 22 | 
| 2020-07-07 10:32:20 | Kelembaban | 29 | 

Transformasi ini memungkinkan Anda menyesuaikan tampilan hasil kueri, memastikan representasi data Anda yang jelas dan berwawasan luas di Grafana.

## Partisi berdasarkan nilai
<a name="v10-panels-xform-funcs-partition"></a>

Gunakan transformasi ini untuk merampingkan proses grafik beberapa seri tanpa perlu beberapa kueri dengan klausa yang berbeda. `WHERE`

**catatan**  
Fungsi ini tersedia di ruang kerja yang kompatibel dengan Grafana versi 9 ke atas.

Ini sangat berguna saat menggunakan tabel SQL metrik, seperti dalam contoh ini:


| Waktu | Region | Nilai | 
| --- | --- | --- | 
| 10/20/2022 12:00:00PM | AS | 1520 | 
| 10/20/2022 12:00:00PM | EU | 2936 | 
| 10/20/2022 1:00:00AM | AS | 1327 | 
| 10/20/2022 1:00:00AM | EU | 912 | 

Dengan transformator *Partisi berdasarkan nilai*, Anda dapat mengeluarkan satu kueri dan membagi hasilnya dengan nilai unik dalam satu atau beberapa kolom (bidang) pilihan Anda. Contoh berikut menggunakan `Region`.

```
SELECT Time, Region, Value FROM metrics WHERE Time > '2022-10-20'
```


| Waktu | Region | Nilai | 
| --- | --- | --- | 
| 10/20/2022 12:00:00PM | AS | 1520 | 
| 10/20/2022 1:00:00AM | AS | 1327 | 


| Waktu | Region | Nilai | 
| --- | --- | --- | 
| 10/20/2022 12:00:00PM | EU | 2936 | 
| 10/20/2022 1:00:00AM | EU | 912 | 

Transformasi ini menyederhanakan proses dan meningkatkan fleksibilitas memvisualisasikan beberapa seri dalam visualisasi deret waktu yang sama.

## Siapkan seri waktu
<a name="v10-panels-xform-funcs-preparetimeseries"></a>

Gunakan transformasi ini untuk mengatasi masalah saat sumber data mengembalikan data deret waktu dalam format yang tidak kompatibel dengan visualisasi yang diinginkan. Transformasi ini memungkinkan Anda untuk mengonversi data deret waktu dari antara format lebar dan panjang.

**Seri waktu multi-frame**

Gunakan opsi ini untuk mengubah kerangka data deret waktu dari format lebar ke format panjang. Ini sangat membantu ketika sumber data Anda memberikan informasi deret waktu dalam format yang perlu dibentuk ulang untuk kompatibilitas optimal dengan visualisasi Anda.

*Contoh*

Masukan ini:


| Stempel waktu | Nilai1 | Nilai2 | 
| --- | --- | --- | 
| 2023-01-01 00:00:00 | 10 | 20 | 
| 2023-01-01 01:00:00 | 15 | 25 | 

Dapat diubah menjadi:


| Stempel waktu | Variabel | Nilai | 
| --- | --- | --- | 
| 2023-01-01 00:00:00 | Nilai1 | 10 | 
| 2023-01-01 00:00:00 | Nilai2 | 20 | 
| 2023-01-01 01:00:00 | Nilai1 | 15 | 
| 2023-01-01 01:00:00 | Nilai2 | 25 | 

**Seri waktu yang luas**

Gunakan opsi ini untuk mengubah kerangka data deret waktu dari format panjang ke format lebar. Ini sangat membantu ketika sumber data Anda mengirimkan data deret waktu dalam format yang panjang dan visualisasi Anda memerlukan format yang luas.

*Contoh*

Masukan ini:


| Stempel waktu | Variabel | Nilai | 
| --- | --- | --- | 
| 2023-01-01 00:00:00 | Nilai1 | 10 | 
| 2023-01-01 00:00:00 | Nilai2 | 20 | 
| 2023-01-01 01:00:00 | Nilai1 | 15 | 
| 2023-01-01 01:00:00 | Nilai2 | 25 | 

Dapat diubah menjadi:


| Stempel waktu | Nilai1 | Nilai2 | 
| --- | --- | --- | 
| 2023-01-01 00:00:00 | 10 | 20 | 
| 2023-01-01 01:00:00 | 15 | 25 | 

## Kurangi
<a name="v10-panels-xform-funcs-reduce"></a>

Gunakan transformasi ini menerapkan perhitungan untuk setiap bidang dalam bingkai data dan mengembalikan nilai tunggal. Transformasi ini sangat berguna untuk mengkonsolidasikan data deret waktu mulitiple ke dalam format yang lebih ringkas dan ringkas. Bidang waktu dihapus saat menerapkan transformasi ini.

Pertimbangkan masukannya:

Kueri A:


| Waktu | Temp | Uptime | 
| --- | --- | --- | 
| 2020-07-07 11:34:20 | 12.3 | 256122 | 
| 2020-07-07 11:24:20 | 15.4 | 1230233 | 

Kueri B:


| Waktu | AQI | Kesalahan | 
| --- | --- | --- | 
| 2020-07-07 11:34:20 | 6.5 | 15 | 
| 2020-07-07 11:24:20 | 3.2 | 5 | 

Trafo reduksi memiliki dua mode:
+ **Seri ke baris** - Membuat baris untuk setiap bidang dan kolom untuk setiap perhitungan.
+ **Mengurangi bidang** - Menjaga struktur bingkai yang ada, tetapi menciutkan setiap bidang menjadi satu nilai.

Misalnya, jika Anda menggunakan perhitungan **Pertama** dan **Terakhir** dengan transformasi **Seri ke baris**, maka hasilnya akan menjadi:


| Bidang | Pertama | Terakhir | 
| --- | --- | --- | 
| Temp | 12.3 | 15.4 | 
| Uptime | 256122 | 1230233 | 
| AQI | 6.5 | 3.2 | 
| Kesalahan | 15 | 5 | 

**Kolom Reduce** dengan perhitungan **Terakhir**, menghasilkan dua frame, masing-masing dengan satu baris:

Kueri A:


| Temp | Uptime | 
| --- | --- | 
| 15.4 | 1230233 | 

Kueri B:


| AQI | Kesalahan | 
| --- | --- | 
| 3.2 | 5 | 

## Ganti nama dengan regex
<a name="v10-panels-xform-funcs-rename"></a>

Gunakan transformasi ini untuk mengganti nama bagian dari hasil kueri menggunakan ekspresi reguler dan pola penggantian.

Anda dapat menentukan ekspresi reguler, yang hanya diterapkan pada kecocokan, bersama dengan pola pengganti yang mendukung referensi kembali. Misalnya, bayangkan Anda memvisualisasikan penggunaan CPU per host dan Anda ingin menghapus nama domain. Anda dapat mengatur regex ke `([^\.]+)\..+` dan pola penggantian ke`$1`, `web-01.example.com` akan menjadi. `web-01`

Transformasi ini memungkinkan Anda menyesuaikan data untuk memenuhi kebutuhan visualisasi Anda, membuat dasbor Anda lebih informatif dan ramah pengguna.

## Baris ke bidang
<a name="v10-panels-xform-funcs-row"></a>

Gunakan transformasi ini untuk mengubah baris menjadi bidang terpisah. Ini dapat berguna karena bidang dapat ditata dan dikonfigurasi secara individual. Ini juga dapat menggunakan bidang tambahan sebagai sumber untuk konfigurasi bidang dinamis atau memetakannya ke label bidang. Label tambahan kemudian dapat digunakan untuk menentukan nama tampilan yang lebih baik untuk bidang yang dihasilkan.

Transformasi ini mencakup tabel bidang yang mencantumkan semua bidang dalam data yang dikembalikan oleh kueri konfigurasi. Tabel ini memberi Anda kontrol atas bidang apa yang harus dipetakan ke setiap properti konfigurasi (opsi **Gunakan sebagai**). Anda juga dapat memilih nilai mana yang akan dipilih jika ada beberapa baris dalam data yang dikembalikan.

Transformasi ini membutuhkan:
+ Satu bidang untuk digunakan sebagai sumber nama bidang.

  Secara default, transformasi menggunakan bidang string pertama sebagai sumber. Anda dapat mengganti pengaturan default ini dengan memilih **Nama bidang** di kolom **Use as** untuk bidang yang ingin Anda gunakan sebagai gantinya.
+ Satu bidang untuk digunakan sebagai sumber nilai.

  Secara default, transformasi menggunakan bidang angka pertama sebagai sumber. Tetapi Anda dapat mengganti pengaturan default ini dengan memilih **Nilai bidang** di kolom **Gunakan sebagai** kolom untuk bidang yang ingin Anda gunakan sebagai gantinya.

Berguna saat memvisualisasikan data di:
+ Pengukur
+ Stat
+ Bagan pai

**Petakan bidang tambahan ke label**

Jika bidang tidak dipetakan ke properti konfigurasi Grafana akan secara otomatis menggunakannya sebagai sumber untuk label pada bidang output.

Contoh:


| Nama | DataCenter | Nilai | 
| --- | --- | --- | 
| ServerA | AS | 100 | 
| ServerB | EU | 200 | 

Output:


| ServerA (label: DataCenter: AS) | ServerB (label: DataCenter: EU) | 
| --- | --- | 
| 100 | 200 | 

Label tambahan sekarang dapat digunakan dalam nama tampilan bidang untuk memberikan nama bidang yang lebih lengkap.

Jika Anda ingin mengekstrak konfigurasi dari satu kueri dan menerapkannya ke kueri lain, Anda harus menggunakan *konfigurasi dari transformasi hasil kueri*.

**Contoh**

Masukan:


| Nama | Nilai | Maks | 
| --- | --- | --- | 
| ServerA | 10 | 100 | 
| ServerB | 20 | 200 | 
| ServerC | 30 | 300 | 

Output:


| ServerA (konfigurasi: maks = 100) | ServerB (konfigurasi: maks = 200) | ServerC (konfigurasi: maks = 300) | 
| --- | --- | --- | 
| 10 | 20 | 30 | 

Seperti yang Anda lihat setiap baris dalam data sumber menjadi bidang terpisah. Setiap bidang sekarang juga memiliki set opsi konfigurasi maks. Opsi seperti **Min**, **Max**, **Unit** dan **Thresholds** adalah bagian dari konfigurasi bidang dan jika diatur seperti ini akan digunakan oleh visualisasi alih-alih opsi apa pun yang dikonfigurasi secara manual di panel opsi editor panel.

Transformasi ini memungkinkan konversi baris menjadi bidang individual, memfasilitasi konfigurasi bidang dinamis, dan memetakan bidang tambahan ke label.

## Seri ke baris
<a name="v10-panels-xform-funcs-series"></a>

Gunakan transformasi ini untuk menggabungkan hasil dari beberapa kueri data deret waktu menjadi satu hasil tunggal. Ini sangat membantu saat menggunakan visualisasi panel tabel.

Hasil dari transformasi ini akan berisi tiga kolom: Waktu, Metrik, dan Nilai. Kolom Metrik ditambahkan sehingga Anda dapat dengan mudah melihat dari mana kueri metrik berasal. Sesuaikan nilai ini dengan mendefinisikan Label pada kueri sumber.

Pada contoh di bawah ini, kami memiliki dua pertanyaan yang mengembalikan data deret waktu. Ini divisualisasikan sebagai dua tabel terpisah sebelum menerapkan transformasi.

*Kueri A:*


| Waktu | Temperatur | 
| --- | --- | 
| 2020-07-07 11:34:20 | 25 | 
| 2020-07-07 10:31:22 | 22 | 
| 2020-07-07 09:30:05 | 19 | 

*Kueri B:*


| Waktu | Kelembaban | 
| --- | --- | 
| 2020-07-07 11:34:20 | 24 | 
| 2020-07-07 10:32:20 | 29 | 
| 2020-07-07 09:30:57 | 33 | 

Berikut adalah hasil setelah menerapkan Seri ke transformasi baris.


| Waktu | Metrik | Nilai | 
| --- | --- | --- | 
| 2020-07-07 11:34:20 | Temperatur | 25 | 
| 2020-07-07 11:34:20 | Kelembaban | 22 | 
| 2020-07-07 10:32:20 | Kelembaban | 29 | 
| 2020-07-07 10:31:22 | Temperatur | 22 | 
| 2020-07-07 09:30:57 | Kelembaban | 33 | 
| 2020-07-07 09:30:05 | Temperatur | 19 | 

Transformasi ini memfasilitasi konsolidasi hasil dari beberapa kueri deret waktu, menyediakan kumpulan data yang efisien dan terpadu untuk analisis dan visualisasi yang efisien dalam format tabel.

## Urutkan berdasarkan
<a name="v10-panels-xform-funcs-sort"></a>

Gunakan transformasi ini untuk mengurutkan setiap frame dalam hasil kueri berdasarkan bidang tertentu, membuat data Anda lebih mudah dipahami dan dianalisis. Dengan mengonfigurasi bidang yang diinginkan untuk penyortiran, Anda dapat mengontrol urutan data disajikan dalam tabel atau visualisasi.

Gunakan sakelar **Reverse** untuk memesan nilai secara terbalik dalam bidang yang ditentukan. Fungsionalitas ini sangat berguna ketika Anda ingin beralih dengan cepat antara urutan naik dan turun agar sesuai dengan kebutuhan analitis Anda.

Misalnya, dalam skenario di mana data deret waktu diambil dari sumber data, **Urutkan berdasarkan** transformasi dapat diterapkan untuk mengatur kerangka data berdasarkan stempel waktu, baik dalam urutan naik atau turun, tergantung pada persyaratan analitis. Kemampuan ini memastikan bahwa Anda dapat dengan mudah menavigasi dan menafsirkan data deret waktu, mendapatkan wawasan berharga dari presentasi yang terorganisir dan koheren secara visual.

## Spatial
<a name="v10-panels-xform-funcs-spatial"></a>

Gunakan transformasi ini untuk menerapkan operasi spasial ke hasil kueri.
+ **Tindakan** - Pilih tindakan:
  + **Siapkan bidang spasial** — Tetapkan bidang geometri berdasarkan hasil bidang lainnya.
    + **Mode lokasi** - Pilih mode lokasi (opsi ini dibagikan oleh **nilai Hitung** dan mode **Transformasi**):
      + **Otomatis** - Mengidentifikasi data lokasi secara otomatis berdasarkan nama bidang default.
      + **Coords** — Tentukan bidang lintang dan bujur.
      + **Geohash** — Tentukan bidang geohash.
      + **Pencarian** — Tentukan bidang lokasi Gazetteer.
  + **Hitung nilai** — Gunakan geometri untuk menentukan bidang baru (heading/distance/area).
    + **Fungsi** — Pilih operasi matematika untuk diterapkan pada geometri:
      + **Heading** — Hitung heading (arah) antara dua titik.
      + **Luas** — Hitung luas yang tertutup oleh poligon yang ditentukan oleh geometri.
      + **Jarak** — Hitung jarak antara dua titik.
  + **Transform** — Terapkan operasi spasial ke geometri.
    + **Operasi** - Pilih operasi untuk diterapkan pada geometri:
      + **Sebagai garis** - Buat fitur baris tunggal dengan simpul di setiap baris.
      + **Pembuat garis** - Buat garis antara dua titik.

Transformasi ini memungkinkan Anda untuk memanipulasi dan menganalisis data geospasial, memungkinkan operasi seperti membuat garis antar titik, menghitung properti spasial, dan banyak lagi.

## Transformasi deret waktu ke tabel
<a name="v10-panels-xform-funcs-seriestotable"></a>

Gunakan transformasi ini untuk mengubah hasil deret waktu menjadi tabel, mengubah kerangka data deret waktu menjadi bidang **Trend**. Bidang **Trend** kemudian dapat dirender menggunakan [jenis sel sparkline](v10-panels-table.md#v10-panels-table-cell-type), menghasilkan sparkline sebaris untuk setiap baris tabel. Jika ada beberapa kueri deret waktu, masing-masing akan menghasilkan bingkai data tabel terpisah. Ini dapat digabungkan menggunakan join atau merge transforms untuk menghasilkan satu tabel dengan beberapa sparkline per baris.

Untuk setiap nilai bidang **Trend** yang dihasilkan, fungsi perhitungan dapat dipilih. Defaultnya adalah **Nilai non-null Terakhir**. Nilai ini ditampilkan di sebelah sparkline dan digunakan untuk menyortir baris tabel.

## Analisis regresi
<a name="v10-panels-xform-funcs-regression"></a>

Gunakan transformasi ini untuk membuat bingkai data baru yang berisi nilai yang diprediksi oleh model statistik. Ini berguna untuk menemukan tren dalam data kacau. Ia bekerja dengan menyesuaikan fungsi matematika ke data, menggunakan regresi linier atau polinomial. Bingkai data kemudian dapat digunakan dalam visualisasi untuk menampilkan garis tren.

Ada dua model yang berbeda:
+  **Regresi linier** — Sesuai dengan fungsi linier ke data.
+  **Regresi polinomial** — Sesuai dengan fungsi polinomial dengan data.

**catatan**  
Transformasi ini saat ini dalam pratinjau publik. Grafana Labs menawarkan dukungan terbatas, dan perubahan yang melanggar mungkin terjadi sebelum fitur tersedia secara umum.

# Memecahkan masalah kueri
<a name="v10-panels-query-troubleshoot"></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)

Halaman ini memberikan informasi untuk memecahkan masalah dasbor umum.

**Saya mendapatkan hasil yang berbeda ketika saya mengatur ulang fungsi saya**

Urutan fungsi sangat penting. Sama seperti dalam matematika, urutan yang Anda tempatkan fungsi Anda dapat memengaruhi hasilnya.

**Periksa permintaan dan respons kueri Anda**

Masalah yang paling umum terkait dengan permintaan dan respons dari sumber data Anda. Bahkan jika itu terlihat seperti masalah bug atau visualisasi di Grafana, hampir selalu masalah dengan kueri sumber data atau respons sumber data. Mulailah dengan memeriksa permintaan dan respons panel Anda.

Untuk informasi selengkapnya, lihat [Periksa data permintaan dan respons](v10-panels-panel-inspector.md).

**Kueri saya lambat**

Berapa banyak titik data yang dikembalikan kueri Anda? Kueri yang mengembalikan banyak titik data akan lambat. Coba ini:
+ Dalam **opsi Query**, batasi **poin data Max** yang dikembalikan.
+ Dalam **opsi Query**, tingkatkan waktu **interval Min**.
+ Dalam kueri Anda, gunakan `group by` fungsi.

# Jenis perhitungan
<a name="v10-panels-calculation-types"></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)

Tabel berikut berisi daftar perhitungan yang dapat Anda lakukan di Grafana. Anda dapat menemukan perhitungan ini di tab **Transform** dan di bar gauge, gauge, dan visualisasi stat.


| Penghitungan | Deskripsi | 
| --- | --- | 
| Semua nol | Benar ketika semua nilai nol | 
| Semua nilai | Array dengan semua nilai | 
| Semua nilai unik | Array dengan semua nilai unik | 
| Semua nol | Benar ketika semua nilai 0 | 
| Ubah hitungan | Berapa kali nilai bidang berubah | 
| Hitungan | Jumlah nilai dalam bidang | 
| kuala | Perubahan nilai kumulatif, hanya menghitung kenaikan | 
| Perbedaan | Perbedaan antara nilai pertama dan terakhir dari suatu bidang | 
| Perbedaan persen | Persentase perubahan antara nilai pertama dan terakhir bidang | 
| Hitungan yang berbeda | Jumlah nilai unik dalam bidang | 
| Pertama | Nilai pertama dalam bidang | 
| Pertama\$1 (bukan null) | Pertama, bukan nilai null di bidang (juga tidak termasuk NaNs) | 
| Terakhir | Nilai terakhir dalam bidang | 
| Terakhir\$1 (bukan null) | Terakhir, bukan nilai null di bidang (juga tidak termasuk NaNs) | 
| Maks | Nilai maksimum bidang | 
| Berarti | Nilai rata-rata dari semua nilai dalam bidang | 
| Varians | Varians dari semua nilai dalam bidang | 
| StdDev | Standar deviasi dari semua nilai dalam bidang | 
| Min | Nilai minimum bidang | 
| Min (di atas nol) | Minimum, nilai positif dari suatu bidang | 
| Kisaran | Perbedaan antara nilai maksimum dan minimum bidang | 
| Langkah | Interval minimal antara nilai bidang | 
| Total | Jumlah semua nilai dalam bidang | 

# Konfigurasikan opsi panel
<a name="v10-panels-configure-panel-options"></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)

Panel Grafana adalah representasi visual dari data yang dapat Anda sesuaikan dengan menentukan kueri sumber data, mengubah dan memformat data, dan mengonfigurasi pengaturan visualisasi.

Editor panel menyertakan pembuat kueri dan serangkaian opsi yang dapat Anda gunakan untuk mengubah data dan menambahkan informasi ke panel Anda.

Topik ini menjelaskan cara:
+ Buka panel untuk mengedit
+ Tambahkan judul dan deskripsi panel
+ Lihat model panel JSON
+ Konfigurasikan baris dan panel berulang

## Mengedit panel
<a name="v10-panels-edit-a-panel"></a>

Setelah menambahkan panel ke dasbor, Anda dapat membukanya kapan saja untuk mengubah atau memperbarui kueri, menambahkan transformasi data, dan mengubah pengaturan visualisasi.

**Untuk mengedit panel**

1. Buka dasbor yang berisi panel yang ingin Anda edit.

1. Arahkan kursor ke bagian mana pun dari panel untuk menampilkan menu tindakan di sudut kanan atas.

1. Pilih menu dan pilih **Edit**.

   Untuk menggunakan pintasan keyboard untuk membuka panel, arahkan kursor ke panel dan tekan. `e`

   Panel terbuka dalam mode edit.

## Tambahkan judul dan deskripsi ke panel
<a name="v10-panels-add-title-description"></a>

Tambahkan judul dan deskripsi ke panel untuk berbagi dengan pengguna informasi penting tentang visualisasi. Misalnya, gunakan deskripsi untuk mendokumentasikan tujuan visualisasi.

1. Edit panel.

1. Di panel opsi tampilan panel, cari bagian **Opsi panel**.

1. Masukkan **Judul**.

   Teks yang dimasukkan di bidang ini muncul di tooltip di editor panel dan di dasbor.

1. Tulis deskripsi panel dan data yang Anda tampilkan.

   Teks yang dimasukkan dalam bidang ini muncul di tooltip di sudut kiri atas panel.

   Anda dapat menggunakan [variabel yang telah Anda tentukan](v10-dash-variables.md) di bidang **Judul** dan **Deskripsi**, tetapi bukan [variabel global](v10-dash-variable-add.md#v10-dash-variable-add-global).

## Melihat model panel JSON
<a name="v10-panels-json-model"></a>

Jelajahi dan ekspor panel, data panel, dan model JSON bingkai data.

**Untuk melihat model panel JSON**

1. Buka dasbor yang berisi panel.

1. Arahkan kursor ke bagian mana pun dari panel untuk menampilkan menu tindakan di sudut kanan atas.

1. Dari menu, pilih **Inspect > Panel JSON**.

1. Di bidang **Pilih sumber**, pilih salah satu opsi berikut:
   + **Panel JSON** - Menampilkan objek JSON yang mewakili panel.
   + **Data panel** - Menampilkan objek JSON yang mewakili data yang diteruskan ke panel.
   + **DataFrame struktur** — Menampilkan struktur data panel, termasuk transformasi, konfigurasi bidang, dan konfigurasi penggantian yang telah diterapkan.

1. Untuk menjelajahi JSON, pilih **>** untuk memperluas atau menciutkan bagian dari model JSON.

## Mengkonfigurasi panel berulang
<a name="v10-panels-configure-repeating-panels"></a>

Anda dapat mengonfigurasi Grafana untuk menambahkan panel atau baris secara dinamis ke dasbor. Panel dinamis adalah panel yang dibuat sistem berdasarkan nilai variabel. Variabel secara dinamis mengubah kueri Anda di semua panel di dasbor. Untuk informasi selengkapnya tentang panel berulang, lihat[Membuat dasbor](v10-dash-creating.md).

**catatan**  
Panel berulang membutuhkan variabel untuk memiliki satu atau lebih item yang dipilih; Anda tidak dapat mengulang panel nol kali untuk menyembunyikannya.

*Prekusit*
+ Pastikan bahwa kueri menyertakan variabel multi-nilai.

**Untuk mengkonfigurasi panel berulang**

1. Edit panel yang ingin Anda ulangi.

1. Pada panel opsi tampilan, pilih Opsi **panel > Opsi Ulangi**.

1. Pilih **arah**.
   + Pilih **horisontal** untuk mengatur panel side-by-side. Grafana menyesuaikan lebar panel berulang. Anda tidak dapat mencampur panel lain secara berurutan dengan panel berulang.
   + Pilih **vertikal** untuk mengatur panel dalam kolom. Lebar panel berulang sama dengan panel asli yang berulang.

1. Untuk menyebarkan perubahan ke semua panel, muat ulang dasbor.

# Konfigurasikan opsi standar
<a name="v10-panels-configure-standard-options"></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)

Model data yang digunakan dalam Grafana adalah struktur tabel berorientasi kolumnar yang menyatukan deret waktu dan hasil kueri tabel. Setiap kolom dalam struktur ini disebut *bidang*. Bidang dapat mewakili satu deret waktu atau kolom tabel.

Opsi bidang memungkinkan Anda mengubah cara data ditampilkan dalam visualisasi Anda. Opsi dan penggantian yang Anda terapkan tidak mengubah data, mereka mengubah cara Grafana menampilkan data. Ketika Anda mengubah opsi, itu diterapkan ke semua bidang, yang berarti semua seri atau kolom. Misalnya, jika Anda mengubah unit menjadi persentase, maka semua bidang dengan nilai numerik ditampilkan dalam persentase.

Daftar lengkap opsi pemformatan bidang disertakan nanti dalam topik ini.

**catatan**  
Anda dapat menerapkan opsi standar ke sebagian besar panel Grafana bawaan. Beberapa panel lama dan panel komunitas yang belum diperbarui ke panel baru dan model data akan kehilangan semua atau beberapa opsi bidang ini.

**Untuk mengkonfigurasi opsi standar**

1. Buka dasbor. Arahkan kursor ke bagian mana pun dari panel untuk menampilkan menu tindakan di sudut kanan atas dasbor.

1. Dari menu tindakan, pilih **Edit**.

1. Di panel opsi tampilan panel, cari bagian **Opsi standar**.

1. Pilih opsi standar yang ingin Anda terapkan.

1. Untuk melihat pratinjau perubahan Anda, pilih di luar kotak opsi bidang yang sedang Anda edit atau tekan **Enter**.

**Definisi opsi standar**

Bagian ini menjelaskan semua opsi standar yang tersedia.

Anda dapat menerapkan opsi standar ke sebagian besar panel Grafana bawaan. Beberapa panel lama dan panel komunitas yang belum diperbarui ke panel baru dan model data akan kehilangan semua atau beberapa opsi bidang ini.

Sebagian besar opsi bidang tidak akan memengaruhi visualisasi sampai Anda mengklik di luar kotak opsi bidang yang sedang Anda edit atau tekan **Enter**.

**catatan**  
Grafana Labs terus bekerja untuk menambah dan memperluas opsi untuk semua visualisasi, jadi semua opsi mungkin tidak tersedia untuk semua visualisasi.

## Unit
<a name="v10-panels-standard-options-unit"></a>

Memungkinkan Anda memilih unit apa yang harus digunakan bidang. Pilih bidang **Unit**, lalu telusuri sampai Anda menemukan unit yang Anda inginkan. Unit yang Anda pilih diterapkan ke semua bidang kecuali waktu.

### Unit kustom
<a name="v10-panels-standard-options-custom-units"></a>

Anda dapat menggunakan dropdown unit untuk juga menentukan unit kustom, awalan kustom atau akhiran dan format waktu tanggal.

Untuk memilih unit kustom, masukkan unit dan pilih opsi **Custom: xxx** terakhir di dropdown.
+ **akhiran:** <suffix>untuk unit khusus yang harus mengikuti nilai.
+ **awalan:** <prefix>untuk unit kustom yang harus pergi sebelum nilai.
+ **time:** <format>Untuk format waktu tanggal kustom, ketik misalnya`time:YYYY-MM-DD`. Lihat [format](https://momentjs.com/docs/#/displaying/) dalam *Dokumentasi Moment.js* untuk sintaks format dan opsi.
+ **si:** <base scale><unit characters>untuk unit SI kustom. Sebagai contoh: `si: mF`. Ini sedikit lebih maju karena Anda dapat menentukan unit dan skala data sumber. Jadi jika data sumber Anda direpresentasikan sebagai milli (ribuan) sesuatu mengawali unit dengan karakter skala SI itu.
+ **count:** <unit>untuk unit hitungan kustom.
+ **mata uang:** <unit>untuk kustom unit mata uang.

Anda juga dapat menempelkan emoji asli di pemilih unit dan memilihnya sebagai unit khusus.

### Satuan string
<a name="v10-panels-standard-options-string-units"></a>

Grafana terkadang bisa terlalu agresif dalam mengurai string dan menampilkannya sebagai angka. **Untuk mengonfigurasi Grafana untuk menampilkan nilai string asli, buat penggantian bidang dan tambahkan properti unit dengan unit String.**

### Satuan skala
<a name="v10-panels-standard-options-scale-units"></a>

Secara default, Grafana secara otomatis menskalakan unit berdasarkan besarnya nilai. Misalnya, jika Anda memiliki nilai 0,14 kW, Grafana akan menampilkannya sebagai 140 W. Contoh lain adalah bahwa 3000 kW akan ditampilkan sebagai tiga MW. Jika Anda ingin menonaktifkan perilaku ini, Anda dapat mematikan sakelar **Scale units**.

## Min
<a name="v10-panels-standard-options-min"></a>

Memungkinkan Anda menetapkan nilai minimum yang digunakan dalam perhitungan ambang persentase. Biarkan kosong untuk menghitung minimum secara otomatis.

## Maks
<a name="v10-panels-standard-options-max"></a>

Memungkinkan Anda menetapkan nilai maksimum yang digunakan dalam perhitungan ambang persentase. Biarkan kosong untuk menghitung maksimum secara otomatis.

## Bidang min/maks
<a name="v10-panels-standard-options-fieldminmax"></a>

Secara default, min dan maks yang dihitung akan didasarkan pada minimum dan maksimum, di semua seri dan bidang. min/max Menghidupkan bidang akan menghitung min atau maks pada setiap bidang secara individual, berdasarkan minimum atau maksimum bidang itu.

## Desimal
<a name="v10-panels-standard-options-decimals"></a>

Tentukan jumlah desimal Grafana termasuk dalam nilai yang diberikan. Jika Anda membiarkan bidang ini kosong, Grafana secara otomatis memotong jumlah desimal berdasarkan nilainya. Misalnya 1.1234 akan ditampilkan sebagai 1.12 dan 100.456 akan ditampilkan sebagai 100.

**Untuk menampilkan semua desimal, atur unit ke String.**

## Nama tampilan
<a name="v10-panels-standard-options-displayname"></a>

Memungkinkan Anda mengatur judul tampilan semua bidang. Anda dapat menggunakan [variabel](v10-dash-variables.md) dalam judul bidang.

Ketika beberapa statistik, bidang, atau seri ditampilkan, bidang ini mengontrol judul di setiap stat. Anda dapat menggunakan ekspresi seperti **\$1 \$1\$1\$1field.name\$1** untuk hanya menggunakan nama seri atau nama bidang dalam judul.

Diberikan bidang dengan nama`Temp`, dan label`{"Loc"="PBI", "Sensor"="3"}`:


| Sintaksis ekspresi | Contoh | Render ke | Penjelasan | 
| --- | --- | --- | --- | 
| \$1\$1\$1\$1field.displayName\$1 | Sama seperti sintaks | Temp \$1Loc="PBI", Sensor="3"\$1 | Menampilkan nama bidang, dan label \$1\$1 jika ada. Jika hanya ada satu kunci label dalam respons, maka untuk bagian label, Grafana menampilkan nilai label tanpa tanda kurung yang terlampir. | 
| \$1\$1\$1\$1field.name\$1 | Sama seperti sintaks | Temp | Menampilkan nama bidang (tanpa label). | 
| \$1\$1\$1\$1field.labels\$1 | Sama seperti sintaks | Loc="PBI", Sensor="3" | Menampilkan label tanpa nama. | 
| \$1\$1\$1\$1field.labels.X\$1 | \$1\$1\$1\$1field.labels.Loc\$1 | PBI | Menampilkan nilai kunci label yang ditentukan. | 
| \$1\$1\$1\$1field.labels.\$1\$1values\$1 | Sama seperti Sintaks | PBI, 3 | Menampilkan nilai-nilai label yang dipisahkan oleh koma (tanpa kunci label). | 

Jika nilainya adalah string kosong setelah merender ekspresi untuk bidang tertentu, maka metode tampilan default digunakan.

## Skema warna
<a name="v10-panels-standard-options-color-scheme"></a>

Pilihan warna dan efeknya pada visualisasi tergantung pada visualisasi yang Anda kerjakan. Beberapa visualisasi memiliki pilihan warna yang berbeda.

Anda dapat menentukan satu warna, atau memilih skema warna kontinu (gradien), berdasarkan nilai. Warna kontinu menginterpolasi warna menggunakan persentase nilai relatif terhadap min dan maks.

Pilih salah satu palet berikut:


| Mode warna | Deskripsi | 
| --- | --- | 
| Warna tunggal | Tentukan satu warna, berguna dalam aturan penggantian | 
| Nuansa warna | Memilih nuansa warna tunggal, berguna dalam aturan penggantian | 
| Dari ambang batas | Menginformasikan Grafana untuk mengambil warna dari ambang yang cocok | 
| Palet klasik | Grafana akan menetapkan warna dengan mencari warna dalam palet dengan indeks seri. Berguna untuk Grafik dan diagram lingkaran dan visualisasi data kategoris lainnya | 
| Palet klasik (dengan nama seri) | Grafana akan menetapkan warna berdasarkan nama seri. Berguna ketika nama seri yang akan di-vsiualisasi bergantung pada data yang tersedia. | 
| Green-Yellow-Red (berdasarkan nilai) | Skema warna berkelanjutan | 
| Red-Yellow-Green (berdasarkan nilai) | Skema warna berkelanjutan | 
| Blue-Yellow-Red (berdasarkan nilai) | Skema warna berkelanjutan | 
| Kuning-Merah (berdasarkan nilai) | Skema warna berkelanjutan | 
| Biru-Ungu (berdasarkan nilai) | Skema warna berkelanjutan | 
| Kuning-Biru (berdasarkan nilai) | Skema warna berkelanjutan | 
| Blues (berdasarkan nilai) | Skema warna terus menerus (latar belakang panel ke biru) | 
| Merah (berdasarkan nilai) | Skema warna terus menerus (warna latar belakang panel menjadi merah) | 
| Hijau (berdasarkan nilai) | Skema warna terus menerus (warna latar belakang panel ke hijau) | 
| Ungu (berdasarkan nilai) | Skema warna terus menerus (warna latar belakang panel ke ungu) | 

## Tidak ada nilai
<a name="v10-panels-standard-options-no-value"></a>

Masukkan apa yang harus ditampilkan Grafana jika nilai bidang kosong atau nol. Nilai default adalah tanda hubung (-).

# Konfigurasikan legenda
<a name="v10-panels-configure-legend"></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)

Panel menyertakan legenda yang dapat Anda gunakan untuk menafsirkan data yang ditampilkan dalam visualisasi. Setiap opsi legenda menambahkan konteks dan kejelasan pada data yang diilustrasikan dalam visualisasi.

Legenda didukung untuk visualisasi berikut:
+ [Bagan batang](v10-panels-bar-chart.md)
+ [Candlestick](v10-panels-candlestick.md)
+ [Histogram](v10-panels-histogram.md)
+ [Bagan pai](v10-panels-piechart.md)
+ [Garis waktu negara](v10-panels-state-timeline.md)
+ [Riwayat status](v10-panels-status-history.md)
+ [Deret waktu](v10-panels-time-series.md)
+ [Tren](v10-panels-trend.md)

[Geomaps](v10-panels-geomap.md) dan [Heatmaps](v10-panels-heatmap.md) juga memiliki legenda, tetapi mereka hanya menyediakan pilihan untuk menampilkan atau tidak menampilkan legenda, dan tidak mendukung opsi legenda lainnya.

## Opsi legenda
<a name="v10-panels-legend-options"></a>

Anda dapat menemukan opsi berikut di bawah **Legenda** bagian di panel edit panel.

**catatan**  
Tidak semua opsi yang tercantum berlaku untuk semua visualisasi dengan legenda.

**Visibilitas**

Atur apakah legenda ditampilkan atau tidak. Gunakan sakelar untuk mengaktifkan atau menonaktifkan legenda.

**Modus**

Atur format di mana legenda ditampilkan. Pilih antara:
+ **Daftar**
+ **Tabel**

Saat Anda memformat legenda sebagai tabel, informasi lain tentang legenda, seperti nilai terkait atau letaknya dalam visualisasi, mungkin juga ditampilkan.

**Penempatan**

Atur di mana pada visualisasi sebuah legenda ditampilkan. Pilih antara:
+ **Bawah**
+ **Kanan**

**Lebar**

Jika Anda mengatur penempatan legenda ke **Kanan**, opsi **Lebar** menjadi tersedia. Biarkan bidang kosong untuk memungkinkan Grafana mengatur lebar legenda secara otomatis, atau masukkan lembah di bidang.

**Nilai-nilai**

Anda dapat menambahkan lebih banyak konteks ke visualisasi dengan menambahkan nilai data seri atau [perhitungan](v10-panels-calculation-types.md) ke legenda. Anda dapat menambahkan nilai sebanyak yang Anda suka. Setelah menerapkan perubahan, Anda dapat menggulir legenda untuk melihat semua nilai.

## Mengubah warna seri
<a name="v10-panels-legend-change-color"></a>

Secara default, Grafana menetapkan warna data seri Anda, tetapi Anda dapat mengubahnya melalui legenda panel.

**Untuk mengubah warna seri**

1. Arahkan ke panel yang ingin Anda perbarui.

1. Dalam legenda, pilih bilah warna yang terkait dengan seri.

1. Pilih warna yang telah ditetapkan sebelumnya di tab **Warna** atau atur warna khusus di tab **Kustom**, menggunakan pemilih atau nilai RGB.

1. Simpan dasbor.

## Mengisolasi data seri dalam visualisasi
<a name="v10-panels-legend-isolate"></a>

Visualisasi seringkali dapat menjadi kompleks secara visual, dan mencakup banyak seri data. Anda dapat menyederhanakan tampilan dengan menghapus data seri dari visualisasi melalui legenda, yang mengisolasi data yang ingin Anda lihat. **Saat Anda melakukan ini, Grafana secara otomatis membuat penggantian baru di tab Override.**

**Untuk mengisolasi data seri dalam visualisasi**

1. Arahkan ke panel yang ingin Anda perbarui.

1. Dalam legenda, pilih label seri yang ingin Anda isolasi.

   Sistem menghapus dari tampilan semua data seri lainnya.

1. Untuk menambahkan data seri secara bertahap kembali ke seri terisolasi, tekan tombol **Ctrl** atau **Command** dan pilih label seri yang ingin Anda tambahkan.

1. Untuk menyimpan perubahan Anda sehingga muncul ke semua pemirsa panel, simpan dasbor.

Untuk kembali ke tampilan default yang menyertakan semua data, klik label seri dua kali.

## Seri penyortiran
<a name="v10-panels-legend-sort"></a>

Saat Anda memformat legenda sebagai tabel dan menambahkan nilai ke dalamnya, Anda dapat mengurutkan seri dalam tabel berdasarkan nilai-nilai tersebut.

**Untuk mengurutkan seri**

1. Arahkan ke panel yang ingin Anda perbarui.

1. Arahkan kursor ke bagian mana pun dari panel yang ingin Anda kerjakan untuk menampilkan menu di sudut kanan atas panel.

1. Dari menu, pilih **Edit**.

1. Gulir ke bagian **Legenda** pada panel edit panel.

1. Di bawah **Nilai**, pilih nilai atau perhitungan yang ingin Anda tampilkan.

   Legenda sekarang menampilkan nilai.

1. Pilih header nama perhitungan di tabel legenda untuk mengurutkan nilai dalam tabel dalam urutan naik atau turun.

**catatan**  
Fitur ini hanya didukung di panel ini: diagram batang, histogram, deret waktu.

# Konfigurasikan tautan data
<a name="v10-panels-configure-data-links"></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)

Tautan data memungkinkan Anda memberikan konteks yang lebih terperinci ke tautan Anda. Anda dapat membuat tautan yang menyertakan nama seri atau bahkan nilai di bawah kursor. Misalnya, jika visualisasi Anda menunjukkan empat server, Anda dapat menambahkan datalink ke satu atau dua server. Anda juga dapat menautkan panel menggunakan tautan data.

Tautan itu sendiri dapat diakses dengan berbagai cara tergantung pada visualisasi. Untuk visualisasi deret waktu, misalnya, Anda memilih titik atau garis data. Untuk visualisasi area yang luas, seperti stat, gauge, atau bar gauge, Anda dapat memilih di mana saja pada visualisasi untuk membuka menu konteks.

Jika hanya ada satu tautan data dalam visualisasi, memilih di mana saja pada visualisasi akan membuka tautan daripada menu konteks.

**Visualisasi yang didukung**
+ Bagan batang
+ Pengukur batang
+ Candlestick
+ Kanvas
+ Pengukur
+ Geomap
+ Peta panas
+ Histogram
+ Bagan pai
+ Stat
+ Garis waktu negara
+ Riwayat status
+ Tabel
+ Deret waktu
+ Tren

## Variabel tautan data
<a name="v10-panels-data-link-variables"></a>

Variabel dalam tautan data memungkinkan Anda mengirim orang ke dasbor terperinci dengan filter data yang diawetkan. Misalnya, Anda dapat menggunakan variabel untuk menentukan label, rentang waktu, seri, atau pemilihan variabel.

Untuk melihat daftar variabel yang tersedia, ketik `$` bidang **URL** tautan data.

Anda juga dapat menggunakan variabel template di tautan data Anda URLs, lihat[Variabel](v10-dash-variables.md).

### Variabel panel rentang waktu
<a name="v10-panels-time-range-panel-variables"></a>

Variabel ini memungkinkan Anda untuk memasukkan rentang waktu saat ini dalam URL tautan data.
+ `__url_time_range`— rentang waktu dasbor saat ini (mis.`?from=now-6h&to=now`)
+ `$__from`— Untuk informasi lebih lanjut, lihat[Variabel global](v10-dash-variable-add.md#v10-dash-variable-add-global).
+ `$__to`— Untuk informasi lebih lanjut, lihat[Variabel global](v10-dash-variable-add.md#v10-dash-variable-add-global).

### Variabel seri
<a name="v10-panels-series-variables"></a>

Variabel spesifik seri tersedia di bawah `__series` namespace:
+ `__series.name`— nama seri ke URL

### Variabel bidang
<a name="v10-panels-field-variables"></a>

Variabel khusus bidang tersedia di bawah namespace: `__field`
+ `__field.name`— nama bidang
+ `__field.labels.<LABEL>`— nilai label ke URL. Jika label Anda berisi titik-titik, maka gunakan `__field.labels["<LABEL>"]` sintaks.

### Variabel nilai
<a name="v10-panels-value-variables"></a>

Variabel spesifik nilai tersedia di bawah `__value` namespace:
+ `__value.time`— stempel waktu nilai (Unix ms epoch) ke URL (mis.) `?time=1560268814105`
+ `__value.raw`— nilai mentah
+ `__value.numeric`— representasi numerik dari suatu nilai
+ `__value.text`— representasi teks dari suatu nilai
+ `__value.calc`— nama perhitungan jika nilainya adalah hasil perhitungan

Menggunakan variabel spesifik nilai dalam tautan data dapat menunjukkan hasil yang berbeda tergantung pada opsi set mode Tooltip.

### Variabel data
<a name="v10-panels-data-variables"></a>

Untuk mengakses nilai dari bidang lain gunakan:
+ `__data.fields[i]`— Nilai bidang `i` (pada baris yang sama).
+ `__data.fields["NameOfField"]`— Nilai bidang menggunakan nama bukan indeks.
+ `__data.fields[i].labels.cluster`— Akses label bidang lain.

### Variabel template
<a name="v10-panels-template-variables"></a>

Saat menautkan ke dasbor lain yang menggunakan variabel template, pilih nilai variabel untuk siapa pun yang mengklik tautan.

`${var-myvar:queryparam}`— di mana `var-myvar` adalah nama variabel template yang cocok dengan satu di dasbor saat ini yang ingin Anda gunakan.


| Status variabel | Hasil di URL yang dibuat | 
| --- | --- | 
| memilih satu nilai | var-myvar=value1 | 
| memilih beberapa nilai | var-myvar=value1&var-myvar=value2 | 
| terpilih All | var-myvar=All | 

Jika Anda ingin menambahkan semua variabel dasbor saat ini ke URL, gunakan`${__all_variables}`.

## Menambahkan tautan data
<a name="v10-panels-add-a-datalink"></a>

Anda dapat menambahkan tautan data ke panel Anda.

1. Arahkan ke panel tempat Anda ingin menambahkan tautan data.

1. Arahkan kursor ke panel untuk menampilkan ikon menu di sudut kanan atas.

1. Dari menu, pilih **Edit** untuk membuka editor panel.

1. Di **panel Edit panel**, gulir ke bawah ke bagian **Tautan data** dan perluas.

1. Pilih **Tambahkan tautan**.

1. Di kotak dialog yang terbuka, masukkan **Judul**. Ini adalah label yang dapat dibaca manusia untuk tautan, yang akan ditampilkan di UI.

1. Masukkan **URL** atau variabel yang ingin Anda tautkan.

   Untuk menambahkan variabel tautan data, pilih bidang **URL** lalu masukkan `$` atau tekan Ctrl\$1Spasi atau Cmd\$1Spasi untuk melihat daftar variabel yang tersedia.

1. Jika Anda ingin tautan terbuka di tab baru, pilih **Buka di tab baru**.

1. Pilih **Simpan** untuk menyimpan perubahan dan menutup kotak dialog.

1. Simpan perubahan Anda ke dasbor.

# Konfigurasikan pemetaan nilai
<a name="v10-panels-configure-value-mappings"></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)

Selain penggantian bidang, pemetaan nilai adalah teknik yang dapat Anda gunakan untuk mengubah bagaimana data muncul dalam visualisasi.

Pemetaan nilai melewati set pemformatan unit di [Opsi standar](v10-panels-configure-standard-options.md) editor panel, seperti warna atau jumlah tempat desimal yang ditampilkan. Saat pemetaan nilai hadir di panel, Grafana menampilkan ringkasannya di bagian **Pemetaan nilai** pada editor panel.

**Visualisasi yang didukung**
+ Bagan batang
+ Pengukur batang
+ Candlestick
+ Kanvas
+ Pengukur
+ Geomap
+ Histogram
+ Bagan pai
+ Stat
+ Garis waktu negara
+ Riwayat status
+ Tabel
+ Deret waktu
+ Tren

## Jenis pemetaan nilai
<a name="v10-panels-value-mappings-types"></a>

Grafana mendukung jenis pemetaan nilai berikut:
+ **Nilai** — Memetakan nilai tertentu ke teks dan warna. Misalnya, Anda dapat mengonfigurasi pemetaan nilai sehingga semua contoh nilai `10` muncul sebagai `Perfection!` bukan angka. Gunakan pemetaan **Nilai** saat Anda ingin memformat satu nilai.
+ **Rentang** - Memetakan rentang numerik ke teks dan warna. Misalnya, jika nilai berada dalam rentang tertentu, Anda dapat mengonfigurasi pemetaan nilai rentang untuk ditampilkan `Low` atau `High` bukan angka. Gunakan pemetaan **Rentang** saat Anda ingin memformat beberapa nilai kontinu.
+ **Regex** — Memetakan ekspresi reguler ke teks dan warna. Misalnya, jika nilainya`www.example.com`, Anda dapat mengonfigurasi pemetaan nilai regex sehingga Grafana menampilkan `www` dan memotong domain. Gunakan pemetaan **Regex** saat Anda ingin memformat teks dan warna nilai ekspresi reguler.
+ **Khusus** - Peta nilai khusus seperti`Null`, `NaN` (bukan angka), dan nilai Boolean seperti `true` dan `false` ke teks dan warna. Misalnya, Anda dapat mengonfigurasi pemetaan nilai khusus sehingga `null` nilai muncul sebagai`N/A`. Gunakan mappiong **Khusus** saat Anda ingin memformat uncommon, Boolean, atau nilai kosong.

## Menambahkan pemetaan nilai
<a name="v10-panels-value-mappings-add"></a>

Anda dapat menambahkan pemetaan nilai ke panel Anda.

**Untuk menambahkan pemetaan nilai**

1. Arahkan ke panel yang ingin Anda perbarui.

1. Arahkan kursor ke bagian mana pun dari panel untuk menampilkan menu di sudut kanan atas panel.

1. Dari menu, pilih **Edit**.

1. Di bagian **Pemetaan nilai**, pilih **Tambahkan pemetaan nilai**.

1. Pilih **Tambahkan pemetaan baru**, lalu pilih salah satu dari berikut ini:
   + **Nilai** - Masukkan satu nilai untuk dicocokkan.
   + **Rentang** - Masukkan nilai awal dan akhir dari rentang yang cocok.
   + **Regex** - Masukkan pola ekspresi reguler untuk mencocokkan.
   + **Khusus** - Pilih nilai khusus untuk dicocokkan.

1. (Opsional) Masukkan teks tampilan.

1. (Opsional) Atur warnanya.

1. Pilih **Perbarui** untuk menyimpan pemetaan nilai.

Setelah Anda menambahkan pemetaan, tombol **Edit pemetaan nilai** menggantikan tombol **Tambah** pemetaan nilai. Pilih tombol edit untuk menambah atau memperbarui pemetaan.

# Konfigurasikan ambang batas
<a name="v10-panels-configure-thresholds"></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)

Di dasbor, ambang batas adalah nilai atau batas yang Anda tetapkan untuk metrik yang dipantulkan secara visual saat terpenuhi atau terlampaui. Ambang batas adalah salah satu cara Anda dapat menata dan mewarnai visualisasi Anda secara kondisional berdasarkan hasil kueri.

Anda dapat menggunakan ambang batas untuk:
+ Garis kisi warna atau area kotak kotak dalam visualisasi deret waktu.
+ Warnai latar belakang atau nilai teks dalam visualisasi stat.
+ Tentukan warna wilayah dan wilayah dalam garis waktu negara bagian.
+ Garis warna dalam visualisasi deret waktu.
+ Warnai pengukur dan penanda ambang batas dalam pengukur.
+ Penanda warna dalam geomap.
+ Teks sel warna atau latar belakang dalam tabel.

**Visualisasi yang didukung**
+ Bagan batang
+ Pengukur batang
+ Candlestick
+ Kanvas
+ Pengukur
+ Geomap
+ Histogram
+ Stat
+ Garis waktu negara
+ Riwayat status
+ Tabel
+ Seri waktu
+ Tren

## Ambang batas default
<a name="v10-panels-thresholds-default"></a>

Pada visualisasi yang mendukung ambang batas, Grafana memiliki pengaturan ambang batas default berikut:
+ 80 = merah
+ Basis = hijau
+ Mode = Mutlak
+ Tampilkan ambang = Mati (untuk beberapa visualisasi)

  Untuk informasi selengkapnya, lihat [Tampilkan ambang batas](#v10-panels-thresholds-show).

## Opsi ambang batas
<a name="v10-panels-thresholds-options"></a>

Anda dapat mengatur opsi berikut untuk lebih menentukan bagaimana ambang batas terlihat.

### Nilai ambang batas
<a name="v10-panels-thresholds-value"></a>

Angka ini adalah nilai yang memicu ambang batas. Anda juga dapat mengatur warna yang terkait dengan ambang batas di bidang ini.

Nilai **dasar** mewakili minus tak terhingga. Secara default, itu diatur ke warna hijau, yang umumnya warna “baik”.

### Modus Ambang
<a name="v10-panels-thresholds-mode"></a>

Ada dua mode ambang batas:
+ Ambang batas **absolut** ditentukan oleh angka. Misalnya, 80 pada skala 1 hingga 150.
+ Ambang batas **persentase** didefinisikan relatif terhadap minimum atau maksimum. Misalnya, 80 persen.

### Tampilkan ambang batas
<a name="v10-panels-thresholds-show"></a>

**catatan**  
Opsi ini hanya didukung untuk grafik batang, kandil, deret waktu, dan visualisasi tren.

Tetapkan jika dan bagaimana ambang ditampilkan pada visualisasi dengan opsi berikut.
+ **Off** — Ambang batas tidak ditampilkan.
+ **Sebagai garis** — Ambang batas ditampilkan sebagai garis horizontal pada visualisasi.
+ **Sebagai garis (putus-putus)** — Ambang batas ditampilkan sebagai garis horizontal putus-putus.
+ **Sebagai wilayah yang diisi** - Ambang batas ditampilkan sebagai daerah horizontal.
+ **Sebagai daerah dan garis yang terisi** — Ambang batas ditampilkan sebagai daerah horizontal yang dipisahkan oleh garis.
+ **Sebagai daerah dan garis yang terisi (putus-putus)** — Ambang batas ditampilkan sebagai daerah horizontal yang dipisahkan oleh garis putus-putus.

## Menambahkan ambang batas
<a name="v10-panels-thresholds-add"></a>

Anda dapat menambahkan ambang batas sebanyak mungkin ke visualisasi yang Anda inginkan. Grafana secara otomatis mengurutkan nilai ambang dari tertinggi ke terendah.

**Untuk menambahkan ambang batas**

1. Arahkan ke panel yang ingin Anda perbarui.

1. Arahkan kursor ke bagian mana pun dari panel untuk menampilkan menu di sudut kanan atas.

1. Dari menu, pilih **Edit**.

1. Gulir ke bagian **Ambang**, atau masukkan `Thresholds` di bilah pencarian di bagian atas panel edit panel.

1. Pilih **\$1 Tambahkan ambang batas**.

1. Masukkan nilai ambang baru, atau gunakan panah atas dan bawah di sisi kanan bidang untuk menambah atau mengurangi nilai secara bertahap.

1. Klik lingkaran berwarna di sebelah kiri nilai ambang batas untuk membuka pemilih warna, tempat Anda dapat memperbarui warna ambang batas.

1. **Di bawah **mode Ambang**, pilih **Absolute** atau Persentase.**

1. Di bawah **Tampilkan ambang batas**, atur bagaimana ambang ditampilkan, atau matikan.

Untuk menghapus ambang batas, arahkan ke panel yang berisi ambang batas dan pilih ikon sampah di sebelah ambang batas yang ingin Anda hapus.

# Konfigurasikan penggantian bidang
<a name="v10-panels-configure-overrides"></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)

Override memungkinkan Anda untuk menyesuaikan pengaturan visualisasi untuk bidang atau seri tertentu. Ini dilakukan dengan menambahkan aturan penggantian yang menargetkan sekumpulan bidang tertentu dan yang masing-masing dapat menentukan beberapa opsi.

Misalnya, Anda menyetel unit untuk semua bidang yang menyertakan teks `bytes` dengan menambahkan penggantian menggunakan **Kolom dengan pencocokan nama regex** yang cocok dan kemudian menambahkan opsi Unit ke aturan penggantian.

## Contoh 1: Format suhu
<a name="v10-panels-overrides-format-temperature"></a>

Mari kita asumsikan bahwa kumpulan hasil kita adalah bingkai data yang terdiri dari dua bidang: `time` dan`temperature`.


| Waktu | suhu | 
| --- | --- | 
| 2020-01-02 03:04:00 | 45,0 | 
| 2020-01-02 03:05:00 | 47.0 | 
| 2020-01-02 03:06:00 | 48,0 | 

Setiap bidang (kolom) dari struktur ini dapat memiliki opsi bidang yang diterapkan yang mengubah cara nilainya ditampilkan. Ini berarti Anda dapat, misalnya, mengatur Satuan ke Temperature > Celcius, menghasilkan tabel berikut:


| Waktu | suhu | 
| --- | --- | 
| 2020-01-02 03:04:00 | 45.0 °C | 
| 2020-01-02 03:05:00 | 47.0 °C | 
| 2020-01-02 03:06:00 | 48.0 °C | 

Selain itu, tempat desimal tidak diperlukan, sehingga kami dapat menghapusnya. Anda dapat mengubah Desimal dari **auto** ke nol (**0**), menghasilkan tabel berikut:


| Waktu | suhu | 
| --- | --- | 
| 2020-01-02 03:04:00 | 45° C | 
| 2020-01-02 03:05:00 | 47° C | 
| 2020-01-02 03:06:00 | 48° C | 

## Contoh 2: Format suhu dan kelembaban
<a name="v10-panels-overrides-format-humidity"></a>

Mari kita asumsikan bahwa kumpulan hasil kita adalah bingkai data yang terdiri dari empat bidang:`time`,`high temp`,`low temp`, dan`humidity`.


| Waktu | suhu tinggi | suhu rendah | kelembaban | 
| --- | --- | --- | --- | 
| 2020-01-02 03:04:00 | 45,0 | 30.0 | 67 | 
| 2020-01-02 03:05:00 | 47.0 | 34.0 | 68 | 
| 2020-01-02 03:06:00 | 48,0 | 31.0 | 68 | 

Mari tambahkan unit Celcius dan singkirkan tempat desimal. Ini menghasilkan tabel berikut:


| Waktu | suhu tinggi | suhu rendah | kelembaban | 
| --- | --- | --- | --- | 
| 2020-01-02 03:04:00 | 45° C | 30° C | 67° C | 
| 2020-01-02 03:05:00 | 47° C | 34° C | 68° C | 
| 2020-01-02 03:06:00 | 48° C | 31° C | 68° C | 

Bidang suhu terlihat bagus, tetapi kelembabannya sekarang harus diubah. Kita dapat memperbaikinya dengan menerapkan opsi field override ke bidang kelembaban dan mengubah unit menjadi Misc > percent (0-100).


| Waktu | suhu tinggi | suhu rendah | kelembaban | 
| --- | --- | --- | --- | 
| 2020-01-02 03:04:00 | 45° C | 30° C | 67% | 
| 2020-01-02 03:05:00 | 47° C | 34° C | 68% | 
| 2020-01-02 03:06:00 | 48° C | 31° C | 68% | 

## Menambahkan penggantian bidang
<a name="v10-panels-overrides-add-a-field"></a>

Aturan penggantian bidang dapat menyesuaikan pengaturan visualisasi untuk bidang atau seri tertentu.

**Untuk menambahkan penggantian bidang**

1. Edit panel yang ingin Anda tambahkan override.

1. Di panel samping opsi panel, pilih **Tambahkan penggantian bidang** di bagian bawah panel.

1. Pilih bidang mana aturan penggantian akan diterapkan ke:
   + **Bidang dengan nama** - Pilih bidang dari daftar semua bidang yang tersedia. Properti yang Anda tambahkan ke aturan dengan pemilih ini hanya diterapkan ke bidang tunggal ini.
   + **Bidang dengan nama yang cocok dengan regex** - Tentukan bidang yang akan diganti dengan ekspresi reguler. Properti yang Anda tambahkan ke aturan dengan pemilih ini diterapkan ke semua bidang di mana nama bidang cocok dengan regex. Ini memilih bidang untuk diganti, tetapi tidak mengganti nama bidang; untuk melakukan ini, gunakan transformasi [Rename](v10-panels-xform-functions.md) by regex.
   + **Bidang dengan tipe** - Pilih bidang berdasarkan jenis, seperti string, numerik, dan sebagainya. Properti yang Anda tambahkan ke aturan dengan pemilih ini diterapkan ke semua bidang yang cocok dengan jenis yang dipilih.
   + **Bidang yang dikembalikan oleh kueri** — Pilih semua bidang yang dikembalikan oleh kueri tertentu, seperti A, B, atau C. Properti yang Anda tambahkan ke aturan dengan pemilih ini diterapkan ke semua bidang yang dikembalikan oleh kueri yang dipilih.

1. Pilih **Tambahkan properti override**.

1. Pilih opsi bidang yang ingin Anda terapkan.

1. Masukkan opsi dengan menambahkan nilai di bidang. Untuk mengembalikan opsi ke nilai default, hapus teks putih di bidang.

1. Lanjutkan untuk menambahkan penggantian ke bidang ini dengan memilih **Tambahkan properti penggantian**, atau Anda dapat memilih **Tambahkan penggantian** dan pilih bidang lain untuk menambahkan penggantian.

1. Setelah selesai, pilih **Simpan** untuk menyimpan semua pengeditan panel ke dasbor.

## Menghapus penggantian bidang
<a name="v10-panels-overrides-delete-a-field"></a>

Hapus penggantian bidang saat Anda tidak lagi membutuhkannya. Saat Anda menghapus override, tampilan nilai default ke format aslinya. Perubahan ini berdampak pada dasbor dan pengguna dasbor yang mengandalkan panel yang terpengaruh.

**Untuk menghapus penggantian bidang**

1. Edit panel yang berisi penggantian yang ingin Anda hapus.

1. Di panel samping opsi panel, gulir ke bawah hingga Anda melihat penggantian.

1. Pilih penggantian yang ingin Anda hapus lalu pilih ikon sampah terkait.

## Melihat penggantian bidang
<a name="v10-panels-overrides-view"></a>

Anda dapat melihat penggantian bidang di opsi tampilan panel.

1. Edit panel yang berisi penggantian yang ingin Anda lihat.

1. Di panel samping opsi panel, gulir ke bawah hingga Anda melihat penggantian.

**catatan**  
Pengaturan override yang muncul di tab **Semua** sama dengan pengaturan yang muncul di tab **Overrides**.

## Mengedit penggantian bidang
<a name="v10-panels-overrides-edit-a-field"></a>

Edit penggantian bidang saat Anda ingin membuat perubahan pada setelan penggantian. Perubahan yang Anda buat segera berlaku.

**Untuk mengedit penggantian bidang**

1. Edit panel yang berisi penggantian yang ingin Anda edit.

1. Di panel samping opsi panel, gulir ke bawah hingga Anda melihat penggantian.

1. Temukan penggantian yang ingin Anda ubah.

1. Lakukan salah satu dari yang berikut:
   + Edit pengaturan pada penggantian yang ada atau parameter pemilihan bidang.
   + Hapus properti override yang ada dengan memilih **X** di sebelah properti.
   + Tambahkan properti override dengan memilih **Tambahkan properti override**.

# Visualisasi tersedia dalam Grafana versi 10
<a name="v10-panels-viz"></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)

Grafana menawarkan berbagai visualisasi untuk mendukung kasus penggunaan yang berbeda. Bagian dokumentasi ini menyoroti visualisasi bawaan, opsi dan penggunaan tipikal.

Panel umum untuk memulai, dan untuk mempelajari dasar-dasar menggunakan panel, adalah [Deret waktu](v10-panels-time-series.md) panel.

**catatan**  
Jika Anda tidak yakin visualisasi mana yang harus dipilih, Grafana dapat memberikan saran visualisasi berdasarkan kueri panel. Saat Anda memilih visualisasi, Grafana akan menampilkan pratinjau dengan visualisasi yang diterapkan.
+ Grafik & grafik
  + [Deret waktu](v10-panels-time-series.md) adalah visualisasi Grafik default dan utama.
  + [Garis waktu negara](v10-panels-state-timeline.md) untuk perubahan status dari waktu ke waktu.
  + [Riwayat status](v10-panels-status-history.md) untuk keadaan periodik dari waktu ke waktu.
  + [Bagan batang](v10-panels-bar-chart.md) menunjukkan data kategoris apa pun.
  + [Histogram](v10-panels-histogram.md) menghitung dan menunjukkan distribusi nilai dalam diagram batang.
  + [Heatmap](v10-panels-heatmap.md) memvisualisasikan data dalam dua dimensi, biasanya digunakan untuk besarnya suatu fenomena.
  + [Pie chart](v10-panels-piechart.md) biasanya digunakan di mana proporsionalitas penting.
  + [Candlestick](v10-panels-candlestick.md) biasanya untuk data keuangan di mana fokusnya adalah price/data pergerakan.
  + [Gauge](v10-panels-gauge.md) adalah visual bulat tradisional yang menunjukkan seberapa jauh satu metrik dari ambang batas.
  + [Tren](v10-panels-trend.md) untuk dataset yang memiliki urutan, numerik x yang bukan waktu.
  + [XY Chart](v10-panels-xychart.md) menyediakan cara untuk memvisualisasikan nilai x dan y arbitrer dalam grafik.
+ Statistik & angka
  + [Stat](v10-panels-stat.md) untuk statistik besar dan sparkline opsional.
  + [Bar gauge](v10-panels-bar-gauge.md) adalah bar gauge horizontal atau vertikal.
+ Lain-lain
  + [Tabel](v10-panels-table.md) adalah visualisasi tabel utama dan satu-satunya.
  + [Log](v10-panels-logs.md) adalah visualisasi utama untuk log.
  + [Grafik simpul](v10-panels-node-graph.md) untuk grafik atau jaringan terarah.
  + [Jejak](v10-panels-traces.md) adalah visualisasi utama untuk jejak.
  + [Grafik api](v10-panels-flamegraph.md) adalah visualisasi utama untuk pembuatan profil.
  + [Geomap](v10-panels-geomap.md) membantu Anda memvisualisasikan data geospasial.
  + [Datagrid](v10-panels-datagrid.md) memungkinkan Anda untuk membuat dan memanipulasi data, dan bertindak sebagai sumber data untuk panel lain.
+ Widget
  + [Daftar dasbor](v10-panels-dashboard-list.md) dapat mencantumkan dasbor.
  + [Daftar peringatan](v10-panels-alert-list.md) dapat mencantumkan peringatan.
  + [Teks](v10-panels-text.md) dapat menampilkan penurunan harga dan html.
  + [Berita](v10-panels-news.md) dapat menampilkan umpan RSS.

## Dapatkan lebih banyak
<a name="v10-panels-getmore"></a>

Anda dapat menambahkan lebih banyak jenis visualisasi dengan menginstal plugin panel dari file. [Temukan plugin dengan katalog plugin](grafana-plugins.md#plugin-catalog)

## Contoh
<a name="v10-panels-examples"></a>

Di bagian berikut Anda dapat menemukan contoh visualisasi.

## Grafik
<a name="v10-panels-ex-graphs"></a>

Untuk grafik garis, area, dan batang berbasis waktu, kami merekomendasikan visualisasi [deret waktu](v10-panels-time-series.md) default.

![\[Gambar yang menunjukkan contoh visualisasi deret waktu di Grafana.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/time_series_example.png)


Untuk data kategoris, gunakan diagram [batang](v10-panels-bar-chart.md).

![\[Gambar yang menunjukkan contoh visualisasi diagram batang di Grafana.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/barchart_example.png)


## Angka besar & statistik
<a name="v10-panels-ex-numbers"></a>

Visualisasi [stat](v10-panels-stat.md) menunjukkan satu nilai stat besar dengan sparkline grafik opsional. Anda dapat mengontrol latar belakang atau nilai warna menggunakan ambang batas atau skala warna.

![\[Gambar yang menunjukkan contoh visualisasi stat di Grafana.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/stat_panel_example.png)


## Pengukur
<a name="v10-panels-ex-gauge"></a>

Jika Anda ingin menyajikan nilai yang berkaitan dengan nilai min dan maks, Anda memiliki dua opsi. Pertama [pengukur](v10-panels-gauge.md) radial standar:

![\[Gambar yang menunjukkan contoh visualisasi pengukur di Grafana.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/gauge_example.png)


Kedua, Grafana juga memiliki [pengukur batang](v10-panels-bar-gauge.md) horizontal atau vertikal dengan tiga mode tampilan berbeda.

![\[Gambar yang menunjukkan contoh visualisasi pengukur di Grafana.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/bar_gauge_example.png)


## Tabel
<a name="v10-panels-ex-table"></a>

Untuk menampilkan data dalam tata letak tabel, gunakan visualisasi [tabel](v10-panels-table.md).

![\[Gambar yang menunjukkan contoh visualisasi tabel di Grafana.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/table_example.png)


## Bagan pai
<a name="v10-panels-ex-piechart"></a>

Untuk menampilkan seri yang dikurangi, atau nilai dalam seri, dari satu atau lebih kueri, karena mereka berhubungan satu sama lain, gunakan visualisasi [diagram lingkaran](v10-panels-piechart.md).

![\[Gambar yang menunjukkan contoh visualisasi diagram lingkaran di Grafana.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/pie_chart_example.png)


## Peta panas
<a name="v10-panels-ex-heatmaps"></a>

Untuk menampilkan distribusi nilai dari waktu ke waktu, gunakan [visualisasi peta panas](v10-panels-heatmap.md).

![\[Gambar yang menunjukkan contoh visualisasi peta panas di Grafana.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/heatmap_example.jpg)


## Garis waktu negara
<a name="v10-panels-ex-state"></a>

[Garis waktu status](v10-panels-state-timeline.md) menunjukkan perubahan status diskrit dari waktu ke waktu. Ketika digunakan dengan deret waktu, ambang batas digunakan untuk mengubah nilai numerik menjadi wilayah keadaan diskrit.

![\[Gambar yang menunjukkan contoh visualisasi garis waktu status di Grafana.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/state_timeline_example.png)


# Daftar peringatan
<a name="v10-panels-alert-list"></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)

Gunakan daftar peringatan untuk menampilkan peringatan Anda. Anda dapat mengonfigurasi daftar untuk menampilkan status saat ini. Untuk informasi selengkapnya tentang peringatan, lihat[Peringatan di Grafana versi 10](v10-alerts.md).

Gunakan pengaturan ini untuk menyempurnakan visualisasi Anda.

## Opsi
<a name="v10-panels-alert-list-options"></a>
+ **Mode grup** - Pilih antara **pengelompokan Default** untuk menampilkan instance peringatan yang dikelompokkan berdasarkan aturan peringatan mereka, dan **Pengelompokan khusus untuk mengelompokkan** instance peringatan dengan kumpulan label khusus.
+ **Item Maks** - Atur jumlah maksimum peringatan ke daftar.
+ **Urutkan urutan** - Pilih cara memesan peringatan yang ditampilkan.
  + **Abjad (asc)** — Urutan abjad
  + **Alfabetis (desc)** - Urutan abjad terbalik
  +  **Pentingnya** — Dengan kepentingan menurut nilai-nilai berikut, dengan 1 menjadi yang tertinggi:
    + `alerting`atau`firing`: 1
    + `no_data`: 2
    + `pending`: 3
    + `ok`: 4
    + `paused`atau`inactive`: 5
  + **Waktu (asc)** - Instans peringatan aktif terbaru terlebih dahulu.
  + **Waktu (desc)** - Instance peringatan aktif tertua terlebih dahulu.
+  **Peringatan dari dasbor ini** - Tampilkan peringatan hanya dari dasbor tempat daftar peringatan berada.

## Filter
<a name="v10-panels-alert-filter"></a>

Opsi ini memungkinkan Anda membatasi peringatan yang ditampilkan hanya untuk yang cocok dengan kueri, folder, atau tag yang Anda pilih:
+ **Nama peringatan** - Masukkan kueri nama peringatan.
+ **Label instance peringatan** - Filter instance peringatan menggunakan kueri label. Misalnya, `{severity="critical", instance=~"cluster-us-.+"}`.
+ **Folder** — Pilih folder. Hanya peringatan dari dasbor di folder yang dipilih yang akan ditampilkan.
+ **Sumber Data - Filter peringatan dari sumber** data yang dipilih.

## Filter negara
<a name="v10-panels-alert-state-filter"></a>

Pilih status peringatan mana yang akan ditampilkan di panel ini.
+ Peringatan/Penembakan
+ Tertunda
+ Tidak ada data
+ Normal
+ Kesalahan

# Daftar anotasi
<a name="v10-panels-annotations"></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)

Daftar Anotasi menampilkan daftar anotasi yang tersedia yang dapat Anda gunakan untuk melihat data beranotasi. Berbagai opsi tersedia untuk memfilter daftar berdasarkan tag dan pada dasbor saat ini.

## Kueri anotasi
<a name="v10-panels-annotations-query"></a>

Opsi berikut mengontrol kueri sumber untuk daftar anotasi.

**Filter Kueri**

Gunakan filter kueri untuk membuat daftar anotasi dari semua dasbor di organisasi Anda atau dasbor saat ini di mana panel ini berada. Ini memiliki opsi berikut:
+ Semua dasbor - Daftar anotasi dari semua dasbor di organisasi saat ini.
+ Dasbor ini - Batasi daftar ke anotasi di dasbor saat ini.

**Rentang waktu**

Gunakan opsi rentang waktu untuk menentukan apakah daftar harus dibatasi pada rentang waktu saat ini. Ini memiliki opsi berikut:
+ Tidak ada - tidak ada batas rentang waktu untuk kueri anotasi.
+ Dasbor ini - Batasi daftar ke rentang waktu dasbor tempat panel daftar anotasi tersedia.

**Tanda**

Gunakan opsi tag untuk memfilter anotasi berdasarkan tag. Anda dapat menambahkan beberapa tag untuk memperbaiki daftar.

**catatan**  
Secara opsional, biarkan daftar tag kosong dan filter dengan cepat dengan memilih tag yang terdaftar sebagai bagian dari hasil pada panel itu sendiri.

**Batasi**

Gunakan opsi batas untuk membatasi jumlah hasil yang dikembalikan.

## Tampilan
<a name="v10-panels-annotations-display"></a>

Opsi ini mengontrol metadata tambahan yang disertakan dalam tampilan panel anotasi.

**Tampilkan pengguna**

Gunakan opsi ini untuk menampilkan atau menyembunyikan pengguna mana yang membuat anotasi.

**Tampilkan waktu**

Gunakan opsi ini untuk menampilkan atau menyembunyikan waktu pembuatan anotasi.

**Tampilkan Tag**

Gunakan opsi ini untuk menampilkan atau menyembunyikan tag yang terkait dengan anotasi. *NB*: Anda dapat menggunakan tag untuk memfilter langsung daftar anotasi pada visualisasi itu sendiri.

## Tautkan perilaku
<a name="v10-panels-annotations-links"></a>

**Target tautan**

Gunakan opsi ini untuk memilih cara melihat data beranotasi. Ini memiliki opsi berikut.
+ Panel - Opsi ini akan membawa Anda langsung ke tampilan layar penuh panel dengan anotasi yang sesuai
+ Dasbor - Opsi ini akan memfokuskan anotasi dalam konteks dasbor lengkap

**Waktu sebelumnya**

Gunakan opsi ini untuk mengatur rentang waktu sebelum anotasi. Gunakan nilai string durasi seperti “1h” = 1 jam, “10m” = 10 menit, dll.

**Waktu setelahnya**

Gunakan opsi ini untuk mengatur rentang waktu setelah anotasi.

# Bagan batang
<a name="v10-panels-bar-chart"></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)

Bagan batang memungkinkan Anda untuk membuat grafik data kategoris.

![\[Gambar yang menunjukkan contoh visualisasi bagan batang di Grafana.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/barchart_example.png)


## Format data yang didukung
<a name="v10-panels-bar-chart-formats"></a>

Hanya satu frame data yang didukung dan perlu memiliki setidaknya satu bidang string yang akan digunakan sebagai kategori untuk sumbu X atau Y dan satu atau lebih bidang numerik. Berikut ini adalah contoh format data:


| Peramban | Pangsa pasar | 
| --- | --- | 
| Chrome | 50 | 
| Penjelajah Internet | 17.5 | 

Jika Anda memiliki lebih dari satu bidang numerik, panel menampilkan bilah yang dikelompokkan.

### Memvisualisasikan deret waktu atau beberapa set hasil
<a name="v10-panels-bar-chart-visualization"></a>

Jika Anda memiliki beberapa deret waktu atau tabel, pertama-tama Anda harus bergabung dengan mereka menggunakan gabungan, atau mengurangi transformasi. Misalnya, jika Anda memiliki beberapa deret waktu dan Anda ingin membandingkan nilai terakhir dan maksnya, tambahkan **Kurangi** transformasi dan tentukan **Maks** dan **Terakhir** sebagai opsi di bawah **Perhitungan**.

## Opsi bagan batang
<a name="v10-panels-bar-chart-options"></a>

Gunakan opsi ini untuk menyempurnakan visualisasi Anda.

**Orientasi**
+ **Otomatis** — Grafana memutuskan orientasi batang berdasarkan dimensi panel.
+ **Horizontal** - Menjadikan sumbu X sebagai sumbu kategori.
+ **Vertikal — Menjadikan** sumbu Y sebagai sumbu kategori.

**Putar label centang sumbu x**

 Ketika grafik berorientasi vertikal, pengaturan ini memutar label di bawah bilah. Pengaturan ini berguna ketika label diagram batang panjang dan tumpang tindih.

**Panjang maksimum label centang sumbu X**

Menetapkan panjang maksimum label bagan batang. Label yang lebih panjang dari panjang maksimum dipotong dengan elips.

**Label batang spasi minimum**

Menetapkan jarak minimum antara label bar.

**Tampilkan nilai**

Mengontrol apakah nilai ditampilkan di atas atau di sebelah kiri bar.
+ **Auto** - Nilai ditampilkan jika ada spasi.
+ **Selalu** — Selalu tunjukkan nilai.
+ **Jangan pernah** - Jangan pernah menunjukkan nilai.

**Penumpukan**

Mengontrol penumpukan bagan batang.
+ **Off** — Bar tidak akan ditumpuk.
+ **Normal** — Bar akan ditumpuk di atas satu sama lain.
+ **Persen** — Bar akan ditumpuk di atas satu sama lain, dan tinggi setiap bar adalah persentase dari total tinggi tumpukan.

**Lebar kelompok**

Mengontrol lebar grup.
+ `0 = Minimum width`
+ `1 = Maximum width`

**Lebar bar**

Mengontrol lebar bar.
+ `0 = Minimum width`
+ `1 = Maximum width`

**Radius batang**

Mengontrol radius bar.
+ `0 = Minimum radius`
+ `0.5 = Maximum radius`

**Sorot area penuh saat melayang**

Kontrol jika seluruh area sekitar bilah disorot saat Anda mengarahkan kursor ke bilah.

**Lebar garis**

Kontrol lebar garis bar.

**Isi opacity**

Mengontrol opasitas isian bilah.

**Mode gradien**

Mengatur mode pengisian gradien. Gradien isi didasarkan pada warna garis. Untuk mengubah warna, gunakan opsi bidang skema warna standar.

Tampilan gradien dipengaruhi oleh pengaturan **Fill opacity**.
+ **Tidak ada** - tidak ada pengisian gradien. Ini adalah pengaturan default.
+ **Opacity** — Transparansi gradien dihitung berdasarkan nilai pada sumbu y. Opasitas isi meningkat dengan nilai-nilai pada sumbu Y.
+ **Hue** - Warna gradien dihasilkan berdasarkan rona warna garis.

**Mode Tooltip**

Saat Anda mengarahkan kursor ke visualisasi, Grafana dapat menampilkan tooltips. Pilih bagaimana tooltips berperilaku.
+ **Single** - Tooltip hover hanya menampilkan satu seri, yang Anda arahkan pada visualisasi.
+ **Semua** - Tooltip hover menunjukkan semua seri dalam visualisasi. Grafana menyoroti seri yang Anda arahkan dengan huruf tebal dalam daftar seri di tooltip.
+ **Tersembunyi** — Jangan tampilkan tooltip saat Anda berinteraksi dengan visualisasi.

**catatan**  
Anda dapat menggunakan override untuk menyembunyikan seri individual dari tooltip.

**Ukuran teks**

Masukkan nilai untuk mengubah ukuran teks pada diagram batang Anda.

## Opsi legenda
<a name="v10-panels-bar-chart-legend"></a>

**Mode legenda**

Gunakan pengaturan ini untuk menentukan bagaimana legenda muncul dalam visualisasi Anda. Untuk informasi selengkapnya, lihat [Konfigurasikan legenda](v10-panels-configure-legend.md).
+ **Daftar** - Menampilkan legenda sebagai daftar. Ini adalah mode tampilan default legenda.
+ **Tabel** - Menampilkan legenda sebagai tabel.
+ **Tersembunyi** — Menyembunyikan legenda.

**Penempatan legenda**

Pilih tempat untuk menempatkan legenda.
+ **Bawah** - Di bawah grafik.
+ **Kanan** - Di sebelah kanan grafik.

**Nilai legenda**

Pilih nilai data seri atau perhitungan standar untuk ditampilkan dalam legenda. Anda dapat memiliki lebih dari satu. Untuk informasi selengkapnya, lihat [Konfigurasikan legenda](v10-panels-configure-legend.md).

## Opsi sumbu
<a name="v10-panels-bar-chart-axis"></a>

Gunakan pengaturan bidang berikut untuk menyempurnakan tampilan sumbu Anda. Beberapa opsi bidang tidak akan memengaruhi visualisasi sampai Anda mengklik di luar kotak opsi bidang yang sedang Anda edit atau tekan Enter.

**Penempatan**

Mengatur penempatan sumbu Y.
+ **Otomatis** - Grafana secara otomatis menetapkan sumbu Y ke seri. Ketika ada dua atau lebih seri dengan unit yang berbeda, maka Grafana menetapkan sumbu kiri ke unit pertama dan kanan ke unit berikut.
+ **Kiri** - Tampilkan semua sumbu Y di sisi kiri.
+ **Kanan** - Tampilkan semua sumbu Y di sisi kanan.
+ **Tersembunyi** — Sembunyikan semua sumbu Y.

Untuk menyembunyikan sumbu secara selektif, [tambahkan penggantian bidang](v10-panels-configure-overrides.md) yang menargetkan bidang tertentu.

**Label**

Tetapkan label teks sumbu Y. Jika Anda memiliki lebih dari satu sumbu Y, maka Anda dapat menetapkan label yang berbeda dengan override.

**Lebar**

Atur lebar sumbu yang tetap. Secara default, Grafana secara dinamis menghitung lebar sumbu.

Dengan mengatur lebar sumbu, data dengan jenis sumbu yang berbeda dapat berbagi proporsi tampilan yang sama. Ini membuatnya lebih mudah untuk membandingkan lebih dari satu data grafik karena sumbu tidak bergeser atau diregangkan dalam kedekatan visual satu sama lain.

**Soft min dan soft max**

Tetapkan opsi soft min atau soft max untuk kontrol batas sumbu Y yang lebih baik. Secara default, Grafana menetapkan rentang untuk sumbu Y secara otomatis berdasarkan kumpulan data.

Pengaturan soft min dan soft max dapat mencegah blip berubah menjadi pegunungan ketika data sebagian besar datar, dan min keras atau maks yang berasal dari opsi bidang min dan maks standar dapat mencegah lonjakan intermiten meratakan detail yang berguna dengan memotong paku melewati titik yang ditentukan.

Anda dapat mengatur min/max opsi standar untuk menentukan batas keras sumbu Y. Untuk informasi selengkapnya, lihat [Konfigurasikan opsi standar](v10-panels-configure-standard-options.md).

**Tampilkan beberapa sumbu y**

Dalam beberapa kasus, Anda mungkin ingin menampilkan beberapa sumbu y. Misalnya, jika Anda memiliki kumpulan data yang menunjukkan suhu dan kelembaban dari waktu ke waktu, Anda mungkin ingin menunjukkan dua sumbu y dengan unit berbeda untuk dua seri ini.

Anda dapat melakukan ini dengan [menambahkan penggantian bidang](v10-panels-configure-overrides.md). Ikuti langkah-langkah sebanyak yang diperlukan untuk menambahkan sumbu y sebanyak yang Anda butuhkan.

# Pengukur batang
<a name="v10-panels-bar-gauge"></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)

Pengukur batang menyederhanakan data Anda dengan mengurangi setiap bidang menjadi satu nilai. Anda memilih bagaimana Grafana menghitung reduksi.

Panel ini dapat menampilkan satu atau beberapa pengukur batang tergantung pada berapa banyak seri, baris, atau kolom yang dikembalikan kueri Anda.

![\[Gambar yang menunjukkan contoh visualisasi pengukur batang di Grafana.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/bar_gauge_example.png)


## Opsi nilai
<a name="v10-panels-bar-gauge-value"></a>

Gunakan opsi berikut untuk menyempurnakan bagaimana visualisasi Anda menampilkan nilai:

**Tampilkan**

Pilih cara Grafana menampilkan data Anda.

**Hitung**

Tampilkan nilai yang dihitung berdasarkan semua baris.
+ **Perhitungan** — Pilih fungsi peredam yang akan digunakan Grafana untuk mengurangi banyak bidang menjadi satu nilai. Untuk daftar perhitungan yang tersedia, lihat [Jenis perhitungan](v10-panels-calculation-types.md).
+ **Bidang** - Pilih tampilan bidang di panel.

**Semua nilai**

Tampilkan stat terpisah untuk setiap baris. Jika Anda memilih opsi ini, maka Anda juga dapat membatasi jumlah baris yang akan ditampilkan.
+ **Batas** — Jumlah maksimum baris yang akan ditampilkan. Defaultnya adalah 5.000.
+ **Bidang** - Pilih tampilan bidang di panel.

## Opsi pengukur batang
<a name="v10-panels-bar-gauge-options"></a>

Sesuaikan bagaimana pengukur batang ditampilkan.

**Orientasi**

Pilih arah susun.
+ **Otomatis** — Grafana memilih apa yang dianggapnya sebagai orientasi terbaik.
+ **Horizontal** - Batang meregang secara horizontal, kiri ke kanan.
+ **Vertikal** - Batang meregang secara vertikal, dari bawah ke atas.

**Mode tampilan**

Pilih mode tampilan.
+ **Gradien** — Tingkat ambang batas menentukan gradien.
+ **Retro LCD** — Pengukur dibagi menjadi sel-sel kecil yang menyala atau tidak menyala.
+ **Dasar** - Warna tunggal berdasarkan ambang pencocokan.

**Tampilan nilai**

Pilih mode tampilan nilai.
+ **Nilai warna** — Nilai warna ditentukan oleh nilai.
+ **Warna teks** - Warna nilai adalah warna teks default.
+ **Tersembunyi** — Nilai disembunyikan.

**Penempatan nama**

Pilih mode penempatan nama.

**catatan**  
Opsi ini hanya berlaku ketika orientasi pengukur batang horisontal. Ketika pengukur batang berada dalam orientasi vertikal, nama selalu ditempatkan di bagian bawah setiap pengukur batang.
+ **Otomatis** — Grafana menentukan penempatan terbaik.
+ **Atas** - Nama ditempatkan di bagian atas setiap pengukur batang.
+ **Kiri** — Nama ditempatkan di sebelah kiri setiap pengukur batang.

**Tampilkan area yang tidak terisi**

Pilih ini jika Anda ingin membuat wilayah bar yang tidak terisi sebagai abu-abu gelap. Tidak berlaku untuk mode tampilan LCD Retro.

**Ukuran bar**

Pilih mode ukuran bar.
+ **Otomatis** — Grafana menentukan ukuran pengukur batang terbaik.
+ **Manual** - Konfigurasikan ukuran pengukur batang secara manual.

**Lebar min**

Batasi lebar minimum kolom batang saat pengukur diorientasikan secara vertikal.

Secara otomatis menampilkan bilah gulir sumbu x ketika ada sejumlah besar data.

**catatan**  
Opsi ini hanya berlaku ketika ukuran batang diatur ke manual.

**Tinggi min**

Batasi ketinggian minimum baris batang saat pengukur diorientasikan secara horizontal.

Secara otomatis menampilkan bilah gulir sumbu y ketika ada sejumlah besar data.

**catatan**  
Opsi ini hanya berlaku ketika ukuran batang diatur ke manual.

**Tinggi maks**

Batasi ketinggian maksimum baris batang saat pengukur diorientasikan secara horizontal.

Secara otomatis menampilkan bilah gulir sumbu y ketika ada sejumlah besar data.

**catatan**  
Opsi ini hanya berlaku ketika ukuran batang diatur ke manual.

# Candlestick
<a name="v10-panels-candlestick"></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)

Visualisasi Candlestick memungkinkan Anda untuk memvisualisasikan data yang mencakup sejumlah dimensi konsisten yang berfokus pada pergerakan harga. Panel Candlestick mencakup mode Open-High-Low-Close (OHLC), serta dukungan untuk dimensi tambahan berdasarkan data deret waktu.

![\[Gambar yang menunjukkan contoh visualisasi kandil di Grafana.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/candlestick-panel-example.png)


Visualisasi candlestick dibangun di atas dasar [Deret waktu](v10-panels-time-series.md) dan mencakup banyak pengaturan konfigurasi umum.

## Modus
<a name="v10-panels-candlestick-mode"></a>

Opsi mode memungkinkan Anda untuk beralih dimensi mana yang digunakan untuk visualisasi.
+ **Lilin** — Batasi dimensi panel ke dimensi terbuka, tinggi, rendah, dan dekat yang digunakan oleh visualisasi kandil.
+ **Volume** — Batasi dimensi panel ke dimensi volume.
+ **Keduanya** — Perilaku default untuk panel kandil. Ini mencakup visualisasi kandil dan volume.

## Gaya lilin
<a name="v10-panels-candlestick-style"></a>
+ **Lilin** — Gaya tampilan default, menciptakan visualisasi gaya lilin antara dimensi terbuka dan dekat.
+ **OHLC Bars** - Menampilkan empat dimensi inti nilai terbuka, tinggi, rendah, dan dekat.

## Strategi warna
<a name="v10-panels-candlestick-color"></a>
+ **Sejak Terbuka** — Perilaku default. Mode ini akan memanfaatkan warna *Naik* (bawah) jika pergerakan harga intra-periode positif. Dengan kata lain, jika nilai pada penutupan lebih besar atau sama dengan nilai pada open, warna *Up* digunakan.
+ **Sejak Penutupan Sebelumnya** — Metode tampilan alternatif di mana warna lilin didasarkan pada pergerakan harga antar-periode atau perubahan nilai. Dengan kata lain, jika nilai pada open lebih besar dari nilai sebelumnya pada close, warna *Up* digunakan. Jika nilai pada open lebih rendah dari nilai sebelumnya pada penutupan, warna *Down* digunakan. *Opsi ini juga memicu mode visualisasi kandil berongga*. Candlestick berongga menunjukkan bahwa pergerakan intra-periode positif (nilai lebih tinggi pada penutupan daripada saat terbuka), kandil yang diisi menunjukkan perubahan intra-periode negatif (nilai lebih rendah pada penutupan daripada pada pembukaan). Untuk mempelajari lebih lanjut, lihat [penjelasan perbedaannya](https://thetradingbible.com/how-to-read-hollow-candlesticks).

## Warna naik & turun
<a name="v10-panels-candlestick-updown"></a>

Opsi **warna Naik** **dan Bawah** memilih warna mana yang digunakan saat pergerakan harga naik atau turun. *Strategi Warna* di atas akan menentukan apakah pergerakan harga intra-periode atau antar-periode digunakan untuk memilih warna candle atau OHLC bar.

## Buka, tinggi, rendah, tutup
<a name="v10-panels-candlestick-ohlc"></a>

Panel kandil akan mencoba memetakan bidang ke dimensi yang sesuai.
+ **Buka** sesuai dengan nilai awal periode yang diberikan.
+ **Tinggi** sesuai dengan nilai tertinggi dari periode yang diberikan.
+ **Rendah** sesuai dengan nilai terendah dari periode tertentu.
+ **Tutup** sesuai dengan nilai akhir (akhir) dari periode yang diberikan.
+ **Volume** sesuai dengan jumlah sampel dalam periode tertentu. (misalnya jumlah perdagangan)

**catatan**  
Legenda kandil tidak menampilkan nilai-nilai ini.

Untuk memetakan dimensi ini dengan benar, tabel hasil kueri dari data Anda harus menyertakan *setidaknya* kolom berikut.
+ `timestamp`
+ `open`
+ `high`
+ `low`
+ `close`

Jika data Anda tidak dapat dipetakan ke dimensi ini karena alasan tertentu (misalnya, karena nama kolom tidak sama), Anda dapat memetakannya secara manual menggunakan bidang **Buka**, **Tinggi**, **Rendah**, dan **Tutup** di bawah opsi **Candlestick** di editor panel.

## Bidang tambahan
<a name="v10-panels-candlestick-other"></a>

**Bidang tambahan**

Panel kandil didasarkan pada visualisasi deret waktu. Ini dapat memvisualisasikan dimensi data tambahan di luar terbuka, tinggi, rendah, dekat, dan volume. Opsi **Sertakan** dan **Abaikan** memungkinkannya untuk memvisualisasikan data lain yang disertakan seperti rata-rata bergerak sederhana, Bollinger band, dan lainnya, menggunakan gaya dan konfigurasi yang sama yang tersedia di. [Deret waktu](v10-panels-time-series.md)

# Kanvas
<a name="v10-panels-canvas"></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)

Kanvas menggabungkan kekuatan Grafana dengan fleksibilitas elemen khusus. Kanvas adalah panel form-built yang dapat diperluas yang memungkinkan Anda menempatkan elemen secara eksplisit dalam tata letak statis dan dinamis. Ini memberdayakan Anda untuk merancang visualisasi khusus dan overlay data dengan cara yang tidak mungkin dilakukan dengan panel Grafana standar, semuanya dalam UI Grafana. Jika Anda telah menggunakan UI populer dan alat desain web, maka merancang panel Canvas akan terasa sangat akrab.

## Elemen
<a name="v10-panels-canvas-elements"></a>

Anda dapat menambahkan elemen-elemen ini di kanvas Anda. Menambahkan beberapa, dan berbagai jenis, elemen memungkinkan Anda menyesuaikan visualisasi dengan cara yang tidak mungkin dilakukan dengan visualisasi lainnya.

**Nilai metrik**

Elemen nilai metrik memungkinkan Anda dengan mudah memilih data yang ingin Anda tampilkan di kanvas. Elemen ini memiliki mode *edit* unik yang dapat dipicu baik melalui menu konteks **Edit** opsi atau dengan mengklik dua kali panel. Saat dalam mode edit Anda dapat memilih data bidang mana yang ingin Anda tampilkan.

**Teks**

Elemen teks memungkinkan Anda dengan mudah menambahkan teks ke kanvas. Elemen ini juga mendukung mode pengeditan, dipicu melalui mengklik dua kali atau opsi menu edit di menu konteks.

**elips**

Elemen elips memungkinkan Anda menambahkan elips dasar ke kanvas. Elemen elips dapat menampilkan teks (data tetap dan bidang) dan warna latar belakangnya dapat diubah berdasarkan ambang data.

**Persegi Panjang**

Elemen persegi panjang memungkinkan Anda untuk menambahkan persegi panjang dasar ke kanvas. Sebuah elemen persegi panjang dapat menampilkan teks (baik data tetap dan bidang) dan warna latar belakangnya dapat diubah berdasarkan ambang data.

**Ikon**

Elemen ikon memungkinkan Anda menambahkan ikon yang didukung ke kanvas. Ikon dapat memiliki warna yang ditetapkan berdasarkan ambang batas atau pemetaan nilai.

**Peladen**

Elemen server memungkinkan Anda dengan mudah mewakili satu server, tumpukan server, database, atau terminal. Elemen server mendukung warna status, warna bohlam, dan tingkat kedipan bohlam, semuanya dapat dikonfigurasi dengan nilai tetap atau bidang.

**Tombol**

Elemen tombol memungkinkan Anda menambahkan tombol dasar ke kanvas. Elemen tombol mendukung pemicu panggilan API dasar yang tidak diautentikasi. Pengaturan API ditemukan di editor elemen tombol. Anda juga dapat meneruskan variabel template di editor API.

**catatan**  
Memilih tombol hanya akan memicu panggilan API saat pengeditan sebaris dinonaktifkan. Lihat [Pengeditan kanvas](#v10-panels-canvas-editing).

## Koneksi
<a name="v10-panels-canvas-connections"></a>

Saat membuat kanvas, Anda dapat menghubungkan elemen bersama untuk membuat visualisasi yang lebih kompleks. Anda dapat membuat koneksi dengan menyeret dari jangkar koneksi satu elemen ke jangkar koneksi elemen lain. Anda juga dapat membuat koneksi ke latar belakang kanvas. Jangkar koneksi ditampilkan saat Anda mengarahkan kursor ke elemen dan pengeditan sebaris dihidupkan. Untuk menghapus koneksi, pilih koneksi dan kemudian tekan `Delete` atau`Backspace`.

Anda dapat mengatur ukuran dan warna koneksi berdasarkan nilai tetap atau bidang. Untuk melakukannya, masuk ke mode edit panel, pilih koneksi, dan ubah properti koneksi di editor panel.

## Pengeditan kanvas
<a name="v10-panels-canvas-editing"></a>

**Editor sebaris**

Anda dapat mengedit kanvas Anda sebaris saat dalam konteks mode dasbor.

**Pan dan zoom**

Anda dan nyalakan panning dan zoom di kanvas. Ini memungkinkan Anda untuk membuat dan menavigasi desain yang lebih kompleks.

**catatan**  
Pan dan zoom saat ini sedang dalam pratinjau oleh Grafana Labs. Support terbatas, dan perubahan yang melanggar mungkin terjadi sebelum ketersediaan umum.

**Menu konteks**

Menu konteks memungkinkan Anda melakukan tugas-tugas umum dengan cepat dan efisien. Fungsionalitas yang didukung termasuk membuka dan menutup editor inline, menduplikasi elemen, menghapus elemen, dan banyak lagi.

Menu konteks dipicu oleh tindakan klik kanan (atau setara) di atas panel atau elemen kanvas yang diberikan.

Saat mengklik *kanan panel*, Anda dapat mengatur gambar latar belakang dan dengan mudah menambahkan elemen ke kanvas.

Saat mengklik kanan *elemen*, Anda dapat mengedit, menghapus, dan menduplikasi elemen, atau memodifikasi posisi lapisan elemen.

## Opsi Kanvas
<a name="v10-panels-canvas-options"></a>

**Pengeditan sebaris**

Toggle pengeditan sebaris memungkinkan Anda mengunci atau membuka kunci panel kanvas. Saat dimatikan, panel kanvas menjadi *terkunci*, membekukan elemen di tempatnya dan mencegah modifikasi yang tidak diinginkan.

**Tautan data**

Kanvas mendukung tautan [data](v10-panels-configure-data-links.md). Anda dapat membuat tautan data untuk elemen nilai metrik dan menampilkannya untuk semua elemen yang menggunakan nama bidang dengan mengikuti langkah-langkah ini.

**Untuk membuat link data untuk elemen**

1. Tetapkan elemen yang akan diikat ke nilai bidang.

1. Matikan sakelar pengeditan sebaris.

1. Buat penggantian untuk **Fields dengan nama** dan pilih nama bidang elemen dari daftar.

1. Pilih tombol **\$1 Tambahkan properti ganti**.

1. Pilih **Datalinks > Datalinks** dari daftar.

1. Pilih **\$1 Tambahkan tautan**, tambahkan judul dan URL untuk tautan data.

1. Arahkan kursor ke elemen untuk menampilkan tooltip tautan data.

1. Pilih elemen untuk dapat membuka tautan data.

Jika beberapa elemen menggunakan nama bidang yang sama, dan Anda ingin mengontrol elemen mana yang menampilkan tautan data, Anda dapat membuat nama bidang unik menggunakan [Tambahkan bidang dari perhitungan](v10-panels-xform-functions.md#v10-panels-xform-funcs-add) transformasi. Alias yang Anda buat dalam transformasi akan muncul sebagai bidang yang dapat Anda gunakan dengan elemen.

# Daftar dasbor
<a name="v10-panels-dashboard-list"></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)

Daftar dasbor memungkinkan Anda menampilkan tautan dinamis ke dasbor lain. Daftar ini dapat dikonfigurasi untuk menggunakan dasbor berbintang, dasbor yang baru dilihat, kueri penelusuran, dan tag dasbor.

Pada setiap pemuatan dasbor, panel ini menanyakan daftar dasbor, selalu memberikan up-to-date hasil terbanyak.

**Pilihan**

Gunakan opsi ini untuk menyempurnakan visualisasi Anda.
+ **Sertakan rentang waktu saat** ini - Pilih opsi ini untuk menyebarkan rentang waktu dasbor saat ini ke tautan dasbor. Saat pengguna memilih tautan, dasbor yang ditautkan terbuka dengan rentang waktu yang ditunjukkan sudah ditetapkan.
+ **Sertakan nilai variabel template saat** ini - Pilih opsi ini untuk menyertakan variabel template yang saat ini digunakan sebagai parameter kueri dalam tautan. Saat pengguna memilih tautan, templat apa pun yang cocok di dasbor tertaut disetel ke nilai dari daftar. Untuk informasi selengkapnya, lihat [Variabel URL dasbor](v10-dash-dashboard-url-variables.md).
+ **Dibintangi** - Tampilkan dasbor berbintang dalam urutan abjad.
+ **Baru-baru ini dilihat** - Tampilkan dasbor yang baru dilihat dalam urutan abjad.
+ **Cari** - Tampilkan dasbor berdasarkan permintaan pencarian atau tag. Anda harus memasukkan setidaknya satu nilai dalam **Kueri** atau **Tag**. Untuk bidang **Query** dan **Tags**, interpolasi variabel didukung, misalnya, `$my_var` atau. `${my_var}`
+ **Tampilkan judul** - Pilihan daftar yang dipilih (Dibintangi, Baru dilihat, Pencarian) ditampilkan sebagai judul.
+ **Max item** - Menetapkan jumlah maksimum item untuk daftar per bagian. Misalnya, jika Anda meninggalkan ini pada nilai default 10 dan ditampilkan Dasbor Berbintang dan Baru dilihat, maka panel akan menampilkan hingga 20 dasbor total, sepuluh di setiap bagian.

**Cari**

Opsi ini hanya berlaku jika opsi **Pencarian** dipilih.
+ **Query** — Masukkan kueri yang ingin Anda cari. Kueri tidak peka huruf besar/kecil, dan sebagian nilai diterima.
+ **Folder** — Pilih folder dasbor yang ingin Anda tampilkan.
+ **Tag** — Di sinilah Anda memasukkan tag yang ingin Anda cari. *Tag yang ada tidak akan muncul saat Anda mengetik, dan mereka peka huruf besar/kecil.*

**catatan**  
Ketika beberapa tag dan string muncul, daftar dasbor menampilkan yang cocok dengan *semua* kondisi.

# Datagrid
<a name="v10-panels-datagrid"></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)

**catatan**  
Visualisasi grid data saat ini sedang dalam pratinjau oleh Grafana Labs. Support terbatas, dan perubahan yang melanggar mungkin terjadi sebelum ketersediaan umum.

Datagrids menawarkan Anda kemampuan untuk membuat, mengedit, dan menyempurnakan data dalam Grafana. Dengan demikian, panel ini dapat bertindak sebagai sumber data untuk panel lain di dalam dasbor.

![\[Gambar yang menunjukkan contoh visualisasi datagrid di Grafana.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/datagrid-panel-example.png)


Melalui itu, Anda dapat memanipulasi data yang ditanyakan dari sumber data apa pun, Anda dapat memulai dari batu tulis kosong, atau Anda dapat menarik data dari file yang diseret dan dijatuhkan. Anda kemudian dapat menggunakan panel sebagai visualisasi tabel sederhana, atau Anda dapat memodifikasi data—dan bahkan menghapusnya sama sekali—untuk membuat batu tulis kosong.

Mengedit kumpulan data mengubah sumber data untuk menggunakan sumber data **Grafana** bawaan, menggantikan pengaturan sumber data lama dan kueri terkait, sementara juga menyalin kumpulan data saat ini ke dalam model dasbor.

Anda kemudian dapat menggunakan panel sebagai sumber data untuk panel lain, dengan menggunakan sumber data **Dasbor** bawaan untuk menarik data datagrid. Ini memberikan pengalaman dasbor interaktif, di mana Anda dapat memodifikasi data dan melihat perubahan yang tercermin di panel lain.

Untuk informasi selengkapnya tentang sumber data **Grafana** dan **Dasbor**, lihat. [Sumber data khusus](AMG-data-sources.md#AMG-data-sources-special)

## Menu konteks
<a name="v10-panels-datagrid-context"></a>

Untuk memberikan pengalaman yang lebih efisien, datagrid memiliki menu konteks yang dapat diakses dengan mengklik kanan pada sel, header kolom, atau pemilih baris. Bergantung pada status datagrid Anda, menu konteks menawarkan opsi yang berbeda termasuk yang berikut ini.
+ Hapus atau hapus semua baris dan kolom.
+ Hapus semua data yang ada (membuat datagrid Anda kosong).
+ Memicu fungsionalitas pencarian, yang memungkinkan Anda menemukan kata kunci dalam kumpulan data.

Menghapus baris atau kolom akan menghapus data dari datagrid, sementara membersihkan baris atau kolom hanya akan menghapus data dari sel, membiarkan baris atau kolom utuh.

**Menu header**

Anda juga dapat mengakses menu header dengan memilih ikon dropdown di sebelah judul header. Dari sini, Anda tidak hanya dapat menghapus atau menghapus kolom, tetapi juga mengganti namanya, membekukannya, atau mengonversi jenis bidang kolom.

## Memilih seri
<a name="v10-panels-datagrid-selectseries"></a>

Jika ada beberapa seri, Anda dapat mengatur datagrid untuk menampilkan kumpulan data yang disukai menggunakan menu tarik-turun **Pilih seri** di opsi panel.

## Menggunakan datagrids
<a name="v10-panels-datagrid-using"></a>

Datagrids menawarkan berbagai cara untuk berinteraksi dengan data Anda. Anda dapat mengedit, memindahkan, menghapus, dan menghapus baris dan kolom; menggunakan fungsi pencarian bawaan untuk menemukan data tertentu; dan mengonversi jenis bidang atau membekukan gulir horizontal pada kolom tertentu.

**Menambahkan data**

Anda dapat menambahkan data ke datagrid dengan membuat kolom atau baris baru.

**Untuk menambahkan kolom baru**

1. Di panel yang ada, pilih tombol **\$1** di header tabel setelah kolom terakhir.

1. Tambahkan nama untuk kolom baru.

1. Pilih di mana saja di luar bidang atau tekan `Enter` untuk menyimpan kolom.

Sekarang Anda dapat menambahkan data di setiap sel.

Untuk menambahkan baris baru, pilih tombol **\$1** setelah baris terakhir. Tombol hadir di setiap sel setelah baris terakhir, dan memilihnya memicu pembuatan baris baru sambil juga mengaktifkan sel yang Anda pilih.

**Mengedit data**

Anda dapat memindahkan kolom dan baris sesuai kebutuhan.

**Untuk memindahkan kolom**

1. Tekan dan tahan header kolom yang perlu dipindahkan.

1. Seret kolom ke lokasi yang diinginkan.

1. Lepaskan kolom untuk menyelesaikan langkah.

Untuk memindahkan baris, pilih dan tahan pemilih baris dari kolom angka yang terletak di sisi paling kiri kisi, dan seret ke lokasi yang diinginkan. Lepaskan baris untuk menyelesaikan langkah.

**Memilih beberapa sel**

Anda dapat memilih beberapa sel dengan memilih satu sel, dan menyeret sel lain. Pilihan ini dapat digunakan untuk menyalin data dari sel yang dipilih atau untuk menghapusnya menggunakan `Delete` kunci.

**Menghapus atau menghapus beberapa baris atau kolom**

Untuk menghapus atau menghapus beberapa baris, Anda dapat melakukan hal berikut.

**Untuk menghapus atau menghapus beberapa baris atau kolom**

1. Arahkan kursor ke kolom angka (di sebelah kiri kolom pertama di kisi) untuk menampilkan kotak centang baris.

1. Pilih kotak centang untuk baris yang ingin Anda kerjakan. Untuk memilih beberapa baris berturut-turut, tekan dan tahan `Shift` tombol sambil mengklik baris pertama dan terakhir. Untuk memilih baris yang tidak berurutan, tekan dan tahan tombol `Ctrl` (atau`Cmd`) sambil mengklik baris yang diinginkan.

1. Klik kanan (atau setara) untuk mengakses menu konteks.

1. Pilih **Hapus baris** atau **Hapus baris**.

Aturan yang sama berlaku untuk kolom dengan mengklik header kolom.

Untuk menghapus semua baris, gunakan kotak centang **Pilih semua** di sudut kiri atas datagrid. Ini memilih semua baris dan memungkinkan Anda untuk menghapusnya menggunakan menu konteks.

# Grafik api
<a name="v10-panels-flamegraph"></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)

Grafik api memungkinkan Anda memvisualisasikan data profil. Dengan menggunakan visualisasi ini, profil dapat direpresentasikan sebagai grafik api, tabel, atau keduanya.

![\[Gambar yang menunjukkan contoh visualisasi grafik api di Grafana.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/flamegraph-panel-example.png)


## Mode grafik api
<a name="v10-panels-flamegraph-mode"></a>

Grafik api mengambil keuntungan dari sifat hierarkis data profil. Ini memadatkan data ke dalam format yang memungkinkan Anda untuk dengan mudah melihat jalur kode mana yang menghabiskan sebagian besar sumber daya sistem, seperti waktu CPU, objek yang dialokasikan, atau ruang saat mengukur memori. Setiap blok dalam grafik api mewakili panggilan fungsi dalam tumpukan dan lebarnya mewakili nilainya.

Bagian abu-abu adalah seperangkat fungsi yang mewakili nilai yang relatif kecil dan mereka diciutkan bersama menjadi satu bagian karena alasan kinerja.

Anda dapat mengarahkan kursor ke fungsi tertentu untuk melihat tooltip yang menunjukkan data tambahan tentang fungsi tersebut, seperti nilai fungsi, persentase nilai total, dan jumlah sampel dengan fungsi tersebut.

**Tindakan drop-down**

Anda dapat mengklik fungsi untuk menampilkan menu drop-down dengan tindakan tambahan: 
+ **Blok fokus** — Saat Anda memilih **blok Fokus**, blok, atau fungsi, diatur ke 100% dari lebar grafik api dan semua fungsi turunannya ditampilkan dengan lebarnya diperbarui relatif terhadap lebar fungsi induk. Ini membuatnya lebih mudah untuk menelusuri bagian yang lebih kecil dari grafik nyala api.
+ **Salin nama fungsi** — Saat Anda memilih **Salin nama fungsi**, nama lengkap fungsi yang diwakili blok disalin.
+ **Tampilan sandwich** - Tampilan sandwich memungkinkan Anda untuk menampilkan konteks fungsi yang diklik. Ini menunjukkan semua pemanggil fungsi di bagian atas dan semua panggilan di bagian bawah. Ini menunjukkan konteks agregat fungsi sehingga jika fungsi ada di beberapa tempat dalam grafik nyala, semua konteks ditampilkan dan digabungkan dalam tampilan sandwich.

**Bilah status**

 Bilah status menunjukkan metadata tentang grafik api dan modifikasi yang diterapkan saat ini, seperti bagian grafik mana yang fokus atau fungsi apa yang ditampilkan dalam tampilan sandwich. Klik **X** di pil bilah status untuk menghapus modifikasi itu.

## Toolbar
<a name="v10-panels-flamegraph-toolbar"></a>

**Cari**

Anda dapat menggunakan bidang pencarian untuk menemukan fungsi dengan nama tertentu. Semua fungsi dalam grafik api yang cocok dengan pencarian akan tetap berwarna sementara fungsi lainnya berwarna abu-abu.

**Pemetik skema warna**

Anda dapat beralih di antara fungsi pewarnaan berdasarkan nilainya atau dengan nama paketnya untuk mengikat fungsi secara visual dari paket yang sama bersama-sama.

**Sejajarkan teks**

Sejajarkan teks baik ke kiri atau ke kanan untuk menampilkan bagian yang lebih penting dari nama fungsi ketika tidak masuk ke dalam blok.

**Pemetik visualisasi**

Anda dapat memilih untuk hanya menampilkan grafik api, hanya tabel, atau keduanya secara bersamaan.

## Mode meja atas
<a name="v10-panels-flamegraph-toptablemode"></a>

Tabel atas menunjukkan fungsi dari profil dalam format tabel. Tabel ini memiliki tiga kolom: simbol, diri, dan total. Tabel diurutkan berdasarkan waktu mandiri secara default, tetapi dapat disusun ulang berdasarkan total waktu atau nama simbol dengan mengklik header kolom. Setiap baris mewakili nilai agregat untuk fungsi yang diberikan jika fungsi muncul di beberapa tempat di profil.

Ada juga tombol aksi di sebelah kiri untuk setiap baris. Tombol pertama mencari nama fungsi sementara tombol kedua menunjukkan tampilan sandwich fungsi.

## Data API
<a name="v10-panels-flamegraph-dataapi"></a>

Untuk merender grafik api, Anda harus memformat data frame data menggunakan [model set bersarang](https://wikipedia.org/wiki/Nested_set_model).

Model set bersarang memastikan setiap item dari grafik api dikodekan hanya dengan tingkat sarangnya sebagai nilai bilangan bulat, metadatanya, dan dengan urutannya dalam bingkai data. Ini berarti bahwa urutan item signifikan dan harus benar. Urutan adalah traversal kedalaman pertama dari item dalam grafik nyala yang membuat ulang grafik tanpa memerlukan nilai panjang variabel dalam bingkai data seperti dalam array anak-anak.

Bidang yang diperlukan:


| Nama bidang | Tipe | Deskripsi | 
| --- | --- | --- | 
| level | number | Tingkat bersarang item. Dengan kata lain berapa banyak item antara item ini dan item teratas dari grafik api. | 
| nilai | number | Nilai absolut atau kumulatif item. Ini diterjemahkan ke lebar item dalam grafik. | 
| label | string | Label yang akan ditampilkan untuk item tertentu. | 
| diri | number | Nilai diri yang biasanya merupakan nilai kumulatif item dikurangi jumlah nilai kumulatif dari anak-anak langsungnya. | 

# Pengukur
<a name="v10-panels-gauge"></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)

Pengukur adalah visualisasi nilai tunggal yang dapat mengulang pengukur untuk setiap seri, kolom, atau baris.

![\[Gambar yang menunjukkan contoh visualisasi pengukur di Grafana.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/gauge_example.png)


## Opsi nilai
<a name="v10-panels-gauge-value"></a>

Gunakan opsi berikut untuk menyempurnakan bagaimana visualisasi Anda menampilkan nilai:

**Tampilkan**

Pilih cara Grafana menampilkan data Anda.

*Hitung*

Tampilkan nilai yang dihitung berdasarkan semua baris.
+ **Perhitungan** — Pilih fungsi peredam yang akan digunakan Grafana untuk mengurangi banyak bidang menjadi satu nilai. Untuk daftar perhitungan yang tersedia, lihat[Jenis perhitungan](v10-panels-calculation-types.md).
+ **Bidang** - Pilih bidang yang akan ditampilkan di panel.

*Semua nilai*

Tampilkan stat terpisah untuk setiap baris. Jika Anda memilih opsi ini, maka Anda juga dapat membatasi jumlah baris yang akan ditampilkan.
+ **Batas** — Jumlah maksimum baris yang akan ditampilkan. Default adalah 5.000.
+ **Bidang** - Pilih bidang yang akan ditampilkan di panel.

## Pengukur
<a name="v10-panels-gauge-gauge"></a>

Sesuaikan bagaimana pengukur ditampilkan.

**Orientasi**

Pilih arah susun.
+ **Otomatis** - Pengukur ditampilkan dalam baris dan kolom.
+ **Horizontal** - Pengukur menampilkan dari atas ke bawah.
+ **Vertikal** - Pengukur menampilkan kiri ke kanan.

**Tampilkan label ambang batas**

Kontrol jika nilai ambang ditampilkan.

**Tampilkan penanda ambang batas**

Kontrol jika pita ambang ditampilkan di luar pita nilai pengukur bagian dalam.

**Ukuran pengukur**

Pilih mode ukuran ukuran
+ **Otomatis** — Grafana menentukan ukuran pengukur terbaik.
+ **Manual** - Konfigurasikan ukuran pengukur secara manual.

**Lebar min**

Atur lebar minimum pengukur berorientasi vertikal.

Jika Anda menetapkan lebar minimum, bilah gulir sumbu x secara otomatis ditampilkan ketika ada sejumlah besar data.

**catatan**  
Opsi ini hanya berlaku ketika ukuran pengukur diatur ke manual.

**Tinggi min**

Lihat ketinggian minimum pengukur berorientasi horizontal.

Jika Anda menetapkan ketinggian minimum, bilah gulir sumbu y secara otomatis ditampilkan ketika ada sejumlah besar data.

**catatan**  
Opsi ini hanya berlaku ketika ukuran pengukur diatur ke manual.

**Netral**

Tetapkan nilai awal dari mana setiap pengukur akan diisi.

## Ukuran teks
<a name="v10-panels-gauge-textsize"></a>

Sesuaikan ukuran teks pengukur.
+ **Judul** — Masukkan nilai numerik untuk ukuran judul gauge.
+ **Nilai** - Masukkan nilai numerik untuk ukuran nilai pengukur.

# Geomap
<a name="v10-panels-geomap"></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)

Geomaps memungkinkan Anda untuk melihat dan menyesuaikan peta dunia menggunakan data geospasial. Anda dapat mengonfigurasi berbagai gaya overlay dan pengaturan tampilan peta untuk dengan mudah fokus pada karakteristik data berbasis lokasi yang penting.

**catatan**  
Anda dapat menambahkan data geospasial Anda sendiri di atas lapisan peta dasar yang disediakan oleh. AWS Lapisan basemap semuanya harus berasal. [https://tiles.maps.search-services.aws.a2z.com](https://tiles.maps.search-services.aws.a2z.com) 

![\[Gambar yang menunjukkan contoh visualisasi geomap di Grafana.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/geomap-panel-example.png)


## Tampilan Peta
<a name="v10-panels-geomap-view"></a>

Tampilan peta mengontrol tampilan awal peta saat dasbor dimuat.

**Tampilan Awal**

Tampilan awal mengonfigurasi bagaimana GeoMap panel dirender saat panel pertama kali dimuat.
+ **Tampilan** menyetel pusat peta saat panel pertama kali dimuat.
  + **Sesuai dengan data** sesuai dengan tampilan peta berdasarkan luasan data lapisan Peta dan pembaruan saat data berubah.
    + Opsi **data** memungkinkan pemilihan luas berdasarkan data dari *Semua lapisan*, *Layer* tunggal, atau *nilai Terakhir* dari lapisan yang dipilih.
    + **Layer** dapat dipilih jika data pas dari *Layer* tunggal atau *nilai Terakhir* dari sebuah layer.
    + **Padding** menetapkan padding dalam persen relatif di luar jangkauan data (tidak tersedia saat melihat *nilai Terakhir* saja).
    + **Max Zoom** menetapkan tingkat zoom maksimum saat memasang data.
  + **Koordinat** menetapkan tampilan peta berdasarkan:
    + **Lintang**
    + **Bujur**
  + Tampilan default juga tersedia termasuk:
    + **(0°, 0°)**
    + **Amerika Utara**
    + **Amerika Selatan**
    + **Eropa**
    + **Afrika**
    + **Asia Barat**
    + **Asia Selatan**
    + **Asia Tenggara**
    + **Asia Timur**
    + **Australia**
    + **Oseania**
+ **Zoom** mengatur tingkat zoom awal.

## Lapisan peta
<a name="v10-panels-geomap-layers"></a>

Dukungan Geomaps menunjukkan beberapa lapisan. Setiap lapisan menentukan bagaimana Anda memvisualisasikan data geospasial di atas peta dasar.

**Jenis**

Ada tiga jenis layer peta untuk dipilih dalam visualisasi Geomap.
+ [Lapisan penanda](#v10-panels-geomap-markers)membuat penanda di setiap titik data.
+ [Lapisan peta panas](#v10-panels-geomap-heatmap)memvisualisasikan peta panas data.
+ [Lapisan GeoJSON](#v10-panels-geomap-geojson)membuat data statis dari file GeoJSON.
+ [Lapisan Malam/Hari (Alpha)](#v10-panels-geomap-nightday)membuat wilayah malam atau siang hari.
+ [Lapisan rute (pratinjau)](#v10-panels-geomap-route)membuat titik data sebagai rute.
+ [Lapisan foto (pratinjau)](#v10-panels-geomap-photos)membuat foto di setiap titik data.
+ [Lapisan jaringan (pratinjau)](#v10-panels-geomap-network)memvisualisasikan grafik jaringan dari data.

Ada juga dua jenis lapisan eksperimental (atau alfa).
+ **Ikon pada titik terakhir (alpha)** membuat ikon pada titik data terakhir.
+ **GeoJSON dinamis (alpha)** menata file GeoJSON berdasarkan hasil kueri.

**catatan**  
Lapisan ditandai *pratinjau* atau *alfa* dalam pratinjau publik. Grafana Labs menawarkan dukungan terbatas, dan perubahan yang melanggar mungkin terjadi sebelum fitur tersedia secara umum.

**Kontrol Lapisan**

Kontrol lapisan memungkinkan Anda membuat lapisan, mengubah namanya, menyusun ulang, dan menghapus lapisan.
+ **Tambahkan lapisan membuat lapisan** data tambahan yang dapat dikonfigurasi untuk geomap. Ketika Anda menambahkan layer, Anda diminta untuk memilih jenis layer. Anda dapat mengubah jenis lapisan di setiap titik selama konfigurasi panel.
+ Kontrol lapisan memungkinkan Anda untuk mengganti nama, menghapus, dan menyusun ulang lapisan panel.
  + **Edit nama layer** (ikon pensil) mengganti nama layer.
  + **Trash Bin** menghapus layer.
  + **Menyusun ulang** (enam dots/grab pegangan) memungkinkan Anda untuk mengubah urutan lapisan. Data pada lapisan yang lebih tinggi akan muncul di atas data pada lapisan bawah. Visualisasi akan memperbarui urutan layer saat Anda drag dan drop untuk membantu menyederhanakan memilih urutan layer.

Anda dapat menambahkan beberapa lapisan data ke satu panel geomap untuk membuat visualisasi yang kaya dan terperinci.

**Lokasi**

Geomaps membutuhkan sumber data geografis. Data ini berasal dari kueri database, dan ada empat opsi pemetaan untuk data Anda.
+ **Otomatis** secara otomatis mencari data lokasi. Gunakan opsi ini ketika kueri Anda didasarkan pada salah satu nama berikut untuk bidang data.
  + *geohash*: `geohash`
  + *garis lintang*:`latitude`, `lat`
  + *garis bujur*:`longitude`,, `lng` `lon`
  + *pencarian*: `lookup`
+ **Coords** menentukan bahwa kueri Anda menyimpan data koordinat. Anda akan mendapatkan diminta untuk memilih bidang data numerik untuk garis lintang dan bujur dari kueri database Anda.
+ **Geohash** menentukan bahwa kueri Anda menyimpan data geohash. Anda akan diminta untuk memilih bidang data string untuk geohash dari kueri database Anda.
+ **Pencarian** menentukan bahwa kueri Anda menyimpan data nama lokasi yang perlu dipetakan ke nilai. Anda akan diminta untuk memilih bidang pencarian dari kueri database Anda dan gazetteer. Gazetteer adalah direktori yang digunakan untuk memetakan data kueri Anda ke titik geografis.

## Lapisan penanda
<a name="v10-panels-geomap-markers"></a>

Lapisan penanda memungkinkan Anda untuk menampilkan titik data sebagai bentuk penanda yang berbeda seperti lingkaran, kotak, segitiga, bintang, dan banyak lagi.

Penanda memiliki banyak opsi penyesuaian.
+ **Ukuran** mengkonfigurasi ukuran spidol. Standarnya adalah`Fixed size`, yang membuat semua ukuran penanda sama terlepas dari datanya; Namun, ada juga opsi untuk mengukur penanda berdasarkan data yang sesuai dengan bidang yang dipilih. `Min`dan ukuran `Max` penanda harus diatur sedemikian rupa sehingga lapisan Marker dapat menskalakan dalam kisaran ini.
+ **Simbol** memungkinkan Anda memilih simbol, ikon, atau grafik untuk membantu memberikan konteks visual tambahan pada data Anda. Pilih dari aset yang disertakan dengan Grafana seperti simbol sederhana atau pustaka Unicon. Anda juga dapat menentukan URL yang berisi aset gambar. Gambar harus berupa grafik vektor yang dapat diskalakan (SVG).
+ **Simbol Vertical Align** mengkonfigurasi perataan vertikal simbol relatif terhadap titik data. Perhatikan bahwa sudut rotasi simbol diterapkan terlebih dahulu di sekitar titik data, kemudian perataan vertikal diterapkan relatif terhadap rotasi simbol.
+ **Simbol Horizontal Align** mengkonfigurasi perataan horizontal simbol relatif terhadap titik data. Perhatikan bahwa sudut rotasi simbol diterapkan terlebih dahulu di sekitar titik data, kemudian perataan horizontal diterapkan relatif terhadap rotasi simbol.
+ **Warna** mengkonfigurasi warna spidol. Default `Fixed color` menetapkan semua penanda ke warna tertentu. Ada juga opsi untuk memiliki warna bersyarat tergantung pada nilai titik data bidang yang dipilih dan skema warna yang ditetapkan di bagian **Opsi standar**.
+ **Fill opacity** mengonfigurasi transparansi setiap penanda.
+ **Sudut rotasi** mengkonfigurasi sudut rotasi setiap penanda. Defaultnya adalah **Nilai tetap**, yang membuat semua penanda berputar ke sudut yang sama terlepas dari datanya; Namun, ada juga opsi untuk mengatur rotasi penanda berdasarkan data yang sesuai dengan bidang yang dipilih.
+ **Label teks** mengonfigurasi label teks untuk setiap penanda.
+ **Tampilkan legenda** memungkinkan Anda beralih legenda untuk lapisan.
+ **Tooltip tampilan** memungkinkan Anda beralih tooltips untuk layer.

## Lapisan peta panas
<a name="v10-panels-geomap-heatmap"></a>

Lapisan peta panas mengelompokkan berbagai titik data untuk memvisualisasikan lokasi dengan kepadatan berbeda.

![\[Gambar yang menunjukkan contoh peta panas menggunakan visualisasi geomap di Grafana.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/geomap-heatmap-example.png)


Untuk menambahkan layer heatmap:

Pilih pada menu dropdown di bawah Data Layer dan pilih. `Heatmap`

Mirip dengan`Markers`, Anda diminta dengan opsi untuk menentukan titik data mana yang akan divisualisasikan dan bagaimana Anda ingin memvisualisasikannya.
+ **Nilai berat** mengkonfigurasi intensitas kluster peta panas. **Nilai tetap menjaga nilai** bobot konstan di semua titik data. Nilai ini harus berada di kisaran 0-1. Mirip dengan Markers, ada opsi alternatif di dropdown untuk secara otomatis menskalakan nilai bobot tergantung pada nilai data.
+ **Radius** mengkonfigurasi ukuran kluster peta panas.
+ **Blur** mengkonfigurasi jumlah blur pada setiap cluster.
+ **Opacity** mengonfigurasi opacity setiap cluster.
+ **Tooltip tampilan** memungkinkan Anda beralih tooltips untuk layer.

## Lapisan GeoJSON
<a name="v10-panels-geomap-geojson"></a>

Lapisan GeoJSON memungkinkan Anda untuk memilih dan memuat file GeoJSON statis dari sistem file.
+ URL **GeoJSON menyediakan pilihan file GeoJSON** yang dikirimkan bersama Grafana.
+ **Default Style** mengontrol gaya mana yang akan diterapkan bila tidak ada aturan di atas yang cocok.
  + **Warna** mengkonfigurasi warna gaya default
  + **Opacity mengonfigurasi opacity** default
+ **Aturan Gaya** menerapkan gaya berdasarkan properti fitur
  + **Aturan** memungkinkan Anda memilih *fitur*, *kondisi*, dan *nilai* dari file GeoJSON untuk menentukan aturan. Ikon tempat sampah dapat digunakan untuk menghapus aturan saat ini.
  + **Warna** mengkonfigurasi warna gaya untuk aturan saat ini
  + **Opacity** mengonfigurasi tingkat transparansi untuk aturan saat ini.
+ **Tambahkan aturan gaya** menciptakan aturan gaya tambahan.
+ **Tooltip tampilan** memungkinkan Anda beralih tooltips untuk layer.

## Lapisan Malam/Hari (Alpha)
<a name="v10-panels-geomap-nightday"></a>

Lapisan Malam/Siang menampilkan wilayah siang dan malam berdasarkan rentang waktu saat ini.

![\[Gambar yang menunjukkan contoh layer malam/siang menggunakan visualisasi geomap di Grafana.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/geomap-day-night-example.png)


**Pilihan**
+ **Tampilkan** beralih sumber waktu dari rentang waktu panel.
+ **Warna wilayah malam** memilih warna untuk wilayah malam.
+ **Tampilan ikon matahari** beralih matahari.
+ **Opacity** dari 0 (transparan) ke 1 (buram).
+ **Tooltip tampilan** memungkinkan Anda beralih tooltips untuk layer.

**catatan**  
Untuk informasi selengkapnya, lihat [Ekstensi untuk OpenLayers - DayNight](https://viglino.github.io/ol-ext/examples/layer/map.daynight.html).

## Lapisan rute (pratinjau)
<a name="v10-panels-geomap-route"></a>

Lapisan Route membuat titik data sebagai rute.

**catatan**  
Lapisan Route saat ini dalam pratinjau publik. Grafana Labs menawarkan dukungan terbatas, dan perubahan yang melanggar mungkin terjadi sebelum fitur tersedia secara umum.

![\[Gambar yang menunjukkan contoh layer rute menggunakan visualisasi geomap di Grafana.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/geomap-route-layer-example.png)


**Pilihan**
+ **Ukuran** mengatur ketebalan rute. Nilai tetap secara default. Saat data bidang dipilih, Anda dapat mengatur rentang Min dan Maks di mana data bidang dapat diskalakan.
+ **Warna** mengatur warna rute. Atur ke warna tetap secara default, Anda juga dapat mengikat warna ke data bidang.
+ **Fill opacity** mengonfigurasi opacity rute.
+ **Label teks** mengonfigurasi label teks untuk setiap rute.
+ **Panah** mengkonfigurasi gaya panah untuk ditampilkan di sepanjang rute, dalam urutan data.
  + **Tidak ada**
  + **Maju**
  + **Membalikkan**
+ **Tooltip tampilan** memungkinkan Anda beralih tooltips untuk layer.

**catatan**  
Untuk informasi selengkapnya, lihat [Ekstensi untuk OpenLayers - Gaya Garis Aliran](http://viglino.github.io/ol-ext/examples/style/map.style.gpxline.html).

## Lapisan foto (pratinjau)
<a name="v10-panels-geomap-photos"></a>

Lapisan Foto membuat foto di setiap titik data.

**catatan**  
Lapisan Foto saat ini dalam pratinjau publik. Grafana Labs menawarkan dukungan terbatas, dan perubahan yang melanggar mungkin terjadi sebelum fitur tersedia secara umum.

**Pilihan**
+ Bidang **Sumber Gambar memungkinkan Anda memilih bidang** string yang berisi data gambar sebagai biner gambar yang dikodekan Base64 (). `data:image/png;base64,...`
+ **Jenis** mengatur gaya bingkai di sekitar gambar. Pilih antara:
  + **Persegi**
  + **Lingkaran**
  + **Berlabuh**
  + **Folio**
+ **Pangkas** beralih apakah gambar dipotong agar pas.
+ **Bayangan** mengubah bayangan kotak di belakang gambar.
+ **Perbatasan** menetapkan ukuran batas di sekitar gambar.
+ **Warna perbatasan menetapkan warna** perbatasan di sekitar gambar.
+ **Radius** mengatur ukuran keseluruhan gambar dalam piksel.
+ **Tooltip tampilan** memungkinkan Anda beralih tooltips untuk layer.

**catatan**  
Untuk informasi selengkapnya, lihat [Ekstensi untuk OpenLayers - Gaya Foto Gambar](http://viglino.github.io/ol-ext/examples/style/map.style.photo.html).

## Lapisan jaringan (pratinjau)
<a name="v10-panels-geomap-network"></a>

Lapisan Jaringan membuat grafik jaringan. Lapisan ini mendukung format data yang sama didukung oleh visualisasi grafik node, dengan penambahan data geospasial yang disertakan dalam data node. Data geospasial digunakan untuk mencari dan merender node pada peta.

**catatan**  
Lapisan Jaringan saat ini dalam pratinjau publik. Grafana Labs menawarkan dukungan terbatas, dan perubahan yang melanggar mungkin terjadi sebelum fitur tersedia secara umum.

![\[Gambar yang menunjukkan contoh visualisasi jaringan dalam geomap di Grafana.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/geomap-network-layer-example.png)


**catatan**  
Lapisan Jaringan saat ini dalam pratinjau publik. Grafana Labs menawarkan dukungan terbatas, dan perubahan yang melanggar mungkin terjadi sebelum fitur tersedia secara umum.

**Pilihan**
+ **Panah** mengatur arah panah untuk ditampilkan untuk setiap tepi, dengan sumber makna maju ke target. Pilih antara:
  + **Tidak ada**
  + **Maju**
  + **Membalikkan**
  + **Keduanya**
+ **Tampilkan legenda** memungkinkan Anda beralih legenda untuk layer. Legenda hanya mendukung data node.
+ **Tooltip tampilan** memungkinkan Anda beralih tooltips untuk layer.

**Gaya simpul**
+ **Ukuran** mengkonfigurasi ukuran node. Defaultnya adalah **Ukuran tetap**, yang membuat semua ukuran node sama terlepas dari datanya; Namun, ada juga opsi untuk mengukur node berdasarkan data yang sesuai dengan bidang yang dipilih. Ukuran node **Min** dan **Max** harus diatur sedemikian rupa sehingga node dapat diskalakan dalam kisaran ini.
+ **Warna** mengkonfigurasi warna node. Defaultnya adalah **Fixed color**, yang mengatur semua node ke warna tertentu. Ada juga opsi untuk memiliki warna bersyarat tergantung pada nilai titik data bidang yang dipilih dan skema warna yang ditetapkan di bagian **Opsi standar**.
+ **Simbol** memungkinkan Anda memilih simbol, ikon, atau grafik untuk membantu memberikan konteks visual tambahan pada data Anda. Pilih dari aset yang disertakan dengan Grafana, seperti simbol sederhana atau pustaka Unicon. Anda juga dapat menentukan URL yang berisi aset gambar. Gambar harus berupa grafik vektor yang dapat diskalakan (SVG).
+ **Fill opacity** mengkonfigurasi transparansi setiap node.
+ **Sudut rotasi** mengkonfigurasi sudut rotasi setiap node. Defaultnya adalah **nilai Tetap**, yang membuat semua node berputar ke sudut yang sama terlepas dari data; Namun, ada juga opsi untuk mengatur rotasi node berdasarkan data yang sesuai dengan bidang yang dipilih.
+ **Label teks** mengonfigurasi label teks untuk setiap node.

**Gaya tepi**
+ **Ukuran** mengkonfigurasi lebar garis tepi. Defaultnya adalah **Ukuran tetap**, yang membuat semua lebar garis tepi sama terlepas dari datanya; Namun, ada juga opsi untuk mengukur tepi berdasarkan data yang sesuai dengan bidang yang dipilih. Ukuran tepi **Min** dan **Max** harus diatur sedemikian rupa sehingga ujung-ujungnya dapat diskalakan dalam kisaran ini.
+ **Warna** mengkonfigurasi warna tepi. Defaultnya adalah **warna Tetap**, yang mengatur semua tepi ke warna tertentu. Ada juga opsi untuk memiliki warna bersyarat tergantung pada nilai titik data bidang yang dipilih dan skema warna yang ditetapkan di bagian **Opsi standar**.
+ **Fill opacity** mengonfigurasi transparansi setiap tepi.
+ **Label teks** mengonfigurasi label teks untuk setiap tepi.

## Lapisan CARTO
<a name="v10-panels-geomap-carto"></a>

Lapisan CARTO tidak didukung di Grafana Terkelola Amazon.

## Lapisan ubin XYZ
<a name="v10-panels-geomap-xyz"></a>

Lapisan ubin XYZ tidak didukung di Grafana Terkelola Amazon.

## Buka lapisan Peta Jalan
<a name="v10-panels-geomap-osm"></a>

Lapisan Peta Jalan Terbuka (selain peta dasar default) tidak didukung di Grafana Terkelola Amazon.

## Lapisan ArcGIS
<a name="v10-panels-geomap-arcgis"></a>

Lapisan ArcGIS tidak didukung di Grafana Terkelola Amazon.

## Kontrol Peta
<a name="v10-panels-geomap-controls"></a>

Bagian kontrol peta berisi berbagai opsi untuk informasi peta dan hamparan alat.

**Zoom**

Opsi untuk kontrol zoom.

*Tampilkan kontrol zoom*

Menampilkan kontrol zoom di sudut kiri atas.

*Zoom roda mouse*

Menghidupkan atau mematikan menggunakan roda mouse untuk memperbesar atau memperkecil.

**Tampilkan atribusi**

Menampilkan atribusi untuk lapisan basemap di peta.

**Tampilkan skala**

Menampilkan informasi skala di sudut kiri bawah.

**catatan**  
Menampilkan unit dalam [m]/[km].

**Tampilkan alat ukur**

Menampilkan alat ukur di sudut kanan atas. Pengukuran hanya muncul ketika kontrol ini terbuka.
+ **Klik** untuk mulai mengukur
+ **Lanjutkan mengklik** untuk melanjutkan pengukuran
+ **Klik dua kali** untuk mengakhiri pengukuran

**catatan**  
Saat Anda mengubah jenis atau unit pengukuran, pengukuran sebelumnya akan dihapus dari peta.  
Jika kontrol ditutup dan kemudian dibuka kembali, pengukuran terbaru ditampilkan.  
Pengukuran dapat dimodifikasi dengan mengklik dan menyeretnya.

*Panjangnya*

Dapatkan panjang bola geometri. Panjang ini adalah jumlah dari jarak lingkaran besar antara koordinat. Untuk geometri multi-bagian, panjangnya adalah jumlah panjang setiap bagian. Geometri diasumsikan dalam 'EPSG:3857'.

Anda dapat memilih unit berikut untuk pengukuran panjang:
+ **Metrik (m/km)**
+ **Kaki (ft)**
+ **Miles (mi)**
+ **Mil laut (nmi)**

*Luas*

Dapatkan area bola geometri. Area ini dihitung dengan asumsi bahwa tepi poligon adalah segmen lingkaran besar pada bola. Geometri diasumsikan dalam 'EPSG:3857'.

Anda dapat memilih unit berikut untuk pengukuran area:
+ **Meter Persegi (m²)**
+ **Kilometer Persegi (km²)**
+ **Kaki Persegi (ft²)**
+ **Mil Persegi (mi²)**
+ **Hektar (acre)**
+ **Hektar (ha)**

**Tampilkan debug**

Menampilkan informasi debug di sudut kanan atas peta. Ini dapat berguna untuk men-debug atau memvalidasi sumber data.
+ **Zoom** menampilkan tingkat zoom peta saat ini.
+ **Pusat** menampilkan garis **bujur** saat ini, dan **garis lintang** pusat peta.

**Tooltip**
+ **Tidak ada** yang menampilkan tooltips hanya ketika titik data diklik.
+ **Detail** menampilkan tooltips saat pointer melayang di atas titik data.

# Peta panas
<a name="v10-panels-heatmap"></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)

Visualisasi panel Heatmap memungkinkan Anda untuk melihat histogram dari waktu ke waktu. Untuk informasi lebih lanjut tentang histogram, lihat. [Pengantar histogram dan peta panas](getting-started-grafanaui.md#introduction-to-histograms-and-heatmaps)

![\[Gambar yang menunjukkan contoh visualisasi peta panas di Grafana.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/heatmap_example.jpg)


## Hitung dari data
<a name="v10-panels-heatmap-calculate"></a>

Pengaturan ini menentukan apakah data sudah merupakan peta panas yang dihitung (dari sumber data/transformator), atau yang harus dihitung di panel.

**Ember X**

Pengaturan ini menentukan bagaimana sumbu X dibagi menjadi ember. Anda dapat menentukan interval waktu di input **Ukuran**. Misalnya, rentang waktu `1h` membuat sel selebar 1 jam pada sumbu X.

**Ember Y**

Pengaturan ini menentukan bagaimana sumbu Y dibagi menjadi ember.

**Skala Bucket Y**

Pilih salah satu skala nilai sumbu Y berikut:
+ **linier** — Skala linier.
+ **log (basis 2)** — Skala logaritmik dengan basis 2.
+ **log (basis 10)** — Skala logaritmik dengan basis 10.
+ **symlog - Skala** symlog.

## Sumbu Y
<a name="v10-panels-heatmap-y-axes"></a>

Mendefinisikan bagaimana sumbu Y ditampilkan

**Penempatan**
+ **Kiri** - Di sebelah kiri
+ **Kanan** - Di sebelah kanan
+ **Tersembunyi** - Tersembunyi

**Satuan**

Konfigurasi unit

**Desimal**

Pengaturan ini menentukan konfigurasi desimal.

**Nilai Min/Maks**

Pengaturan ini mengkonfigurasi rentang sumbu.

**Membalikkan**

Saat dipilih, sumbu muncul dalam urutan terbalik.

**Tampilkan beberapa sumbu y**

Dalam beberapa kasus, Anda mungkin ingin menampilkan beberapa sumbu y. Misalnya, jika Anda memiliki kumpulan data yang menunjukkan suhu dan kelembaban dari waktu ke waktu, Anda mungkin ingin menunjukkan dua sumbu y dengan unit berbeda untuk dua seri ini.

Anda dapat melakukan ini dengan [menambahkan penggantian bidang](v10-panels-configure-overrides.md). Ikuti langkah-langkah sebanyak yang diperlukan untuk menambahkan sumbu y sebanyak yang Anda butuhkan.

## Warna
<a name="v10-panels-heatmap-colors"></a>

Spektrum warna mengontrol pemetaan antara jumlah nilai (di setiap bucket) dan warna yang ditetapkan untuk setiap bucket. Warna paling kiri pada spektrum mewakili jumlah minimum dan warna di sisi paling kanan mewakili jumlah maksimum. Beberapa skema warna secara otomatis terbalik saat menggunakan tema cahaya.

Anda juga dapat mengubah mode warna menjadi Opacity. Dalam hal ini, warnanya tidak akan berubah tetapi jumlah opasitas akan berubah dengan jumlah ember
+ **Modus**
  + **Skema** - Nilai bucket diwakili oleh warna sel.
    + **Skema** — Jika modenya adalah **Skema**, maka pilih skema warna.
  + **opacity** — Nilai bucket diwakili oleh opasitas sel. Sel buram berarti nilai maksimum.
    + **Warna - Warna** dasar sel.
    + **Skala** — Skala untuk memetakan nilai bucket ke opacity.
      + **linier** — Skala linier. Nilai bucket memetakan secara linier ke opacity.
      + **sqrt — Skala** daya. Opasitas sel dihitung sebagai`value ^ k`, di mana `k` adalah nilai **Eksponen** yang dikonfigurasi. Jika eksponen kurang dari`1`, Anda akan mendapatkan skala logaritmik. Jika eksponen lebih besar dari`1`, Anda akan mendapatkan skala eksponensial. Dalam hal`1`, skala akan sama dengan linier.
    + **Eksponen — nilai eksponen**, lebih besar dari. `0`

**Mulai/akhir warna dari nilai**

Secara default, Grafana menghitung warna sel berdasarkan nilai bucket minimum dan maksimum. Dengan Min dan Max Anda dapat menimpa nilai-nilai tersebut. Pertimbangkan nilai bucket sebagai sumbu Z dan Min dan Max sebagai Z-Min dan Z-Max, masing-masing.
+ **Mulai** - Nilai minimum yang digunakan untuk perhitungan warna sel. Jika nilai bucket kurang dari Min, maka itu dipetakan ke warna “minimum”. Nilai min seri adalah nilai default.
+ **Akhir** - Nilai maksimum yang digunakan untuk perhitungan warna sel. Jika nilai bucket lebih besar dari Max, maka itu dipetakan ke warna “maksimum”. Nilai maks seri adalah nilai default.

## Tampilan sel
<a name="v10-panels-heatmap-cell"></a>

Gunakan pengaturan ini untuk menyempurnakan visualisasi Anda.

## Opsi tampilan tambahan
<a name="v10-panels-heatmap-options"></a>

**Tooltip**
+ **Tampilkan tooltip** - Tampilkan tooltip peta panas.
+ **Tampilkan Histogram - Tampilkan histogram** sumbu Y pada tooltip. Histogram mewakili distribusi nilai bucket untuk stempel waktu tertentu.
+ **Tampilkan skala warna** - Tampilkan skala warna pada tooltip. Skala warna mewakili pemetaan antara nilai bucket dan warna.

**Legenda**

Pilih apakah Anda ingin menampilkan legenda peta panas pada visualisasi.

**Teladan**

Mengatur warna yang digunakan untuk menampilkan data contoh.

# Histogram
<a name="v10-panels-histogram"></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)

Visualisasi histogram menghitung distribusi nilai dan menyajikannya sebagai diagram batang. Sumbu Y dan tinggi setiap batang mewakili jumlah nilai yang termasuk dalam setiap braket sedangkan sumbu X mewakili rentang nilai.

![\[Gambar yang menunjukkan contoh visualisasi histogram di Grafana.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/histogram-example.png)


## Format yang didukung
<a name="v10-panels-histogram-formats"></a>

Visualisasi histogram mendukung deret waktu dan hasil tabel apa pun dengan satu atau lebih bidang numerik.

## Opsi tampilan
<a name="v10-panels-histogram-options"></a>

Gunakan opsi ini untuk menyempurnakan visualisasi Anda.

**Ukuran ember**

Ukuran ember. Biarkan ini kosong untuk ukuran ember otomatis (\$1 10% dari rentang penuh).

**Ember offset**

Jika ember pertama tidak harus mulai dari nol. Offset bukan nol menggeser jendela agregasi. Misalnya, ember berukuran 5 yang 0—5, 5—10, 10—15 dengan offset default 0 akan menjadi 2—7, 7—12, 12—17 dengan offset 2; offset 0, 5, atau 10, dalam hal ini, secara efektif tidak akan melakukan apa-apa. Biasanya, opsi ini akan digunakan dengan ukuran bucket yang ditentukan secara eksplisit daripada otomatis. Agar pengaturan ini mempengaruhi, jumlah offset harus lebih besar dari 0 dan kurang dari ukuran bucket; nilai di luar rentang ini akan memiliki efek yang sama dengan nilai dalam rentang ini.

**Gabungkan seri**

Ini akan menggabungkan semua seri dan bidang menjadi histogram gabungan.

**Lebar garis**

Kontrol lebar garis bar.

**Isi opacity**

Mengontrol opasitas isian bilah.

**Mode gradien**

Atur mode pengisian gradien. Gradien isi didasarkan pada warna garis. Untuk mengubah warna, gunakan opsi bidang skema warna standar. Tampilan gradien dipengaruhi oleh pengaturan **Fill opacity**.
+  **Tidak ada** - Tidak ada gradien fill, ini adalah pengaturan default.
+  **Opacity** — Transparansi gradien dihitung berdasarkan nilai pada sumbu Y. Opasitas isi meningkat dengan nilai-nilai pada sumbu Y.
+  **Hue** - Warna gradien dihasilkan berdasarkan rona warna garis.

## Opsi legenda
<a name="v10-panels-histogram-legend"></a>

Saat opsi legenda diaktifkan, opsi ini dapat menampilkan pemetaan nilai atau tanda kurung ambang batas. Untuk menampilkan pemetaan nilai dalam legenda, penting bahwa opsi skema Warna di bawah opsi standar diatur ke Warna tunggal atau Palet klasik. Untuk melihat tanda kurung ambang batas dalam legenda, atur skema Warna ke Dari ambang batas. Untuk informasi selengkapnya tentang legenda, lihat [Mengonfigurasi legenda](v10-panels-configure-legend.md).

**Mode legenda**

Gunakan pengaturan ini untuk menentukan bagaimana legenda muncul dalam visualisasi Anda.
+  **Daftar** - Menampilkan legenda sebagai daftar. Ini adalah mode tampilan default legenda.
+  **Tabel** - Menampilkan legenda sebagai tabel.
+  **Tersembunyi** — Menyembunyikan legenda.

**Penempatan legenda**

Pilih tempat untuk menempatkan legenda.
+  **Bawah** - Di bawah grafik.
+  **Kanan** - Di sebelah kanan grafik.

**Nilai Legenda**

Pilih perhitungan standar mana yang akan ditampilkan dalam legenda. Anda dapat memiliki lebih dari satu. Untuk informasi selengkapnya, lihat [Jenis perhitungan](v10-panels-calculation-types.md).

**Perhitungan legenda**

Pilih perhitungan mana yang akan ditampilkan dalam legenda. Anda dapat memilih lebih dari satu.

# Beberapa catatan
<a name="v10-panels-logs"></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)

Visualisasi panel log menunjukkan baris log dari sumber data yang mendukung log, seperti Elastic, Influx, dan Loki. Biasanya, Anda akan menggunakan panel ini di sebelah panel grafik untuk menampilkan output log dari proses terkait.

Panel log menunjukkan hasil kueri yang dimasukkan pada tab **Kueri**. Hasil dari beberapa kueri digabungkan dan diurutkan berdasarkan waktu. Anda dapat menggulir ke dalam panel jika sumber data mengembalikan lebih banyak baris daripada yang dapat ditampilkan.

Untuk membatasi jumlah baris yang dirender, Anda dapat menggunakan pengaturan **Titik data Maks** dalam **opsi Kueri**. Jika tidak disetel, sumber data biasanya akan memberlakukan batas default.

## Tingkat log
<a name="v10-panels-logs-level"></a>

Untuk log di mana label **level** ditentukan, kami menggunakan nilai label untuk menentukan level log dan memperbarui warna yang sesuai. Jika log tidak memiliki label level yang ditentukan, kami mencoba mencari tahu apakah kontennya cocok dengan ekspresi yang didukung (lihat di bawah untuk informasi lebih lanjut). Level log selalu ditentukan oleh pertandingan pertama. Jika Grafana tidak dapat menentukan level log, itu akan divisualisasikan dengan level log yang **tidak diketahui**. Untuk informasi selengkapnya, lihat [Tingkat log](v10-explore-logs.md#v10-explore-log-level).

## Rincian log
<a name="v10-panels-logs-details"></a>

Setiap baris log memiliki area yang dapat diperpanjang dengan label dan bidang yang terdeteksi, untuk interaksi yang lebih kuat. Setiap bidang atau label memiliki ikon statistik untuk menampilkan statistik dalam kaitannya dengan semua log yang ditampilkan.

**Tautan data**

Dengan menggunakan tautan data, Anda dapat mengubah bagian mana pun dari pesan log menjadi tautan internal atau eksternal. Tautan yang dibuat terlihat sebagai tombol di bagian **Tautan** di dalam tampilan **detail Log**.

**Opsi tampilan**

Gunakan pengaturan berikut untuk menyempurnakan visualisasi Anda:
+ **Waktu** - Tampilkan atau sembunyikan kolom waktu. Ini adalah stempel waktu yang terkait dengan baris log seperti yang dilaporkan dari sumber data.
+ **Label unik** - Tampilkan atau sembunyikan kolom label unik, yang hanya menampilkan label yang tidak umum.
+ **Label umum** - Tampilkan atau sembunyikan label umum
+ **Garis bungkus** - Alihkan pembungkus garis.
+ **Prettify JSON** - Atur ini `true` untuk mencetak semua log JSON dengan cantik. Pengaturan ini tidak memengaruhi log dalam format apa pun selain JSON.
+ **Aktifkan detail log** - Beralih opsi untuk melihat tampilan detail log untuk setiap baris log. Pengaturan default-nya adalah `true`.
+ **Urutan** - Menampilkan hasil dalam urutan waktu turun atau naik. Defaultnya adalah **Descending**, menampilkan log terbaru terlebih dahulu. Setel ke **Ascending** untuk menampilkan baris log tertua terlebih dahulu.

# Berita
<a name="v10-panels-news"></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)

Visualisasi berita menampilkan umpan RSS. Secara default, ini menampilkan artikel dari blog Grafana Labs, dan pengguna dapat mengubahnya dengan memasukkan URL umpan RSS yang berbeda.

Masukkan URL RSS di bagian **Tampilan**. Jenis visualisasi ini tidak menerima kueri lain, dan pengguna seharusnya tidak berharap untuk dapat menyinggung atau menanyakan data umpan RSS dengan cara apa pun menggunakan visualisasi ini.

**catatan**  
Umpan RSS dimuat oleh ujung depan Grafana tanpa proxy. Akibatnya, hanya umpan RSS yang dikonfigurasi dengan [header CORS](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS) yang sesuai yang akan dimuat. Jika umpan RSS yang Anda coba tampilkan gagal dimuat, pertimbangkan untuk menghosting ulang umpan RSS atau membuat proxy Anda sendiri.

# Grafik simpul
<a name="v10-panels-node-graph"></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)

Grafik node dapat memvisualisasikan grafik atau jaringan yang diarahkan. Mereka menggunakan tata letak gaya terarah untuk memposisikan node secara efektif, sehingga mereka dapat membantu menampilkan peta infrastruktur yang kompleks, hierarki, atau menjalankan diagram.

## Persyaratan data
<a name="v10-panels-node-graph-requirements"></a>

Grafik simpul membutuhkan bentuk data tertentu untuk dapat menampilkan simpul dan tepinya. Tidak semua sumber data atau kueri dapat divisualisasikan dengan grafik ini. Jika Anda ingin menggunakan ini sebagai pengembang sumber data, lihat bagian tentang API data.

Grafik simpul terdiri dari *node* dan *tepi*.
+ Sebuah *node* ditampilkan sebagai lingkaran. Sebuah node mungkin mewakili aplikasi, layanan, atau apa pun yang relevan dari perspektif aplikasi.
+ *Tepi* ditampilkan sebagai garis yang menghubungkan dua node. Koneksi mungkin permintaan, operasi, atau hubungan lain antara dua node.

Baik node dan edge dapat memiliki metadata atau statistik terkait. Sumber data mendefinisikan informasi dan nilai apa yang ditampilkan, sehingga sumber data yang berbeda dapat menunjukkan jenis nilai yang berbeda atau tidak menunjukkan beberapa nilai.

## Node
<a name="v10-panels-node-graph-nodes"></a>

Biasanya, node menunjukkan dua nilai statistik di dalam node dan dua pengidentifikasi tepat di bawah node, biasanya nama dan jenis. Node juga dapat menampilkan serangkaian nilai lain sebagai lingkaran warna di sekitar node, dengan bagian warna berbeda mewakili nilai yang berbeda yang harus menambahkan hingga 1. Misalnya, Anda dapat memiliki persentase kesalahan yang diwakili oleh bagian merah dari lingkaran.

Detail tambahan dapat ditampilkan dalam menu konteks, yang ditampilkan saat Anda memilih node. Ada juga tautan tambahan di menu konteks yang dapat menargetkan bagian lain dari ruang kerja Grafana atau tautan eksternal apa pun.

**catatan**  
Grafik node hanya dapat menampilkan 1.500 node. Jika batas ini dilintasi, peringatan terlihat di sudut kanan atas, dan beberapa node akan disembunyikan. Anda dapat memperluas bagian tersembunyi dari grafik dengan mengklik penanda **node tersembunyi** dalam grafik.

## Tepi
<a name="v10-panels-node-graph-edges"></a>

Tepi juga dapat menunjukkan statistik saat Anda mengarahkan kursor ke tepi. Mirip dengan node, Anda dapat membuka menu konteks dengan detail dan tautan tambahan dengan memilih tepi.

Sumber data pertama yang mendukung visualisasi ini adalah sumber AWS X-Ray data untuk fitur peta layanannya. Untuk informasi selengkapnya, lihat [Connect ke sumber AWS X-Ray data](x-ray-data-source.md).

## Menavigasi grafik simpul
<a name="v10-panels-node-graph-navigation"></a>

**Panci**

Anda dapat menggeser dalam grafik simpul dengan memilih di luar node atau tepi mana pun dan menyeret pointer.

**Memperbesar atau memperkecil**

Anda dapat memperbesar dengan menggunakan tombol di sudut kiri atas grafik simpul, atau menggunakan roda mouse atau input gulir lainnya dengan tombol `Ctrl` (atau`Cmd`).

**Jelajahi node tersembunyi**

Jumlah node yang ditampilkan pada waktu tertentu terbatas untuk mempertahankan kinerja yang wajar. Node yang berada di luar batas ini tersembunyi di balik penanda yang dapat dipilih yang menunjukkan perkiraan jumlah node tersembunyi yang terhubung ke tepi itu. Anda dapat memilih penanda untuk memperluas grafik di sekitar simpul itu.

**Tampilan kisi**

Anda dapat beralih ke tampilan grid untuk memiliki gambaran yang lebih baik dari node yang paling menarik dalam grafik. Tampilan grid menunjukkan node dalam grid tanpa tepi dan dapat diurutkan berdasarkan statistik yang ditunjukkan di dalam node atau oleh statistik yang diwakili oleh batas berwarna dari node.

Untuk mengurutkan node, pilih statistik di dalam legenda. Penanda di sebelah nama stat (salah satu `˄` atau`˅`) menunjukkan stat mana yang saat ini digunakan untuk menyortir dan menyortir arah.

Pilih node dan kemudian pilih opsi **Tunjukkan dalam tata letak Grafik** untuk beralih kembali ke tata letak grafik dengan fokus pada simpul yang dipilih, untuk menunjukkannya dalam konteks grafik lengkap.

## Data API
<a name="v10-panels-node-graph-data-api"></a>

Visualisasi ini membutuhkan bentuk data tertentu yang akan dikembalikan dari sumber data agar dapat menampilkannya dengan benar.

Grafik Node minimal membutuhkan bingkai data yang menggambarkan tepi grafik. Secara default, grafik node akan menghitung node dan statistik apa pun berdasarkan bingkai data ini. Secara opsional, bingkai data kedua yang menjelaskan node dapat dikirim jika ada kebutuhan untuk menampilkan metadata spesifik node yang lebih spesifik. Anda harus mengatur `frame.meta.preferredVisualisationType = 'nodeGraph'` pada kedua frame data atau menamainya `nodes` dan `edges` masing-masing untuk grafik node untuk dirender.

**Tepi data dari struktur**

Bidang yang diperlukan:


| Nama bidang | Tipe | Deskripsi | 
| --- | --- | --- | 
| id | string | Pengidentifikasi unik tepi. | 
| sumber | string | Id dari simpul sumber. | 
| target | string | Id dari target. | 

Bidang opsional:


| Nama bidang | Tipe | Deskripsi | 
| --- | --- | --- | 
| mainstat | string/nomor | Stat pertama ditampilkan di overlay saat melayang di atas tepi. Ini bisa berupa string yang menunjukkan nilai apa adanya atau bisa berupa angka. Jika itu adalah angka, unit apa pun yang terkait dengan bidang itu juga ditampilkan. | 
| Secondarystat | string/nomor | Sama seperti MainStat, tetapi ditampilkan tepat di bawahnya. | 
| detail\$1\$1\$1 | string/nomor | Bidang apa pun yang diawali dengan `detail__` akan ditampilkan di header menu konteks saat diklik di tepi. Gunakan `config.displayName` untuk label yang lebih mudah dibaca manusia. | 

**Node data dari struktur**

Bidang yang diperlukan:


| Nama bidang | Tipe | Deskripsi | 
| --- | --- | --- | 
| id | string | Pengidentifikasi unik dari node. ID ini direferensikan oleh edge di bidang sumber dan targetnya. | 

Bidang opsional:


| Nama bidang | Tipe | Deskripsi | 
| --- | --- | --- | 
| title | string | Nama node terlihat tepat di bawah node. | 
| subjudul | string | Tambahan, nama, jenis atau pengenal lain yang ditampilkan di bawah judul. | 
| mainstat | string/nomor | Stat pertama ditampilkan di dalam node itu sendiri. Ini bisa berupa string yang menunjukkan nilai apa adanya atau angka. Jika itu adalah angka, unit apa pun yang terkait dengan bidang itu juga ditampilkan.  | 
| Secondarystat | string/nomor | Sama seperti MainStat, tetapi ditampilkan di bawahnya di dalam node. | 
| busur\$1\$1\$1 | number | Setiap bidang yang diawali dengan `arc__` akan digunakan untuk membuat lingkaran warna di sekitar node. Semua nilai dalam bidang ini harus menambahkan hingga 1. Anda dapat menentukan warna menggunakan`config.color.fixedColor`. | 
| detail\$1\$1\$1 | string/nomor | Setiap bidang yang diawali dengan `detail__` akan ditampilkan di header menu konteks saat diklik pada node. Gunakan `config.displayName` untuk label yang lebih mudah dibaca manusia. | 
| warna | string/nomor | Dapat digunakan untuk menentukan satu warna alih-alih menggunakan `arc__` bidang untuk menentukan bagian warna. Ini bisa berupa string (itu harus berupa string warna HTML yang dapat diterima), atau bisa berupa angka, dalam hal ini perilaku tergantung pada `field.config.color.mode` pengaturan. Ini dapat digunakan, misalnya, untuk membuat warna gradien yang dikendalikan oleh nilai bidang. | 
| ikon | string | Nama ikon untuk ditampilkan di dalam node bukan statistik default. Hanya ikon bawaan Grafana yang diizinkan (lihat ikon yang tersedia di [sini](https://developers.grafana.com/ui/latest/index.html?path=/story/docs-overview-icon--icons-overview)). | 
| NodeRadius | number | Nilai radius dalam piksel. Digunakan untuk mengelola ukuran node. | 
| disorot | Boolean | Menetapkan apakah node harus disorot. Gunakan, misalnya, untuk mewakili jalur tertentu dalam grafik dengan menyoroti beberapa node dan tepi. Default ke `false`. | 

# Bagan pai
<a name="v10-panels-piechart"></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)

![\[Gambar yang menunjukkan contoh visualisasi diagram lingkaran di Grafana.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/pie_chart_example.png)


Diagram lingkaran menampilkan seri yang dikurangi, atau nilai dalam seri, dari satu atau lebih kueri, karena mereka berhubungan satu sama lain, dalam bentuk irisan kue. Panjang busur, luas dan sudut tengah irisan semuanya sebanding dengan nilai irisan, karena berkaitan dengan jumlah semua nilai. Jenis bagan ini paling baik digunakan ketika Anda menginginkan perbandingan cepat dari serangkaian kecil nilai dalam bentuk yang menyenangkan secara estetika.

## Opsi nilai
<a name="v10-panels-piechart-value"></a>

Gunakan opsi berikut untuk menyempurnakan nilai dalam visualisasi Anda.

**Tampilkan**

Pilih berapa banyak informasi yang akan ditampilkan.
+ **Hitung** — Mengurangi setiap nilai menjadi satu nilai per seri.
+ **Semua nilai** - Menampilkan setiap nilai dari satu seri.

**Perhitungan**

Pilih perhitungan untuk mengurangi setiap seri saat **Hitung** telah dipilih. Untuk informasi tentang perhitungan yang tersedia, lihat [Jenis perhitungan](v10-panels-calculation-types.md).

**Batasi**

Saat menampilkan setiap nilai dari satu seri, ini membatasi jumlah nilai yang ditampilkan.

**Bidang**

Pilih setidaknya satu bidang untuk ditampilkan dalam visualisasi. Setiap nama bidang tersedia dalam daftar, atau Anda dapat memilih salah satu opsi berikut:
+ **Bidang numerik** - Semua bidang dengan nilai numerik.
+ **Semua bidang** — Semua bidang yang tidak dihapus oleh transformasi.
+ **Waktu** - Semua bidang dengan nilai waktu.

## Opsi diagram lingkaran
<a name="v10-panels-piechart-options"></a>

Gunakan opsi ini untuk menyempurnakan tampilan visualisasi Anda.

**Jenis diagram pai**

Pilih gaya tampilan diagram lingkaran. Bisa berupa:
+ **Pie** — Bagan lingkaran standar
+ **Donat** — Diagram lingkaran dengan lubang di tengah

**Label**

Pilih label untuk ditampilkan pada diagram lingkaran. Anda dapat memilih lebih dari satu.
+ **Nama - Nama** seri atau bidang.
+ **Persentase** — Persentase keseluruhan.
+ **Nilai — Nilai** numerik mentah.

Label ditampilkan dalam warna putih di atas badan bagan secara default. Anda dapat memilih warna grafik yang lebih gelap untuk membuatnya lebih terlihat. Nama atau angka panjang mungkin terpotong.

**Mode Tooltip**

Saat Anda mengarahkan kursor ke visualisasi, Grafana dapat menampilkan tooltips. Pilih bagaimana tooltips berperilaku.
+ **Single** - Tooltip hover hanya menampilkan satu seri, yang Anda arahkan pada visualisasi.
+ **Semua** - Tooltip hover menunjukkan semua seri dalam visualisasi. Grafana menyoroti seri yang Anda arahkan dengan huruf tebal dalam daftar seri di tooltip.
+ **Tersembunyi** — Jangan tampilkan tooltip saat Anda berinteraksi dengan visualisasi.

Gunakan override untuk menyembunyikan seri individual dari tooltip.

## Opsi legenda
<a name="v10-panels-piechart-legend"></a>

Gunakan pengaturan ini untuk menentukan bagaimana legenda muncul dalam visualisasi Anda. Untuk informasi selengkapnya tentang legenda, lihat [Mengonfigurasi legenda](v10-panels-configure-legend.md).

**Visibilitas legenda**

Gunakan sakelar **Visibilitas** untuk menampilkan atau menyembunyikan legenda.

**Mode legenda**

Atur mode tampilan legenda.
+ **Daftar** - Menampilkan legenda sebagai daftar. Ini adalah mode tampilan default legenda.
+ **Tabel** - Menampilkan legenda sebagai tabel.

**Penempatan legenda**

Pilih tempat untuk menampilkan legenda.
+ **Bawah** - Di bawah grafik.
+ **Kanan** - Di sebelah kanan grafik.

**Nilai legenda**

Pilih nilai untuk ditampilkan dalam legenda. Anda dapat memilih lebih dari satu.
+ **Persentase** — Persentase keseluruhan.
+ **Nilai — Nilai** numerik mentah.

Untuk informasi selengkapnya tentang legenda, lihat [Mengonfigurasi legenda](v10-panels-configure-legend.md).

# Stat
<a name="v10-panels-stat"></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)

Statistik menunjukkan satu nilai stat besar dengan sparkline grafik opsional. Anda dapat mengontrol latar belakang atau warna nilai menggunakan ambang batas atau penggantian.

![\[Gambar yang menunjukkan contoh visualisasi stat di Grafana.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/stat_panel_example.png)


Secara default, Stat menampilkan salah satu dari berikut ini:
+ Hanya nilai untuk satu seri atau bidang.
+ Baik nilai dan nama untuk beberapa seri atau bidang.

Anda dapat menggunakan **mode Teks** untuk mengontrol apakah teks ditampilkan atau tidak.

## Penyesuaian tata letak otomatis
<a name="v10-panels-stat-automatic-adjust"></a>

Panel secara otomatis menyesuaikan tata letak tergantung pada lebar dan tinggi yang tersedia di dasbor. Secara otomatis menyembunyikan grafik (sparkline) jika panel menjadi terlalu kecil.

## Opsi nilai
<a name="v10-panels-stat-value"></a>

Gunakan opsi berikut untuk menyempurnakan bagaimana visualisasi Anda menampilkan nilai:

**Tampilkan**

Pilih cara Grafana menampilkan data Anda.
+ **Hitung**

  Tampilkan nilai yang dihitung berdasarkan semua baris.
  + **Perhitungan** — Pilih fungsi peredam yang akan digunakan Grafana untuk mengurangi banyak bidang menjadi satu nilai. Untuk daftar perhitungan yang tersedia, lihat [perhitungan standar](v10-panels-calculation-types.md).
  + **Bidang** - Pilih bidang yang ditampilkan dalam visualisasi.
+ **Semua nilai**

  Tampilkan stat terpisah untuk setiap baris. Jika Anda memilih opsi ini, maka Anda juga dapat membatasi jumlah baris yang akan ditampilkan.
  + **Batas** — Jumlah maksimum baris yang akan ditampilkan. Defaultnya adalah 5.000.
  + **Bidang** - Pilih bidang yang ditampilkan dalam visualisasi.

## Gaya stat
<a name="v10-panels-stat-styles"></a>

Gaya visualisasi Anda.

**Orientasi**

Pilih arah susun.
+ **Otomatis** — Grafana memilih apa yang dianggapnya sebagai orientasi terbaik.
+ **Horizontal** - Batang meregang secara horizontal, kiri ke kanan.
+ **Vertikal** - Batang meregang secara vertikal, dari atas ke bawah.

**Modus teks**

Anda dapat menggunakan opsi mode Teks untuk mengontrol teks apa yang dirender visualisasi. Jika nilainya tidak penting, hanya nama dan warnanya, lalu ubah **mode Teks** menjadi **Nama**. Nilai akan tetap digunakan untuk menentukan warna dan ditampilkan dalam tooltip.
+ **Otomatis** - Jika data berisi beberapa seri atau bidang, tampilkan nama dan nilai.
+ **Nilai** - Tampilkan hanya nilai, jangan pernah nama. Nama ditampilkan di tooltip hover sebagai gantinya.
+ **Nilai dan nama** — Selalu tunjukkan nilai dan nama.
+ **Nama** - Tampilkan nama, bukan nilai. Nilai ditampilkan di tooltip hover.
+ **Tidak ada** - Tidak menunjukkan apa-apa (kosong). Nama dan nilai ditampilkan di tooltip hover.

**Tata letak yang luas**

Atur apakah tata letak lebar diaktifkan atau tidak. Tata letak lebar diaktifkan secara default.
+ **Aktif** - Tata letak lebar dihidupkan.
+ **Mati** - Tata letak lebar dimatikan.

**catatan**  
Opsi ini hanya berlaku ketika **mode Teks** diatur ke **Nilai dan nama**. Ketika tata letak lebar dihidupkan, nilai dan nama ditampilkan side-by-side dengan nilai di sebelah kanan, jika panel cukup lebar. Ketika tata letak lebar dimatikan, nilai selalu dirender di bawah nama.

**Modus warna**

Pilih mode warna.
+ **Tidak ada** - Tidak ada warna yang diterapkan pada nilai.
+ **Nilai** - Menerapkan warna ke nilai dan area grafik.
+ **Gradien Latar Belakang** - Menerapkan warna pada nilai, area grafik, dan latar belakang, dengan sedikit gradien latar belakang.
+ **Latar Belakang Solid** - Menerapkan warna ke nilai, area grafik, dan latar belakang, dengan warna latar belakang yang solid.

**Modus grafik**

Pilih grafik dan mode sparkline.
+ **Tidak ada** - Menyembunyikan grafik dan hanya menunjukkan nilainya.
+ **Area** - Menunjukkan grafik area di bawah nilai. Ini mengharuskan kueri Anda mengembalikan kolom waktu.

**Penjajaran teks**

Pilih mode penyelarasan.
+ **Otomatis** - Jika hanya satu nilai yang ditampilkan (tidak ada pengulangan), maka nilainya terpusat. Jika beberapa seri atau baris ditampilkan, maka nilainya sejajar kiri.
+ **Pusat** — Nilai Stat dipusatkan.

**Tunjukkan persen perubahan**

Tetapkan apakah perubahan persen ditampilkan atau tidak. Secara default itu tidak ditampilkan.

**catatan**  
Opsi ini tidak berlaku ketika pengaturan **Tampilkan**, di bawah **opsi Nilai**, diatur ke **Semua nilai**.

## Ukuran teks
<a name="v10-panels-stat-textsize"></a>

Sesuaikan ukuran teks pengukur.
+ **Judul** - Masukkan nilai numerik untuk ukuran judul pengukur.
+ **Nilai** - Masukkan nilai numerik untuk ukuran nilai pengukur.

# Garis waktu negara
<a name="v10-panels-state-timeline"></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)

Garis waktu status menunjukkan perubahan status diskrit dari waktu ke waktu. Setiap bidang atau seri dirender sebagai pita horisontal yang unik. Wilayah negara bagian dapat dirender dengan atau tanpa nilai. Panel ini bekerja dengan baik dengan status string atau boolean tetapi juga dapat digunakan dengan deret waktu. Ketika digunakan dengan deret waktu, ambang batas digunakan untuk mengubah nilai numerik menjadi wilayah keadaan diskrit.

![\[Gambar yang menunjukkan contoh visualisasi garis waktu status di Grafana.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/state_timeline_example.png)


## Opsi garis waktu negara
<a name="v10-panels-state-timeline-options"></a>

Gunakan opsi ini untuk menyempurnakan visualisasi Anda:

**Gabungkan nilai berurutan yang sama**

Mengontrol apakah Grafana menggabungkan nilai yang identik jika keduanya bersebelahan.

**Tampilkan nilai**

Mengontrol apakah nilai dirender di dalam wilayah negara bagian. **Otomatis** akan merender nilai jika ada ruang yang cukup.

**Sejajarkan nilai**

Mengontrol penyelarasan nilai di dalam wilayah negara bagian.

**Tinggi baris**

Mengontrol ruang antar baris. 1 = tidak ada spasi = 0,5 = 50% ruang.

**Lebar garis**

Mengontrol lebar garis wilayah negara bagian.

**Isi opacity**

Mengontrol opasitas wilayah negara bagian.

**Connect nilai null**

Pilih bagaimana nilai nol, yang merupakan celah dalam data, muncul pada grafik. Nilai nol dapat dihubungkan untuk membentuk garis kontinu atau diatur ke ambang batas di mana celah dalam data tidak lagi terhubung.
+ **Tidak pernah** — Titik data deret waktu dengan celah dalam data tidak pernah terhubung.
+ **Selalu** — Titik data deret waktu dengan celah dalam data selalu terhubung.
+ **Ambang batas** — Tentukan ambang batas di mana celah dalam data tidak lagi terhubung. Ini dapat berguna ketika celah yang terhubung dalam data memiliki ukuran yang diketahui atau dalam rentang yang diketahui, dan celah di luar rentang ini seharusnya tidak lagi terhubung.

**Putuskan nilai**

Pilih apakah akan menetapkan ambang batas di atas nilai mana dalam data harus terputus.
+ **Tidak pernah** — Titik data deret waktu dalam data tidak pernah terputus.
+ **Ambang batas** — Tentukan ambang batas di atas mana nilai dalam data terputus. Ini dapat berguna ketika nilai yang diinginkan dalam data memiliki ukuran yang diketahui atau dalam rentang yang diketahui, dan nilai di luar rentang ini seharusnya tidak lagi terhubung.

## Pemetaan nilai
<a name="v10-panels-state-timeline-valuemap"></a>

Untuk menetapkan warna ke nilai boolean atau string, gunakan. [Konfigurasikan pemetaan nilai](v10-panels-configure-value-mappings.md)

## Data deret waktu dengan ambang batas
<a name="v10-panels-state-timeline-threshold"></a>

Visualisasi dapat digunakan dengan data deret waktu juga. Dalam hal ini, ambang batas digunakan untuk mengubah deret waktu menjadi daerah keadaan berwarna diskrit.

## Opsi legenda
<a name="v10-panels-state-timeline-legend"></a>

Saat opsi legenda diaktifkan, opsi ini dapat menampilkan pemetaan nilai atau tanda kurung ambang batas. Untuk menampilkan pemetaan nilai dalam legenda, penting bahwa opsi **skema Warna** di bawah Opsi standar diatur ke **Warna tunggal** atau Palet **klasik**. Untuk melihat tanda kurung ambang batas dalam legenda, atur **skema Warna** ke **Dari ambang batas**.

**Mode legenda**

Gunakan pengaturan ini untuk menentukan bagaimana legenda muncul dalam visualisasi Anda. Untuk informasi selengkapnya tentang legenda, lihat [Mengonfigurasi legenda](v10-panels-configure-legend.md).
+ **Daftar** - Menampilkan legenda sebagai daftar. Ini adalah mode default.
+ **Tabel** - Menampilkan legenda sebagai tabel.
+ **Tersembunyi** — Menyembunyikan legenda.

**Penempatan legenda**

Pilih tempat untuk menampilkan legenda.
+ **Bawah** - Di bawah grafik.
+ **Kanan** - Di sebelah kanan grafik.

**Nilai legenda**

Pilih [perhitungan standar](v10-panels-calculation-types.md) mana yang akan ditampilkan dalam legenda. Anda dapat memiliki lebih dari satu.

# Riwayat status
<a name="v10-panels-status-history"></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)

Sejarah status menunjukkan keadaan periodik dari waktu ke waktu. Setiap bidang atau seri dirender sebagai baris horizontal. Kotak dirender dan dipusatkan di sekitar setiap nilai.

## Data yang didukung
<a name="v10-panels-status-history-supporteddata"></a>

Riwayat status bekerja dengan string, boolean, dan bidang numerik atau deret waktu. Diperlukan bidang waktu. Anda dapat menggunakan pemetaan nilai untuk mewarnai string atau menetapkan nilai teks ke rentang numerik.

## Opsi tampilan
<a name="v10-panels-status-history-options"></a>

Gunakan opsi ini untuk menyempurnakan visualisasi.

**Tampilkan nilai**

Mengontrol apakah nilai dirender di dalam kotak nilai. **Otomatis** akan merender nilai jika ada ruang yang cukup.

**Lebar kolom**

Mengontrol lebar kotak. 1 = ruang maksimum dan 0 = ruang minimum.

**Lebar garis**

Mengontrol lebar garis wilayah negara bagian.

**Isi opacity**

Mengontrol opasitas pengisian wilayah negara bagian.

## Pemetaan nilai
<a name="v10-panels-status-history-valuemap"></a>

Untuk menetapkan warna ke nilai boolean atau string, gunakan. [Konfigurasikan pemetaan nilai](v10-panels-configure-value-mappings.md)

## Data deret waktu dengan ambang batas
<a name="v10-panels-status-history-threshold"></a>

Panel dapat digunakan dengan data deret waktu juga. Dalam hal ini, ambang batas digunakan untuk mewarnai kotak. Anda juga dapat menggunakan skema warna gradien untuk mewarnai nilai.

## Opsi legenda
<a name="v10-panels-status-history-legend"></a>

Saat opsi legenda diaktifkan, opsi ini dapat menampilkan pemetaan nilai atau tanda kurung ambang batas. Untuk menampilkan pemetaan nilai dalam legenda, penting bahwa opsi **skema Warna** di bawah Opsi standar diatur ke **Warna tunggal** atau Palet **klasik**. Untuk melihat tanda kurung ambang batas dalam legenda, atur **skema Warna** ke **Dari ambang batas**.

**Mode legenda**

Gunakan pengaturan ini untuk menentukan bagaimana legenda muncul dalam visualisasi Anda. Untuk informasi selengkapnya tentang legenda, lihat [Mengonfigurasi legenda](v10-panels-configure-legend.md).
+ **Daftar** - Menampilkan legenda sebagai daftar. Ini adalah mode default.
+ **Tabel** - Menampilkan legenda sebagai tabel.
+ **Tersembunyi** — Menyembunyikan legenda.

**Penempatan legenda**

Pilih tempat untuk menampilkan legenda.
+ **Bawah** - Di bawah grafik.
+ **Kanan** - Di sebelah kanan grafik.

**Nilai legenda**

Pilih [perhitungan standar](v10-panels-calculation-types.md) mana yang akan ditampilkan dalam legenda. Anda dapat memiliki lebih dari satu.

# Tabel
<a name="v10-panels-table"></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)

Tabel sangat fleksibel, mendukung beberapa mode untuk deret waktu dan untuk tabel, anotasi, dan data JSON mentah. Visualisasi ini juga menyediakan pemformatan tanggal, pemformatan nilai, dan opsi pewarnaan.

![\[Gambar yang menunjukkan contoh visualisasi tabel di Grafana.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/table_example.png)


**catatan**  
Anotasi dan peringatan tidak didukung dalam tabel.

## Urutkan kolom
<a name="v10-panels-table-sort"></a>

Pilih judul kolom untuk mengubah urutan pengurutan dari default ke turun ke naik. Setiap kali Anda memilih kolom, urutan pengurutan berubah ke opsi berikutnya dalam siklus. Anda dapat mengurutkan beberapa kolom dengan menahan `shift` tombol saat memilih kolom tambahan.

## Opsi tabel
<a name="v10-panels-table-options"></a>

**Tampilkan header**

Tampilkan atau sembunyikan nama kolom yang diimpor dari sumber data Anda.

## Lebar kolom
<a name="v10-panels-table-width"></a>

Secara default, Grafana secara otomatis menghitung lebar kolom berdasarkan ukuran tabel dan lebar kolom minimum. Opsi bidang ini dapat mengganti pengaturan dan menentukan lebar untuk semua kolom dalam piksel.

Misalnya, jika Anda masuk`100`, semua kolom akan diatur ke lebar 100 piksel (perubahan terjadi saat Anda keluar dari bidang).

## Lebar kolom minimum
<a name="v10-panels-table-min"></a>

Secara default, lebar minimum kolom tabel adalah 150 piksel. Opsi bidang ini dapat mengganti default itu dan akan menentukan lebar kolom minimum baru untuk panel tabel dalam piksel.

Misalnya, jika Anda menetapkan minimum ke`75`, semua kolom akan skala tidak lebih kecil dari 75 piksel lebar.

Untuk perangkat layar kecil, seperti smartphone atau tablet, Anda dapat mengurangi nilai `150` piksel default `50` untuk memungkinkan panel berbasis tabel dirender dengan benar di dasbor.

## Penyelarasan kolom
<a name="v10-panels-table-alignment"></a>

Pilih bagaimana Grafana harus menyelaraskan isi sel.
+ Otomatis (default)
+ Kiri
+ Pusat
+ Kanan

## Jenis sel
<a name="v10-panels-table-cell-type"></a>

Secara default, Grafana secara otomatis memilih pengaturan tampilan. Anda dapat mengganti pengaturan dengan memilih salah satu opsi berikut untuk mengatur default untuk semua bidang. Konfigurasi tambahan tersedia untuk beberapa jenis sel.

**catatan**  
Jika Anda mengatur ini di tab **Bidang**, maka jenis akan berlaku untuk semua bidang, termasuk bidang waktu. Anda dapat mengaturnya di tab **Override** untuk menerapkan perubahan ke satu atau beberapa bidang.

**Teks warna**

Jika ambang batas ditetapkan, maka teks bidang ditampilkan dalam warna ambang batas yang sesuai.

**Latar belakang warna (gradien atau padat)**

Jika ambang batas ditetapkan, maka latar belakang bidang ditampilkan dalam warna ambang batas yang sesuai.

**Gauge**

Sel dapat ditampilkan sebagai pengukur grafis, dengan beberapa jenis presentasi yang berbeda.
+ *Dasar* — Mode dasar akan menunjukkan pengukur sederhana dengan tingkat ambang batas yang menentukan warna pengukur.
+ *Gradien* — Tingkat ambang batas menentukan gradien.
+ *LCD* — Pengukur dibagi dalam sel-sel kecil yang menyala atau tidak menyala.

Selain itu, label yang ditampilkan di samping alat pengukur dapat diatur untuk diwarnai berdasarkan nilai, cocok dengan warna teks tema, atau disembunyikan.
+ **Nilai warna**
+ **Warna teks**
+ **Tersembunyi**

**Tampilan JSON**

Menampilkan nilai diformat sebagai kode. Jika nilai adalah objek tampilan JSON memungkinkan browsing objek JSON akan muncul di hover.

**Sparkline**

Menampilkan nilai yang diberikan sebagai sparkline. Membutuhkan [deret waktu untuk mengubah data tabel](v10-panels-xform-functions.md#v10-panels-xform-funcs-series).

## Periksa nilai sel
<a name="v10-panels-table-cell-value"></a>

Memungkinkan pemeriksaan nilai dari sel tabel. Nilai mentah disajikan dalam jendela modal.

**catatan**  
Pemeriksaan nilai sel hanya tersedia ketika mode tampilan sel diatur ke Otomatis, Teks warna, Latar belakang warna, atau Tampilan JSON.

## Filter kolom
<a name="v10-panels-table-col-filter"></a>

Anda dapat mengubah sementara bagaimana data kolom ditampilkan. Misalnya, Anda dapat mengurutkan nilai dari tertinggi ke terendah atau menyembunyikan nilai tertentu. Untuk informasi selengkapnya, lihat [Menyaring kolom tabel](#v10-panels-table-filter).

## Paginasi
<a name="v10-panels-table-pagination"></a>

Gunakan opsi ini untuk mengaktifkan atau menonaktifkan pagination. Ini adalah opsi front-end yang tidak memengaruhi kueri. Saat diaktifkan, ukuran halaman secara otomatis menyesuaikan dengan ketinggian tabel.

## Filter kolom tabel
<a name="v10-panels-table-filter"></a>

Jika Anda mengaktifkan **filter Kolom**, maka Anda dapat memfilter opsi tabel.

**Untuk mengaktifkan pemfilteran kolom**

1. Di Grafana, arahkan ke dasbor dengan tabel dengan kolom yang ingin Anda filter.

1. Pada panel tabel yang ingin Anda filter, buka editor panel.

1. Pilih tab **Bidang**.

1. Dalam opsi **Tabel**, aktifkan opsi **Filter kolom**.

Ikon filter (corong) muncul di sebelah setiap judul kolom.

**Nilai kolom filter**

Untuk memfilter nilai kolom, pilih ikon filter (corong) di sebelah judul kolom. Grafana menampilkan opsi filter untuk kolom itu.

Pilih kotak centang di sebelah nilai yang ingin Anda tampilkan. Masukkan teks di bidang pencarian di bagian atas untuk menampilkan nilai-nilai tersebut di layar sehingga Anda dapat memilihnya daripada menggulir untuk menemukannya.

Pilih dari beberapa operator untuk menampilkan nilai kolom:
+ **Berisi** - Cocokkan pola regex (operator secara default).
+ **Ekspresi** - Mengevaluasi ekspresi Boolean. Karakter `$` mewakili nilai kolom dalam ekspresi (misalnya,`$ >= 10 ≈& $ <= 12`).
+ **Operator perbandingan** — Anda dapat menggunakan operator perbandingan khas:`=`,`!=`,`<`,`<=`,`>`,`>=`.

Pilih kotak centang di atas **Ok** dan **Batal** tombol untuk menambah atau menghapus semua nilai yang ditampilkan dari filter.

**Hapus filter kolom**

Kolom dengan filter yang diterapkan memiliki corong biru yang ditampilkan di sebelah judul.

Untuk menghapus filter, pilih ikon corong biru dan kemudian pilih **Hapus filter**.

## Footer meja
<a name="v10-panels-table-footer"></a>

Anda dapat menggunakan footer tabel untuk menampilkan [perhitungan](v10-panels-calculation-types.md) pada bidang.

Setelah Anda mengaktifkan footer tabel, Anda dapat memilih **Perhitungan**, dan kemudian **Bidang** yang ingin Anda hitung.

Sistem menerapkan perhitungan ke semua bidang numerik jika Anda tidak memilih bidang.

**Hitung baris**

Jika Anda ingin menampilkan jumlah baris dalam kumpulan data alih-alih jumlah nilai di bidang yang dipilih, pilih **Hitung perhitungan dan aktifkan Hitung** **baris**.

# Teks
<a name="v10-panels-text"></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)

Visualisasi teks memungkinkan Anda untuk secara langsung memasukkan teks atau HTML di dasbor Anda. Ini dapat digunakan untuk menambahkan informasi kontekstual dan deskripsi atau menanamkan HTML kompleks.

**Modus**

**Mode** menentukan bagaimana konten yang disematkan muncul. Ini memiliki opsi berikut:
+ **Markdown** - Opsi ini memformat konten sebagai penurunan harga.
+ **HTML** - Pengaturan ini membuat konten sebagai HTML yang disanitasi.
+ **Kode** - Pengaturan ini membuat konten di dalam editor kode read-only. Pilih bahasa yang sesuai untuk menerapkan penyorotan sintaks ke teks yang disematkan.

**Variabel**

Variabel dalam konten akan diperluas untuk ditampilkan.

# Deret waktu
<a name="v10-panels-time-series"></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)

![\[Gambar yang menunjukkan contoh visualisasi deret waktu di Grafana.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/time_series_example.png)


Visualisasi deret waktu adalah cara default dan utama untuk memvisualisasikan data deret waktu sebagai grafik. Mereka dapat membuat seri sebagai garis, titik, atau bar. Mereka cukup serbaguna untuk menampilkan hampir semua data deret waktu.

**catatan**  
Anda dapat memigrasikan visualisasi panel Grafik ke visualisasi deret Waktu. Untuk bermigrasi, pada tab **Panel**, pilih **Visualisasi deret waktu**. Grafana mentransfer semua pengaturan yang berlaku.

**Topics**
+ [Opsi tooltip](v10-time-series-panel-tooltip.md)
+ [Opsi legenda](v10-time-series-panel-legend.md)
+ [Gaya grafik](v10-time-series-graph.md)
+ [Opsi sumbu](v10-time-series-axis.md)
+ [Pilihan warna](v10-time-series-color.md)

# Opsi tooltip
<a name="v10-time-series-panel-tooltip"></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)

Opsi tooltip mengontrol hamparan informasi yang muncul saat Anda mengarahkan kursor ke titik data dalam grafik.

**Mode Tooltip**
+ **Single** - Tooltip hover hanya menampilkan satu seri, yang Anda arahkan.
+ **Semua** - Tooltip hover menunjukkan semua seri dalam visualisasi. Grafana menyoroti seri yang Anda arahkan dengan huruf tebal dalam daftar seri di tooltip.
+ **Tersembunyi** — Jangan tampilkan tooltip saat Anda berinteraksi dengan visualisasi.

# Opsi legenda
<a name="v10-time-series-panel-legend"></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)

Opsi legenda mengontrol nama seri dan statistik yang muncul di bawah atau di sebelah kanan grafik.

**Mode legenda**

Gunakan pengaturan ini untuk menentukan bagaimana legenda muncul dalam visualisasi Anda. Untuk informasi lebih lanjut tentang legenda, lihat[Konfigurasikan legenda](v10-panels-configure-legend.md).
+ **Daftar** - Menampilkan legenda sebagai daftar. Ini adalah mode tampilan default legenda.
+ **Tabel** - Menampilkan legenda sebagai tabel.
+ **Tersembunyi** — Menyembunyikan legenda.

**Penempatan legenda**

Pilih tempat untuk menampilkan legenda.
+ **Bawah** - Di bawah grafik.
+ **Kanan** - Di sebelah kanan grafik.

**Nilai legenda**

Pilih [perhitungan standar](v10-panels-calculation-types.md) mana yang akan ditampilkan dalam legenda. Anda dapat memiliki lebih dari satu.

# Gaya grafik
<a name="v10-time-series-graph"></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)

Gunakan opsi ini untuk menentukan cara menampilkan data deret waktu Anda. Anda dapat menggunakan penggantian untuk menggabungkan beberapa gaya dalam grafik yang sama.
+ **Garis** — Menampilkan deret waktu sebagai garis pada grafik.
+ **Bar** — Menampilkan deret waktu sebagai serangkaian batang pada grafik, satu untuk setiap titik data.
+ **Poin** — Menampilkan deret waktu sebagai titik pada grafik, satu untuk setiap titik data.

## Penjajaran batang
<a name="v10-time-series-graph-bar"></a>

Atur posisi batang relatif terhadap titik data.di mana titik akan digambar pada grafik. Karena sebuah bar memiliki lebar, maka dapat ditempatkan sebelum, sesudah, atau dipusatkan pada titik. Pilihan untuk opsi ini adalah:
+ ![\[An image showing a bar graph aligned before a point.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/bar-alignment-before.png)**Sebelum** — Bar ditarik sebelum titik. Titik ditempatkan di sudut belakang bar.
+ ![\[An image showing a bar graph aligned around a point.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/bar-alignment-center.png)**Tengah** — Bar digambar di sekitar titik. Intinya ditempatkan di tengah bar. Ini adalah opsi default.
+ ![\[An image showing a bar graph aligned after a point.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/bar-alignment-after.png)**Setelah** — Bar ditarik setelah titik. titik ditempatkan di sudut depan bar.

## Lebar garis
<a name="v10-time-series-graph-linewidth"></a>

Lebar garis adalah slider yang mengontrol ketebalan untuk garis seri atau garis besar untuk bar.

## Isi opacity
<a name="v10-time-series-graph-fill"></a>

Mengatur opasitas warna isian. Isi digunakan, misalnya, untuk menunjukkan area di bawah garis dalam grafik garis, atau sebagai warna batang dalam grafik batang.

## Mode gradien
<a name="v10-time-series-graph-gradient"></a>

Mode gradien menentukan gradien fill, yang didasarkan pada warna seri. Untuk mengubah warna, gunakan opsi bidang skema warna standar. Untuk informasi selengkapnya, lihat [Skema warna](v10-panels-configure-standard-options.md#v10-panels-standard-options-color-scheme).

Opsi mode gradien adalah:
+ **Tidak ada** - Tidak ada pengisian gradien. Ini adalah pengaturan default.
+ **Opacity** — Gradien opasitas di mana opasitas isian meningkat seiring dengan meningkatnya nilai sumbu Y.
+ **Hue** — Gradien halus yang didasarkan pada rona warna seri.
+ **Skema** - Gradien warna yang ditentukan oleh skema warna Anda. Pengaturan ini digunakan untuk area pengisian dan garis. Untuk informasi selengkapnya, lihat [Pilihan warna](v10-time-series-color.md).

Tampilan gradien dipengaruhi oleh pengaturan **Fill opacity**.

## Tampilkan poin
<a name="v10-time-series-graph-showpoints"></a>

Anda dapat mengonfigurasi visualisasi Anda untuk menambahkan titik ke garis atau bilah, dengan opsi berikut.
+ **Otomatis** — Grafana menentukan apakah akan menunjukkan titik berdasarkan kepadatan data. Poin ditampilkan ketika densitasnya rendah.
+ **Selalu** — Poin ditampilkan, terlepas dari kepadatan data.
+ **Jangan pernah** — Jangan tunjukkan poin.

## Ukuran titik
<a name="v10-time-series-graph-pointsize"></a>

Mengatur ukuran titik, dari diameter 1 hingga 40 piksel.

## Interpolasi garis
<a name="v10-time-series-graph-interpolation"></a>

Pilih bagaimana Grafana menginterpolasi garis seri.

![\[Gambar yang menunjukkan berbagai cara menggambar garis antar titik di Grafana.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/line-interpolation.png)


Opsinya adalah:
+ **Linear** — Poin digabungkan dengan garis lurus.
+ **Smooth** - Poin digabungkan dengan garis lengkung yang menghaluskan transisi antar titik.
+ **Langkah sebelumnya** - Garis ditampilkan sebagai langkah antar titik. Poin diberikan pada akhir langkah.
+ **Langkah setelah** - Garis ditampilkan sebagai langkah antar titik. Poin diberikan di awal langkah.

## Gaya garis
<a name="v10-time-series-graph-linestyle"></a>

Atur gaya garis. Untuk mengubah warna, gunakan opsi bidang skema warna standar.

Pilihan untuk gaya garis adalah:
+ **Solid** - Tampilkan garis yang solid. Ini adalah pengaturan default.
+ **Dash** - Menampilkan garis putus-putus. Ketika Anda memilih opsi ini, daftar muncul bagi Anda untuk memilih panjang dan celah (panjang, celah) untuk garis garis. Jarak dasbor diatur ke 10, 10 secara default.
+ **Dots** - Tampilkan garis putus-putus. Saat Anda memilih opsi ini, daftar muncul bagi Anda untuk memilih panjang celah untuk spasi titik. Dot spasi diatur ke 10 secara default.

## Connect nilai null
<a name="v10-time-series-graph-null"></a>

Pilih bagaimana nilai nol, yang merupakan celah dalam data, muncul pada grafik. Nilai nol dapat dihubungkan untuk membentuk garis kontinu, atau diatur ke ambang batas di mana celah dalam data tidak lagi terhubung.

Pilihan untuk cara menghubungkan nilai null adalah:
+ **Tidak pernah** — Titik data deret waktu dengan celah dalam data tidak pernah terhubung.
+ **Selalu** — Titik data deret waktu dengan celah dalam data selalu terhubung.
+ **Ambang batas** — Tentukan ambang batas di mana celah dalam data tidak lagi terhubung. Ini dapat berguna ketika celah yang terhubung dalam data memiliki ukuran yang diketahui atau dalam rentang yang diketahui, dan celah di luar jangkauan seharusnya tidak lagi terhubung.

## Putuskan nilai
<a name="v10-time-series-graph-disconnect"></a>

Pilih apakah akan menambahkan kesenjangan antara nilai dalam data yang memiliki waktu di antara mereka di atas ambang batas yang ditentukan.

Pilihan untuk nilai pemutusan adalah:
+ **Tidak pernah** - Titik data deret waktu tidak pernah terputus.
+ **Ambang batas** — Tentukan ambang batas di atas mana nilai dalam data terputus. Ini dapat berguna ketika nilai yang diinginkan dalam data memiliki ukuran yang diketahui atau dalam rentang yang diketahui, dan nilai di luar rentang ini seharusnya tidak lagi terhubung.

## Seri tumpukan
<a name="v10-time-series-graph-stack"></a>

*Penumpukan* memungkinkan Grafana untuk menampilkan seri di atas satu sama lain. Berhati-hatilah saat menggunakan penumpukan dalam visualisasi karena dapat dengan mudah membuat grafik yang menyesatkan. Untuk membaca lebih lanjut tentang mengapa penumpukan mungkin bukan pendekatan terbaik, lihat [Masalah dengan Penumpukan](https://www.data-to-viz.com/caveat/stacking.html).

Pilihan untuk susun adalah:
+ **Mati** — Mematikan susun seri.
+ **Normal** — Seri tumpukan di atas satu sama lain.
+ **100%** - Tumpuk berdasarkan persentase, di mana semua seri bersama-sama menambahkan hingga 100%.

**Seri susun dalam kelompok**

Anda dapat mengganti perilaku penumpukan untuk menumpuk seri dalam grup. Untuk informasi selengkapnya tentang membuat penggantian, lihat[Konfigurasikan penggantian bidang](v10-panels-configure-overrides.md).

**Untuk menumpuk seri dalam grup**

1. Edit panel dan pilih **Overrides**.

1. Buat penggantian bidang untuk opsi **seri Stack**.

1. Dalam mode susun, pilih **Normal**.

1. Beri nama grup susun tempat Anda ingin seri muncul.

   Opsi nama grup susun hanya tersedia saat Anda membuat penggantian.

## Isi di bawah ini untuk
<a name="v10-time-series-graph-fillbelow"></a>

Opsi **Isi di bawah untuk** mengisi area antara dua seri. Opsi ini hanya tersedia sebagai penggantian seri atau bidang.

Dengan menggunakan opsi ini Anda dapat mengisi area antara dua seri, bukan dari garis seri ke 0. Misalnya, jika Anda memiliki dua seri yang disebut *Max* dan *Min*, Anda dapat memilih seri *Max* dan menggantinya ke **Fill di bawah ini ke** seri *Min*. Ini hanya akan mengisi area antara dua baris seri.

# Opsi sumbu
<a name="v10-time-series-axis"></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)

Opsi di bawah kategori sumbu mengubah cara sumbu x dan y dirender. Beberapa opsi tidak berlaku sampai Anda mengklik di luar kotak opsi bidang yang sedang Anda edit. Anda juga dapat menekan`Enter`.

## Zona waktu
<a name="v10-time-series-axis-timezone"></a>

Atur zona waktu yang diinginkan untuk ditampilkan di sepanjang sumbu x.

## Penempatan
<a name="v10-time-series-axis-placement"></a>

Pilih penempatan sumbu Y. Opsinya adalah:
+ **Otomatis** - Secara otomatis menetapkan sumbu y ke seri. Ketika ada dua atau lebih seri dengan unit yang berbeda, Grafana menetapkan sumbu kiri ke unit pertama, dan sumbu kanan ke unit berikutnya.
+ **Kiri** - Tampilkan semua sumbu y di sisi kiri.
+ **Kanan** - Tampilkan semua sumbu y di sisi kanan.
+ **Tersembunyi** - Sembunyikan semua sumbu.

Untuk menyembunyikan sumbu secara selektif, [tambahkan penggantian bidang yang](v10-panels-configure-overrides.md) menargetkan bidang tertentu.

## Label
<a name="v10-time-series-axis-label"></a>

Tetapkan label teks sumbu y. Jika Anda memiliki lebih dari satu sumbu y, maka Anda dapat menetapkan label yang berbeda menggunakan override.

## Lebar
<a name="v10-time-series-axis-width"></a>

Atur lebar sumbu yang tetap. Secara default, Grafana secara dinamis menghitung lebar sumbu.

Dengan mengatur lebar sumbu, data dengan jenis sumbu yang berbeda dapat berbagi proporsi tampilan yang sama. Pengaturan ini memudahkan Anda untuk membandingkan lebih dari satu data grafik karena sumbu tidak bergeser atau membentang dalam jarak visual satu sama lain.

## Tampilkan garis kisi
<a name="v10-time-series-axis-gridlines"></a>

Atur visibilitas garis kisi sumbu.
+ **Otomatis** - Secara otomatis menampilkan garis kisi berdasarkan kepadatan data.
+ **Aktif** — Selalu tampilkan garis kisi.
+ **Mati** - Jangan pernah menampilkan garis kisi.

## Warna
<a name="v10-time-series-axis-color"></a>

Atur warna sumbu.
+ **Teks** - Mengatur warna berdasarkan warna teks tema.
+ **Seri** - Atur warna berdasarkan warna seri.

## Tampilkan perbatasan
<a name="v10-time-series-axis-border"></a>

Atur visibilitas batas sumbu.

## Penskalaan
<a name="v10-time-series-axis-scale"></a>

Atur bagaimana skala nilai sumbu y.
+ **Linear** — Membagi skala menjadi bagian yang sama.
+ **Logaritmik** — Gunakan skala logaritmik. Ketika Anda memilih opsi ini, daftar muncul bagi Anda untuk memilih skala logaritmik biner (basis 2) atau umum (basis 10).
+ **Symlog — Gunakan skala logaritmik** simetris. Ketika Anda memilih opsi ini, daftar muncul bagi Anda untuk memilih skala logaritmik biner (basis 2) atau umum (basis 10). Opsi ambang batas linier memungkinkan Anda untuk mengatur ambang batas di mana skala berubah dari linier ke logaritmik.

## Nol berpusat
<a name="v10-time-series-axis-centered"></a>

Mengatur sumbu y untuk dipusatkan pada nol.

## Soft min dan soft max
<a name="v10-time-series-axis-softminmax"></a>

Tetapkan opsi **Soft min** atau **soft max** untuk kontrol batas sumbu y yang lebih baik. Secara default, Grafana menetapkan rentang untuk sumbu y secara otomatis berdasarkan kumpulan data.

Pengaturan soft min dan soft max dapat mencegah variasi kecil dalam data diperbesar saat sebagian besar datar. Sebaliknya, nilai min dan maks yang keras membantu mencegah mengaburkan detail yang berguna dalam data dengan memotong lonjakan intermiten melewati titik tertentu.

Untuk menentukan batas keras sumbu y, tetapkan min/max opsi standar. Untuk informasi selengkapnya, lihat [Konfigurasi opsi standar](v10-panels-configure-standard-options.md).

## Transformasi
<a name="v10-time-series-axis-transform"></a>

Gunakan opsi ini untuk mengubah nilai seri tanpa memengaruhi nilai yang ditampilkan di tooltip, menu konteks, atau legenda. Anda memiliki dua opsi transformasi:
+ **Transformasi Y negatif** — Balikkan hasil ke nilai negatif pada sumbu Y.
+ **Konstan** — Tunjukkan nilai pertama sebagai garis konstan.

**catatan**  
Opsi transformasi hanya tersedia sebagai penggantian.

## Tampilkan beberapa sumbu y
<a name="v10-time-series-axis-multiple"></a>

Ada beberapa kasus di mana Anda ingin menampilkan beberapa sumbu y. Misalnya, jika Anda memiliki kumpulan data yang menunjukkan suhu dan kelembaban dari waktu ke waktu, Anda dapat menunjukkan dua sumbu y dengan unit berbeda untuk dua seri ini.

Untuk menampilkan beberapa sumbu y, [tambahkan penggantian bidang](v10-panels-configure-overrides.md#v10-panels-overrides-add-a-field). Ikuti langkah-langkah sebanyak yang diperlukan untuk menambahkan sumbu y sebanyak yang Anda butuhkan.

# Pilihan warna
<a name="v10-time-series-color"></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)

Secara default, grafik menggunakan opsi [skema Warna](v10-panels-configure-standard-options.md#v10-panels-standard-options-color-scheme) standar untuk menetapkan warna seri. Anda juga dapat menggunakan legenda untuk membuka pemilih warna dengan memilih ikon warna seri legenda. Menyetel warna dengan cara ini secara otomatis membuat aturan penggantian yang menetapkan warna tertentu untuk seri tertentu.

Berikut ini adalah opsi tambahan yang dapat Anda gunakan untuk mengganti default warna seri.

## Palet klasik
<a name="v10-time-series-color-classic"></a>

Pengaturan yang paling umum adalah menggunakan **palet Klasik** untuk grafik. Skema ini secara otomatis memberikan warna untuk setiap bidang atau seri berdasarkan urutannya. Jika urutan bidang berubah dalam kueri Anda, warnanya juga berubah. Anda dapat mengonfigurasi warna secara manual untuk bidang tertentu menggunakan aturan penggantian.

## Warna tunggal
<a name="v10-time-series-color-single"></a>

Gunakan mode ini untuk menentukan warna. Anda juga dapat memilih ikon garis berwarna di sebelah setiap seri di Legenda untuk membuka pemilih warna. Ini secara otomatis membuat penggantian baru yang mengatur skema warna menjadi satu warna dan warna yang dipilih.

## Dengan skema warna nilai
<a name="v10-time-series-color-byvalue"></a>

Jika Anda memilih skema warna berdasarkan nilai seperti **Dari ambang batas (berdasarkan nilai)** atau **Green-Yellow-Red (berdasarkan nilai)**, **Seri warna berdasarkan opsi muncul**. Opsi ini mengontrol nilai mana (Terakhir, Min, Maks) yang akan digunakan untuk menetapkan seri warnanya.

## Mode gradien skema
<a name="v10-time-series-color-gradient"></a>

Opsi **mode Gradien** yang terletak di bawah **gaya Grafik** memiliki mode bernama **Skema**. Saat Anda mengaktifkan **Skema**, garis atau bilah menerima warna gradien yang ditentukan dari **skema Warna** yang dipilih.

**Dari ambang batas**

Jika **skema Warna** diatur ke **Dari ambang batas (berdasarkan nilai)** dan **mode Gradien** diatur ke **Skema**, maka warna garis atau batang berubah saat melewati ambang batas yang ditentukan. Anda hanya akan melihat warna yang tepat yang dipilih dalam skema.

**Skema warna gradien**

Menggunakan skema warna gradien *tanpa* mengatur **mode Gradien** ke **Skema**, berarti bahwa warna yang dipilih akan membentuk gradien antara warna yang dipilih, karena nilai dalam seri bergerak di antara ambang batas yang ditetapkan.

# Jejak
<a name="v10-panels-traces"></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)

Visualisasi jejak memungkinkan Anda mengikuti permintaan saat melintasi layanan di infrastruktur Anda. Visualisasi jejak menampilkan data jejak dalam diagram yang memungkinkan Anda menafsirkannya dengan mudah.

Untuk informasi lebih lanjut tentang jejak dan cara menggunakannya, lihat dokumentasi berikut:
+ [Menelusuri di Jelajahi](v10-explore-tracing.md)
+ [Sumber data tempo](tempo-data-source.md)
+ [Memulai dengan Tempo di Dokumentasi](https://grafana.com/docs/tempo/latest/getting-started/) Tempo *Grafana Labs*.

## Menambahkan panel dengan visualisasi penelusuran
<a name="v10-panels-traces-add"></a>

Setelah Anda memiliki data penelusuran yang tersedia di tumpukan Grafana Anda, Anda dapat menambahkan panel pelacakan ke dasbor Grafana Anda.

Menggunakan variabel dasbor,`traceID`, memungkinkan Anda membuat kueri untuk menampilkan jejak tertentu untuk ID jejak yang diberikan. Untuk informasi lebih lanjut tentang variabel dasbor, lihat [dokumentasi Variabel](v10-dash-variables.md). 

**Prasyarat**

Sebelum memulai, Anda memerlukan:
+ Ruang kerja Grafana yang Dikelola Amazon.
+ [Sumber data Tempo](tempo-data-source.md) yang terhubung ke ruang kerja Anda.

Untuk melihat dan menganalisis data jejak di dasbor, Anda perlu menambahkan visualisasi jejak ke dasbor Anda dan menentukan kueri menggunakan editor panel. Kueri menentukan data yang ditampilkan dalam visualisasi. Untuk informasi lebih lanjut tentang editor panel, lihat [dokumentasi Editor Panel](v10-panels-editor-overview.md).

Prosedur ini menggunakan variabel dasbor dan template untuk memungkinkan Anda memasukkan jejak IDs yang kemudian dapat divisualisasikan. Anda akan menggunakan variabel yang disebut `traceId` dan menambahkannya sebagai kueri template.

**Untuk menambahkan kueri visualisasi jejak**

1. Di ruang kerja Anda, buat dasbor baru atau buka dasbor yang ada tempat Anda ingin menambahkan visualisasi jejak.

1. Pilih **Tambahkan visualisasi** dari dasbor baru atau pilih **Tambah Panel** di dasbor yang ada.

1. Pilih sumber data penelusuran yang sesuai.

1. **Di kanan atas editor panel, pilih tab **Visualisasi**, dan pilih Jejak.**

1. Di bawah **opsi Panel**, masukkan **Judul** untuk panel jejak Anda. Untuk informasi selengkapnya tentang editor panel, lihat[Konfigurasikan opsi panel](v10-panels-configure-panel-options.md).

1. Di editor kueri, pilih tab jenis kueri **TraceQL**.

1.  Masukkan `${traceId}` di bidang query TraceQL untuk membuat variabel dasbor. Variabel ini digunakan sebagai query template.

1. Pilih **Terapkan** di editor panel untuk menambahkan panel ke dasbor.

1. Buka **Pengaturan** dasbor dan tambahkan variabel baru yang disebut`traceId`, dari tipe variabel **Kustom**, berikan label, jika diperlukan. Pilih **Terapkan** untuk menambahkan variabel ke dasbor.

1. Verifikasi bahwa panel berfungsi dengan menggunakan ID jejak yang valid untuk sumber data yang digunakan untuk panel jejak dan mengedit ID di variabel dasbor.

## Menambahkan traceQL dengan visualisasi tabel
<a name="v10-panels-traces-traceql"></a>

Meskipun Anda dapat menambahkan visualisasi jejak ke dasbor, harus menambahkan jejak secara manual IDs sebagai variabel dasbor tidak praktis. Lebih berguna untuk dapat menggunakan kueri TraceQL untuk mencari jenis jejak tertentu dan kemudian memilih jejak yang sesuai dari hasil yang cocok.

**Prasyarat**

Prosedur ini mengasumsikan Anda telah menyelesaikan prosedur sebelumnya.

**Untuk menambahkan traceQL dengan visualisasi tabel**

1. Di dasbor yang sama tempat Anda menambahkan visualisasi jejak, pilih **Tambahkan panel** untuk menambahkan panel visualisasi baru.

1. Pilih sumber data jejak yang sama yang Anda gunakan di bagian sebelumnya.

1. **Di kanan atas editor panel, pilih tab **Visualisasi**, lalu pilih Tabel.**

1. Di editor kueri, pilih tab **TraceQL**.

1. Di bawah **opsi Panel**, masukkan **Judul** untuk panel jejak Anda.

1. Tambahkan kueri TraceQL yang sesuai untuk mencari jejak yang ingin Anda visualisasikan di dasbor. Misalnya, berikut adalah kueri statis sederhana dari server yang disebut*my-server*.

   ```
   { .service.name = "my-server" && .http.status_code=500 }
   ```

   Anda dapat menulis kueri TraceQL sebagai kueri template untuk memanfaatkan variabel dasbor lainnya, jika ada. Ini memungkinkan Anda membuat kueri dinamis berdasarkan variabel-variabel ini.

Ketika hasil dikembalikan dari kueri, hasilnya ditampilkan dalam tabel panel.

Hasil dalam visualisasi jejak mencakup tautan ke halaman **Jelajahi** yang membuat jejak. Anda dapat menambahkan tautan lain ke jejak di tabel yang mengisi variabel `traceId` dasbor saat dipilih, sehingga jejak divisualisasikan di dasbor yang sama.

Untuk membuat satu set link data di panel, gunakan prosedur berikut.

**Untuk menggunakan variabel untuk menambahkan tautan lain ke jejak**

1. Di menu sisi kanan, di bawah **Tautan data**, pilih **Tambahkan tautan**.

1. Tambahkan **Judul** untuk tautan data.

1. Temukan jalur ke dasbor dengan melihat di bilah alamat browser Anda saat dasbor lengkap sedang dirender. Karena ini adalah tautan ke dasbor di tumpukan Grafana yang sama, hanya jalur dasbor yang diperlukan.

   Misalnya, jika jalur Anda adalah:

   ```
   https://g-example.grafana-workspace.us-east-1.amazonaws.com/d/1234abcd5/my-dashboard?orgId=1
   ```

   Maka jalur ke dasbor adalah:

   ```
   /d/1234abcd5/my-dashboard?orgId=1
   ```

1. Di bidang **URL**, buat referensi mandiri ke dasbor yang berisi kedua panel. Referensi diri ini menggunakan nilai jejak yang dipilih dalam tabel untuk mengisi variabel dasbor. Gunakan jalur untuk dasbor dari langkah sebelumnya dan kemudian isi nilai `traceId` menggunakan hasil yang dipilih dari tabel TraceQL. ID jejak diekspos menggunakan bidang `traceID` data dalam hasil yang dikembalikan, jadi gunakan itu sebagai nilai untuk variabel dasbor. Contoh:

   ```
   /d/1234abcd5/my-dashboard?orgId=1&var-traceId=${__data.fields["traceID"]}
   ```

1. Pilih **Simpan** untuk menyimpan tautan data.

1. Pilih **Terapkan** dari editor panel untuk menerapkan panel ke dasbor.

1. Simpan dasbor.

Anda sekarang harus melihat daftar jejak yang cocok dalam visualisasi tabel. **Saat memilih bidang **traceID** **atau** SpanID akan memberi Anda opsi untuk membuka halaman Jelajahi untuk memvisualisasikan jejak atau mengikuti tautan data, memilih bidang lain (`Start time`seperti`Name`,, `Duration` atau) secara otomatis mengikuti tautan data, mengisi variabel dasbor, dan kemudian menunjukkan jejak yang relevan di `traceId` panel jejak.** 

# Tren
<a name="v10-panels-trend"></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)

Visualisasi tren harus digunakan untuk kumpulan data yang memiliki urutan, numerik X yang bukan waktu. Beberapa contoh adalah grafik fungsi, rpm/torque kurva, hubungan penawaran/permintaan, dan plot elevasi atau detak jantung di sepanjang jalur balapan (dengan x sebagai jarak atau durasi dari awal).

Visualisasi tren mendukung semua gaya visual dan opsi yang tersedia dalam [visualisasi deret waktu dengan pengecualian](v10-panels-time-series.md) berikut:
+ Tidak ada anotasi atau wilayah waktu
+ Tidak ada kursor bersama (atau crosshair)
+ Tidak ada sumbu x multi-zona waktu
+ Tidak ada kemampuan untuk mengubah rentang waktu dasbor melalui pemilihan seret

**X Pemilihan bidang**

Gunakan opsi ini untuk memilih bidang yang berisi peningkatan nilai numerik.

 Misalnya, Anda dapat mewakili tenaga mesin dan torsi versus kecepatan di mana kecepatan diplot pada sumbu x dan daya dan torsi diplot pada sumbu y.

# Grafik XY
<a name="v10-panels-xychart"></a>

Grafik XY menyediakan cara untuk memvisualisasikan nilai x dan y arbitrer dalam grafik sehingga Anda dapat dengan mudah menunjukkan hubungan antara dua variabel. Grafik XY biasanya digunakan untuk membuat plot pencar. Anda juga dapat menggunakannya untuk membuat bagan gelembung, di mana nilai bidang menentukan ukuran setiap gelembung.

![\[Gambar yang menunjukkan contoh visualisasi bagan XY di Grafana.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/xy-chart-example.png)


## Format data yang didukung
<a name="v10-panels-xychart-formats"></a>

Anda dapat menggunakan semua jenis data tabular dengan setidaknya dua bidang numerik dalam bagan XY. Jenis visualisasi ini tidak memerlukan data waktu.

## Opsi panel
<a name="v10-panels-xychart-paneloptions"></a>

Di bagian **Opsi panel** panel panel editor, Anda mengatur opsi dasar seperti judul dan deskripsi panel. Anda juga dapat mengonfigurasi panel berulang di bagian ini. Untuk informasi selengkapnya, lihat [Konfigurasikan opsi panel](v10-panels-configure-panel-options.md).

## Opsi grafik XY
<a name="v10-panels-xychart-options"></a>

**Pemetaan seri**

Tetapkan bagaimana data seri dipetakan dalam bagan.
+ **Otomatis** - Secara otomatis menghasilkan seri dari semua frame data yang tersedia (atau dataset). Anda dapat memfilter untuk memilih hanya satu bingkai.
+ **Manual** — Secara eksplisit mendefinisikan seri dengan memilih dari frame data yang tersedia.

Bergantung pada pilihan pemetaan seri Anda, opsi **Frame**, **X-field**, dan **Y-field berbeda**. Bagian pemetaan seri Otomatis dan Manual menjelaskan opsi yang berbeda ini.

**Opsi pemetaan seri otomatis**

Saat Anda memilih **Otomatis** sebagai mode pemetaan seri Anda, opsi berikut sudah dikonfigurasi sebelumnya, tetapi Anda juga dapat mendefinisikannya sendiri.
+ **Frame** - Secara default bagan XY menampilkan semua frame data. Anda dapat memfilter untuk memilih hanya satu bingkai.
+ **X-field** - Pilih bidang mana yang diwakili X. Secara default, t nya adalah bidang angka pertama di setiap frame data.
+ **Y-field** — Setelah X-field diatur, secara default, semua bidang angka yang tersisa dalam frame data ditetapkan sebagai Y-field. Anda dapat menggunakan opsi ini untuk secara eksplisit memilih bidang mana yang akan digunakan untuk Y.

  Rangkaian bagan dihasilkan dari bidang-Y. Untuk membuat perubahan pada seri dalam bagan XY, lakukan penggantian ke bidang Y. Bidang apa pun yang Anda gunakan di bidang Ukuran atau bidang Warna tidak menghasilkan rangkaian.

  Anda juga dapat menggunakan penggantian untuk mengecualikan bidang-Y satu per satu. Untuk melakukannya, tambahkan penggantian dengan properti berikut untuk setiap bidang Y yang ingin dihapus:
  + Tipe ganti: **Bidang dengan nama**
  + Mengganti properti: **Seri> Sembunyikan di area**
  + Daerah: **Viz**

**Opsi pemetaan seri manual**

Ketika Anda memilih **Manual** sebagai mode seri Anda, Anda dapat menambahkan, mengedit, dan menghapus seri. Untuk mengelola seri, pilih bidang **Seri**. Untuk mengganti nama seri, pilih nama seri.

Dalam mode **Manual**, Anda harus mengatur opsi berikut:
+ **Frame** — Pilih frame data atau dataset Anda. Anda dapat menambahkan bingkai sebanyak yang Anda inginkan.
+ **X-field** - Pilih bidang mana yang diwakili X.
+ **Y-field** - Pilih bidang yang mewakili Y.

**Bidang ukuran**

Gunakan opsi ini untuk mengatur nilai bidang mana yang mengontrol ukuran titik dalam bagan. Nilai ini relatif terhadap min dan maks dari semua nilai dalam bingkai data.

Ketika Anda memilih opsi ini, Anda kemudian dapat mengatur opsi ukuran titik min dan maks.

**Bidang warna**

Gunakan opsi ini untuk mengatur nilai bidang mana yang mengontrol warna titik dalam bagan. Untuk menggunakan opsi nilai warna di bawah **opsi Standar**, Anda harus mengatur bidang ini.

Biasanya, opsi ini digunakan ketika Anda hanya memiliki satu seri yang ditampilkan di bagan.

**Tampilkan**

Tetapkan bagaimana nilai direpresentasikan dalam visualisasi.
+ **Poin** - Menampilkan nilai sebagai poin. Saat Anda memilih opsi ini, opsi ukuran titik juga ditampilkan.
+ **Garis** - Tambahkan garis di antara nilai. Saat Anda memilih opsi ini, gaya garis dan opsi lebar garis juga ditampilkan.
+ **Keduanya** - Menampilkan titik dan garis.

**Ukuran titik**

Mengatur ukuran semua titik dalam bagan, dari satu hingga 100 piksel dengan diameter. Ukuran default adalah lima piksel. Anda dapat mengatur penggantian untuk mengatur ukuran piksel berdasarkan seri (Y-field).

**Ukuran titik Min/Max**

Gunakan optinos ini untuk mengontrol ukuran titik minimum atau maksimum saat Anda telah mengatur opsi **bidang Ukuran**. Anda dapat mengganti opsi ini untuk seri tertentu.

**Gaya garis**

Atur gaya garis. Untuk mengubah warna, gunakan opsi bidang skema warna standar.
+ **Solid** - Menampilkan garis yang solid. Ini adalah pengaturan default.
+ **Dash** - Menampilkan garis putus-putus. Saat Anda memilih opsi ini, daftar drop-down ditampilkan di mana Anda dapat memilih pengaturan panjang dan celah untuk garis garis. Secara default, panjang dan celah diatur ke`10, 10`.
+ **Dots** - Tampilkan garis putus-putus. Saat Anda memilih opsi ini, daftar drop-down ditampilkan di mana Anda dapat memilih spasi titik. Secara default, spasi titik diatur ke `0, 10` (angka pertama mewakili panjang titik, dan selalu nol).

**Lebar garis**

Mengatur lebar garis, dalam piksel.

## Opsi tooltip
<a name="v10-panels-xychart-tooltipoptions"></a>

Opsi tooltip mengontrol hamparan informasi yang muncul saat Anda mengarahkan kursor ke titik data dalam grafik.

**Mode Tooltip**
+ **Single** - Tooltip hover hanya menampilkan satu seri, yang Anda arahkan.
+ **Tersembunyi** — Jangan tampilkan tooltip saat Anda berinteraksi dengan visualisasi.

Gunakan override untuk menyembunyikan seri individual dari tooltip.

**Tinggi maks**

Atur ketinggian maksimum kotak tooltip. Defautl adalah 600 piksel.

## Opsi legenda
<a name="v10-panels-xychart-legendoptions"></a>

Opsi legenda mengontrol nama seri dan statistik yang muncul di bawah atau di sebelah kanan grafik. Untuk informasi lebih lanjut tentang legenda, lihat[Konfigurasikan legenda](v10-panels-configure-legend.md).

**Visibilitas**

Alihkan sakelar untuk mengaktifkan atau menonaktifkan legenda.

**Modus**

Gunakan pengaturan ini untuk menentukan bagaimana legenda muncul dalam visualisasi Anda.
+ **Daftar** - Menampilkan legenda sebagai daftar. Ini adalah mode tampilan default legenda.
+ **Tabel** - Menampilkan legenda sebagai tabel.

**Penempatan**

Pilih tempat untuk menampilkan legenda.
+ **Bawah** - Di bawah grafik.
+ **Kanan** - Di sebelah kanan grafik.

**Nilai-nilai**

Pilih [perhitungan standar](v10-panels-calculation-types.md) mana yang akan ditampilkan dalam legenda. Anda dapat memiliki lebih dari satu.

**Lebar**

Kontrol seberapa lebar legenda ketika ditempatkan di sisi kanan visualisasi. Opsi ini hanya ditampilkan jika Anda mengatur penempatan legenda ke **Kanan**.

## Opsi sumbu
<a name="v10-panels-xychart-axis"></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)

Opsi di bawah kategori sumbu mengubah cara sumbu x dan y dirender. Beberapa opsi tidak berlaku sampai Anda mengklik di luar kotak opsi bidang yang sedang Anda edit. Anda juga dapat menekan`Enter`.

**Penempatan (sumbu y)**

Pilih penempatan sumbu Y. Opsinya adalah:
+ **Otomatis** - Secara otomatis menetapkan sumbu y ke seri. Ketika ada dua atau lebih seri dengan unit yang berbeda, Grafana menetapkan sumbu kiri ke unit pertama, dan sumbu kanan ke unit berikutnya.
+ **Kiri** - Tampilkan semua sumbu y di sisi kiri.
+ **Kanan** - Tampilkan semua sumbu y di sisi kanan.
+ **Tersembunyi** - Sembunyikan semua sumbu.

Untuk menyembunyikan sumbu secara selektif, [tambahkan penggantian bidang yang](v10-panels-configure-overrides.md) menargetkan bidang tertentu.

**Label**

Tetapkan label teks sumbu y. Jika Anda memiliki lebih dari satu sumbu y, maka Anda dapat menetapkan label yang berbeda menggunakan override.

**Lebar**

Atur lebar sumbu yang tetap. Secara default, Grafana secara dinamis menghitung lebar sumbu.

Dengan mengatur lebar sumbu, data dengan jenis sumbu yang berbeda dapat berbagi proporsi tampilan yang sama. Pengaturan ini memudahkan Anda untuk membandingkan lebih dari satu data grafik karena sumbu tidak bergeser atau membentang dalam jarak visual satu sama lain.

**Tampilkan garis kisi**

Atur visibilitas garis kisi sumbu.
+ **Otomatis** - Secara otomatis menampilkan garis kisi berdasarkan kepadatan data.
+ **Aktif** — Selalu tampilkan garis kisi.
+ **Mati** - Jangan pernah menampilkan garis kisi.

**Warna**

Atur warna sumbu.
+ **Teks** - Mengatur warna berdasarkan warna teks tema.
+ **Seri** - Atur warna berdasarkan warna seri.

**Tampilkan perbatasan**

Atur visibilitas batas sumbu.

**Skala**

Atur bagaimana skala nilai sumbu y.
+ **Linear** — Membagi skala menjadi bagian yang sama.
+ **Logaritmik** — Gunakan skala logaritmik. Ketika Anda memilih opsi ini, daftar muncul bagi Anda untuk memilih skala logaritmik biner (basis 2) atau umum (basis 10).
+ **Symlog — Gunakan skala logaritmik** simetris. Ketika Anda memilih opsi ini, daftar muncul bagi Anda untuk memilih skala logaritmik biner (basis 2) atau umum (basis 10). Opsi ambang batas linier memungkinkan Anda untuk mengatur ambang batas di mana skala berubah dari linier ke logaritmik.

*Nol berpusat*

Mengatur sumbu y untuk dipusatkan pada nol.

**Soft min dan soft max**

Tetapkan opsi **Soft min** atau **soft max** untuk kontrol batas sumbu y yang lebih baik. Secara default, Grafana menetapkan rentang untuk sumbu y secara otomatis berdasarkan kumpulan data.

Pengaturan soft min dan soft max dapat mencegah variasi kecil dalam data diperbesar saat sebagian besar datar. Sebaliknya, nilai min dan maks yang keras membantu mencegah mengaburkan detail yang berguna dalam data dengan memotong lonjakan intermiten melewati titik tertentu.

Untuk menentukan batas keras sumbu y, tetapkan min/max opsi standar. Untuk informasi selengkapnya, lihat [Konfigurasi opsi standar](v10-panels-configure-standard-options.md).

**Transformasi**

Gunakan opsi ini untuk mengubah nilai seri tanpa memengaruhi nilai yang ditampilkan di tooltip, menu konteks, atau legenda. Anda memiliki dua opsi transformasi:
+ **Transformasi Y negatif** — Balikkan hasil ke nilai negatif pada sumbu Y.
+ **Konstan** — Tunjukkan nilai pertama sebagai garis konstan.

**catatan**  
Opsi transformasi hanya tersedia sebagai penggantian.

**Tampilkan beberapa sumbu y**

Ada beberapa kasus di mana Anda ingin menampilkan beberapa sumbu y. Misalnya, jika Anda memiliki kumpulan data yang menunjukkan suhu dan kelembaban dari waktu ke waktu, Anda dapat menunjukkan dua sumbu y dengan unit berbeda untuk dua seri ini.

Untuk menampilkan beberapa sumbu y, [tambahkan penggantian bidang](v10-panels-configure-overrides.md#v10-panels-overrides-add-a-field). Ikuti langkah-langkah sebanyak yang diperlukan untuk menambahkan sumbu y sebanyak yang Anda butuhkan.

## Opsi standar
<a name="v10-panels-xychart-standard"></a>

**Opsi standar** di editor panel memungkinkan Anda mengubah cara data bidang ditampilkan dalam visualisasi Anda. Saat Anda menetapkan opsi standar, perubahan diterapkan ke semua bidang atau seri. Untuk kontrol yang lebih terperinci atas tampilan bidang, lihat. [Konfigurasikan penggantian bidang](v10-panels-configure-overrides.md)

Anda dapat menyesuaikan opsi standar berikut:
+ **Bidang min/maks** - Aktifkan **Bidang min/maks agar** Grafana menghitung min atau maks setiap bidang secara individual, berdasarkan nilai minimum atau maksimum bidang.
+ **Skema warna** - Mengatur satu atau beberapa warna untuk seluruh visualisasi Anda.

Untuk informasi selengkapnya, lihat [Konfigurasikan opsi standar](v10-panels-configure-standard-options.md).

## Tautan data
<a name="v10-panels-xychart-datalinks"></a>

Tautan data memungkinkan Anda menautkan ke panel, dasbor, dan sumber daya eksternal lainnya sambil mempertahankan konteks panel sumber. Anda dapat membuat tautan yang menyertakan nama seri atau bahkan nilai di bawah kursor.

Untuk setiap tautan data, atur opsi berikut:
+ **Judul**
+ **URL**
+ **Buka di tab baru**

Untuk informasi selengkapnya, lihat [Konfigurasikan tautan data](v10-panels-configure-data-links.md).

## Penggantian lapangan
<a name="v10-panels-xychart-fieldoverrides"></a>

Override memungkinkan Anda untuk menyesuaikan pengaturan visualisasi untuk bidang atau seri tertentu. Saat menambahkan aturan penggantian, Anda dapat menargetkan kumpulan bidang tertentu dan menentukan beberapa opsi untuk bagaimana bidang tersebut ditampilkan.

Pilih dari salah satu opsi penggantian berikut:
+ **Bidang dengan nama** - Pilih bidang dari daftar semua bidang yang tersedia.
+ **Bidang dengan nama yang cocok dengan regex** - Tentukan bidang yang akan diganti dengan ekspresi reguler.
+ **Bidang dengan tipe** - Pilih bidang berdasarkan jenis, seperti string, numerik, atau waktu.
+ **Bidang yang dikembalikan oleh kueri** - Pilih semua bidang yang dikembalikan oleh kueri tertentu.
+ **Bidang dengan nilai** - Pilih semua bidang yang dikembalikan oleh kondisi peredam yang ditentukan, seperti **Min**, **Maks**, **Hitungan**, atau **Total**.

Lihat informasi yang lebih lengkap di [Konfigurasikan penggantian bidang](v10-panels-configure-overrides.md).

# Jelajahi di Grafana versi 10
<a name="v10-explore"></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)

UI dasbor Grafana menyediakan fungsionalitas untuk membangun dasbor untuk visualisasi. *Jelajahi* strip dari opsi dasbor dan panel sehingga Anda dapat fokus pada kueri. Ini membantu Anda mengulangi sampai Anda memiliki kueri yang berfungsi dan kemudian Anda dapat membangun dasbor dari kueri.

**catatan**  
Jika Anda hanya ingin menjelajahi data Anda dan tidak ingin membuat dasbor, maka Jelajahi membuat ini jauh lebih mudah. Jika sumber data Anda mendukung data grafik dan tabel, Jelajahi menampilkan hasilnya baik sebagai grafik maupun tabel. Ini memungkinkan Anda untuk melihat tren dalam data dan detail lebih lanjut secara bersamaan.

Halaman ini akan membantu Anda mulai menjelajahi data Anda. Topik berikut memberi Anda detail lebih lanjut tentang fitur dan kegunaan spesifik untuk Jelajahi.
+ [Manajemen kueri di Jelajahi](v10-explore-manage.md)
+ [Log di Jelajahi](v10-explore-logs.md)
+ [Menelusuri Jelajahi](v10-explore-tracing.md)
+ [Editor korelasi di Jelajahi](v10-explore-correlations.md)
+ [Inspector di Explore](v10-explore-inspector.md)

## Mulai menjelajah
<a name="v10-explore-start"></a>

**catatan**  
Untuk mengakses Explore, Anda harus memiliki editor atau peran administrator.

**Untuk mengakses Jelajahi**

1. Di ruang kerja Grafana Anda, pilih item menu Jelajahi dari bilah menu sebelah kiri.

   Tab Jelajahi kosong terbuka.

   Sebagai alternatif, untuk memulai dengan kueri yang ada di panel, pilih opsi Jelajahi dari menu Panel. Ini membuka tab Jelajahi dengan kueri dari panel dan memungkinkan Anda untuk mengubah atau mengulangi kueri di luar dasbor Anda.

1. Pilih sumber data Anda dari dropdown di kiri atas.

   Anda juga dapat memilih **Buka pemilih sumber data lanjutan** untuk melihat opsi lainnya, termasuk menambahkan sumber data (hanya untuk Admin).

1. Tulis kueri menggunakan editor kueri yang disediakan oleh sumber data yang dipilih.

   Untuk detail selengkapnya tentang kueri, lihat[Kueri dan transformasi data](v10-panels-query-xform.md).

1. Jalankan kueri menggunakan tombol di sudut kanan atas.

## Pisahkan dan bandingkan
<a name="v10-explore-compare"></a>

Tampilan terpisah menyediakan cara mudah untuk membandingkan visualisasi side-by-side atau melihat data terkait bersama-sama pada satu halaman.

**Buka bagian atas tampilan split**

1. Dalam tampilan Jelajahi, pilih tombol **Split** untuk menduplikasi kueri saat ini dan membagi halaman menjadi dua side-by-side kueri.
**catatan**  
Dimungkinkan untuk memilih sumber data lain untuk kueri baru yang, misalnya, memungkinkan Anda membandingkan kueri yang sama untuk dua server yang berbeda atau membandingkan lingkungan pementasan dengan lingkungan produksi.

   Dalam tampilan terpisah, pemilih waktu untuk kedua panel dapat ditautkan (jika Anda mengubah satu, yang lain juga akan diubah) dengan memilih tombol sinkronisasi waktu yang dilampirkan ke salah satu pemilih waktu. Menautkan pemetik waktu membuat waktu mulai dan akhir dari kueri tampilan terpisah tetap sinkron. Ini memastikan bahwa Anda melihat interval waktu yang sama di kedua panel terpisah.

1. Untuk menutup kueri yang baru dibuat, pilih tombol **Close Split**.

## Garis besar konten
<a name="v10-explore-outline"></a>

Garis besar konten adalah bilah navigasi samping yang melacak kueri dan visualisasi yang Anda buat di Jelajahi. Ini memungkinkan Anda untuk menavigasi di antara mereka dengan cepat.

Garis besar konten juga berfungsi dalam tampilan terpisah. Saat Anda berada dalam tampilan terpisah, garis besar konten dibuat untuk setiap panel.

**Untuk membuka garis besar konten**

1. Pilih tombol **Outline** di sudut kiri atas layar **Jelajahi**.

1. Pilih ikon panel apa pun di garis besar konten untuk menavigasi ke panel itu.

## Bagikan Jelajahi URLs
<a name="v10-explore-shareurl"></a>

Saat menggunakan Jelajahi, URL di bilah alamat browser diperbarui saat Anda membuat perubahan pada kueri. Anda dapat membagikan atau menandai URL ini.

**catatan**  
Jelajahi dapat menghasilkan relatif lama URLs. Anda juga dapat membuat dan membagikan [tautan singkat](#v10-explore-share) jika URL terlalu panjang untuk alat Anda.

**Menghasilkan Jelajahi URLs dari alat eksternal**

Karena Jelajahi URLs memiliki struktur yang ditentukan, Anda dapat membuat URL dari alat eksternal dan membukanya di Grafana. Struktur url adalah:

```
http://<workspace_url>/explore?panes=<panes>&schemaVersion=<schema_version>&orgId=<org_id>
```

di mana:
+ `org_id`adalah ID organisasi
+ `schema_version`adalah versi skema (harus disetel ke versi terbaru, yaitu`1`.
+ `panes`adalah objek panel JSON yang dikodekan url, di mana setiap kunci adalah ID panel dan setiap nilai adalah objek yang cocok dengan skema berikut:

  ```
  {
    datasource: string; // the pane's root datasource UID, or `-- Mixed --` for mixed datasources
    queries: {
      refId: string; // an alphanumeric identifier for this query, must be unique within the pane, i.e. "A", "B", "C", etc.
      datasource: {
        uid: string; // the query's datasource UID ie: "AD7864H6422"
        type: string; // the query's datasource type-id, i.e: "loki"
      }
      // ... any other datasource-specific query parameters
    }[]; // array of queries for this pane
    range: {
      from: string; // the start time, in milliseconds since epoch
      to: string; // the end time, in milliseconds since epoch
    }
  }
  ```
**catatan**  
`to`Bidang `from` dan juga menerima rentang relatif seperti yang dijelaskan dalam [Pengaturan rentang waktu dasbor](v10-dash-using-dashboards.md#v10-dash-setting-dashboard-time-range) topik.

## Bagikan tautan singkat
<a name="v10-explore-share"></a>

Kemampuan Share shortened link memungkinkan Anda membuat format /goto/:uid yang lebih kecil dan lebih sederhana URLs daripada menggunakan lebih lama dengan parameter kueri. URLs Untuk membuat tautan singkat ke hasil kueri, pilih opsi **Bagikan** di bilah alat Jelajahi. Tautan singkat yang tidak pernah digunakan akan otomatis dihapus setelah tujuh (7) hari. Jika tautan digunakan setidaknya sekali, itu tidak akan dihapus.

**Berbagi tautan singkat dengan waktu absolut**

Tautan pendek memiliki dua opsi: menjaga waktu relatif (misalnya, dari dua jam yang lalu ke waktu saat ini) atau waktu absolut (misalnya, dari jam 8 pagi hingga 10 pagi). Berbagi tautan singkat secara default akan menyalin rentang waktu yang dipilih, relatif atau absolut. Memilih tombol tarik-turun di sebelah tombol bagikan tautan pendek dan memilih salah satu opsi di bawah **Tautan URL Sinkronisasi Waktu akan memungkinkan Anda membuat tautan** pendek dengan waktu absolut, yang berarti siapa pun yang menerima tautan akan melihat data yang sama yang Anda lihat, bahkan jika mereka membuka tautan di lain waktu. Opsi ini tidak akan memengaruhi rentang waktu yang dipilih dalam tampilan Jelajahi Anda.

# Manajemen kueri di Jelajahi
<a name="v10-explore-manage"></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 mengelola kueri yang telah Anda buat di Jelajahi, termasuk riwayat kueri yang telah Anda jalankan, dan kueri yang telah Anda bintangi.

## Riwayat kueri
<a name="v10-explore-manage-history"></a>

Riwayat kueri adalah daftar kueri yang Anda gunakan di Jelajahi. Riwayat disimpan dalam database Grafana dan tidak dibagikan dengan pengguna lain. Periode retensi untuk kueri dalam sejarah adalah dua minggu. Kueri yang berusia lebih dari dua minggu akan dihapus secara otomatis. Untuk membuka dan berinteraksi dengan riwayat Anda, pilih tombol **Riwayat kueri** di Jelajahi.

**catatan**  
Kueri berbintang (favorit) tidak tunduk pada periode retensi dua minggu dan tidak dihapus.

## Lihat riwayat kueri
<a name="v10-explore-manage-history-view"></a>

Riwayat kueri memungkinkan Anda melihat riwayat kueri Anda. Untuk setiap kueri individu, Anda dapat:
+ Jalankan kueri.
+ Buat and/or edit komentar.
+ Salin kueri ke clipboard.
+ Salin tautan singkat dengan kueri ke clipboard.
+ Bintang (favorit) kueri.

## Kelola kueri favorit
<a name="v10-explore-manage-history-favorites"></a>

Semua kueri yang telah dibintangi di tab Riwayat kueri ditampilkan di tab Berbintang. Ini memungkinkan Anda untuk mengakses kueri favorit Anda lebih cepat dan menggunakan kembali kueri ini tanpa mengetiknya dari awal.

## Menyortir riwayat kueri
<a name="v10-explore-manage-history-sort"></a>

Secara default, riwayat kueri menunjukkan kueri terbaru kepada Anda. Anda dapat mengurutkan riwayat Anda berdasarkan tanggal atau dengan nama sumber data dalam urutan naik atau turun.

**Untuk mengurutkan riwayat kueri Anda**

1. Pilih kolom **Urutkan kueri menurut**.

1. Pilih salah satu opsi berikut:
   + **Terbaru pertama**
   + **Tertua pertama**

## Memfilter riwayat kueri
<a name="v10-explore-manage-history-filter"></a>

Anda dapat memfilter riwayat kueri Anda di Riwayat kueri dan tab Berbintang ke sumber data tertentu.

**Untuk memfilter riwayat ke sumber data**

1. Pilih bidang **Filter kueri untuk sumber data tertentu**.

1. Pilih sumber data yang ingin Anda filter histori Anda. Anda dapat memilih beberapa sumber data.

**catatan**  
Kueri yang dijalankan menggunakan sumber data Campuran hanya akan muncul saat memfilter untuk Campuran, dan bukan saat memfilter berdasarkan sumber data masing-masing.

Di tab **Query history**, Anda juga dapat memfilter kueri berdasarkan tanggal menggunakan slider:
+ Gunakan slider vertikal untuk memfilter kueri berdasarkan tanggal.
+ Sesuaikan tanggal mulai dengan menyeret pegangan bawah.
+ Sesuaikan tanggal akhir dengan menyeret pegangan atas.

## Mencari dalam riwayat kueri
<a name="v10-explore-manage-history-search"></a>

Anda dapat mencari di riwayat Anda di seluruh kueri dan komentar Anda. Pencarian dimungkinkan untuk kueri di tab Query history dan tab Starred.

**Untuk mencari di riwayat kueri**

1. Pilih bidang **Permintaan pencarian**.

1. Masukkan istilah yang Anda cari ke dalam bidang pencarian.

## Pengaturan riwayat kueri
<a name="v10-explore-manage-history-settings"></a>

Anda dapat menyesuaikan riwayat kueri di tab Pengaturan. Opsi dijelaskan dalam tabel berikut.


| Pengaturan | Nilai default | 
| --- | --- | 
| Ubah tab aktif default | Tab riwayat kueri | 

**catatan**  
Pengaturan riwayat kueri bersifat global, dan diterapkan ke kedua panel dalam mode terpisah.

# Log di Jelajahi
<a name="v10-explore-logs"></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)

Jelajahi memungkinkan Anda untuk menyelidiki log Anda di sumber data yang berbeda, termasuk:
+ [OpenSearch](using-opensearch-in-AMG.md)
+ [Amazon CloudWatch](using-amazon-cloudwatch-in-AMG.md)
+ [InfluxDB](using-influxdb-in-AMG.md)
+ [Loki](using-loki-in-AMG.md)

Selama pemantauan infrastruktur dan respons insiden, Anda dapat menggali lebih dalam metrik dan log untuk menemukan penyebabnya. Jelajahi juga memungkinkan Anda untuk mengkorelasikan log dengan sinyal telemetri lain seperti metrik, jejak, atau profil, dengan melihatnya. side-by-side

Hasil kueri log ditampilkan sebagai garis log individual dan sebagai grafik yang menunjukkan volume log untuk periode waktu yang dipilih.

## Volume log
<a name="v10-explore-logs-volume"></a>

Saat bekerja dengan sumber data yang mendukung volume log rentang penuh, Jelajahi secara otomatis menampilkan grafik yang menunjukkan distribusi log untuk semua kueri log yang dimasukkan. Fitur ini saat ini didukung oleh OpenSearch dan sumber data Loki.

**catatan**  
Di Loki, volume log rentang penuh ini dirender oleh kueri metrik yang bisa mahal tergantung pada rentang waktu yang ditanyakan. Kueri ini bisa sangat menantang untuk diproses untuk instalasi Loki yang lebih kecil. Untuk mengurangi ini, Anda dapat menggunakan proxy seperti [nginx](https://www.nginx.com/) di depan Loki untuk mengatur batas waktu khusus (misalnya, 10 detik) untuk kueri ini. Kueri histogram volume log dapat diidentifikasi dengan mencari kueri dengan header HTTP `X-Query-Tags` dengan nilai`Source=logvolhist`; header ini ditambahkan oleh Grafana ke semua kueri histogram volume log.

Jika sumber data tidak mendukung pemuatan volume log rentang penuh, model log menghitung deret waktu dengan menghitung baris log dan mengaturnya ke dalam ember berdasarkan interval waktu yang dihitung secara otomatis. Stempel waktu dari baris log pertama digunakan untuk menambatkan awal volume log dalam hasil. **Akhir dari deret waktu berlabuh ke rentang To picker waktu.** Dengan cara ini, Anda masih dapat menganalisis dan memvisualisasikan data log secara efisien bahkan ketika sumber data tidak menawarkan dukungan jangkauan penuh.

## Beberapa catatan
<a name="v10-explore-logs-overview"></a>

Di bagian berikut, Anda akan menemukan penjelasan terperinci tentang cara memvisualisasikan dan berinteraksi dengan log individu di Jelajahi.

## Navigasi log
<a name="v10-explore-logs-navigation"></a>

Navigasi log, di sisi kanan baris log, dapat digunakan untuk dengan mudah meminta log tambahan. Anda dapat melakukan ini dengan mengklik tombol **Log lama** di bagian bawah navigasi. Ini sangat berguna ketika Anda mencapai batas garis dan Anda ingin melihat lebih banyak log. Setiap permintaan yang dijalankan dari navigasi kemudian ditampilkan dalam navigasi sebagai halaman terpisah. Setiap halaman menampilkan `from` dan `to` stempel waktu dari baris log masuk. Anda dapat melihat hasil sebelumnya dengan mengklik setiap halaman. Jelajahi cache lima permintaan terakhir yang dijalankan dari navigasi log, sehingga Anda tidak menjalankan kembali kueri yang sama saat mengklik halaman, menghemat waktu dan sumber daya.

## Opsi visualisasi
<a name="v10-explore-log-visualization-options"></a>

 Anda dapat menyesuaikan bagaimana log ditampilkan dan memilih kolom mana yang ditampilkan. 


| Opsi | Deskripsi | 
| --- | --- | 
| Waktu | Menampilkan atau menyembunyikan kolom waktu. Ini adalah stempel waktu yang terkait dengan baris log seperti yang dilaporkan dari sumber data. | 
| Label unik | Menampilkan atau menyembunyikan kolom label unik yang hanya menyertakan label yang tidak umum. Semua label umum ditampilkan di atas. | 
| Bungkus garis | Setel ini ke true jika Anda ingin tampilan menggunakan pembungkus garis. Jika diatur kefalse, itu akan menghasilkan pengguliran horizontal. | 
| Mempercantik JSON |  Setel ini true untuk mencetak semua log JSON dengan cantik. Pengaturan ini tidak memengaruhi log dalam format apa pun selain JSON. | 
| Deduplikasi | Data log bisa sangat berulang dan Explore dapat membantu dengan menyembunyikan baris log duplikat. Ada beberapa algoritma deduplikasi berbeda yang dapat Anda gunakan. Pencocokan yang tepat dilakukan di seluruh baris kecuali untuk bidang tanggal. Pencocokan angka dilakukan di telepon setelah menghapus nomor seperti durasi, alamat IP, dan sebagainya. Tanda tangan adalah deduplikasi yang paling agresif karena menghapus semua huruf dan angka dan kecocokan pada spasi putih dan tanda baca yang tersisa. | 
| Menampilkan urutan hasil | Anda dapat mengubah urutan log yang diterima dari urutan menurun default (terbaru pertama) menjadi urutan naik (tertua pertama). | 

## Unduh baris log
<a name="v10-explore-download-log-lines"></a>

Untuk mengunduh hasil log dalam salah satu `txt` atau `json` format, gunakan tombol **Unduh**. Fitur ini memungkinkan Anda menyimpan data log untuk analisis lebih lanjut atau membagikannya dengan orang lain dalam format yang nyaman dan dapat diakses.

## Informasi meta hasil log
<a name="v10-explore-log-result-meta-information"></a>

Di atas baris log yang diterima, Anda dapat menemukan informasi meta penting, termasuk:
+ **Jumlah log yang diterima** - Menunjukkan jumlah total log yang diterima untuk kueri atau rentang waktu saat ini.
+ **Kesalahan** - Menampilkan kemungkinan kesalahan dalam hasil log Anda.
+ **Label umum** - Menampilkan label umum.
+ **Total byte diproses** - Merupakan ukuran kumulatif data log yang diproses dalam byte.

**catatan**  
Ketersediaan informasi meta tertentu mungkin tergantung pada sumber data, dan sebagai hasilnya, Anda hanya dapat melihat beberapa detail ini untuk sumber data tertentu.

## Melarikan diri dari baris baru
<a name="v10-explore-log-escaping-newlines"></a>

Jelajahi secara otomatis mendeteksi beberapa urutan lolos yang salah di baris log, seperti baris baru (`\n`,`\r`) atau tab (). `\t` Saat mendeteksi urutan seperti itu, Explore menyediakan opsi **Escape baris baru**.

**Untuk secara otomatis memperbaiki urutan lolos yang salah yang terdeteksi oleh Explore**

1. Pilih **Escape baris baru** untuk mengganti urutan.

1. Tinjau penggantian secara manual untuk mengkonfirmasi kebenarannya.

Jelajahi menggantikan urutan ini. Ketika melakukannya, opsi akan berubah dari **baris baru Escape** menjadi **Remove escaping**. Evaluasi perubahan karena parsing mungkin tidak akurat berdasarkan input yang diterima. Anda dapat mengembalikan penggantian dengan memilih **Hapus** escaping.

## Tingkat log
<a name="v10-explore-log-level"></a>

Untuk log di mana `level` label ditentukan, kami menggunakan nilai label ini untuk menentukan tingkat log dan memperbarui warna setiap baris log yang sesuai. Jika log tidak memiliki label level tertentu, kami mencoba mencari tahu apakah isinya cocok dengan ekspresi yang didukung (lihat tabel berikut untuk informasi selengkapnya). Level log selalu ditentukan oleh pertandingan pertama. Dalam kasus di mana Grafana tidak dapat menyimpulkan bidang level log, itu akan divisualisasikan dengan level log yang tidak diketahui.

**catatan**  
Jika Anda menggunakan sumber data Loki dan `level` merupakan bagian dari baris log Anda, Anda dapat menggunakan parser (JSON, logfmt, regex,..) untuk mengekstrak informasi level ke dalam label level yang digunakan untuk menentukan nilai level. Ini akan memungkinkan histogram untuk menunjukkan berbagai level log sebagai bilah terpisah.

**Tingkat log yang didukung dan pemetaan singkatan dan ekspresi tingkat log:** 


| Tingkat log | Warna | Ekspresi yang didukung | 
| --- | --- | --- | 
| kritis | ungu | muncul, fatal, waspada, kritik, kritis | 
| kesalahan | merah | err, eror, kesalahan | 
| memperingati | kuning | memperingatkan, memperingatkan | 
| info | hijau | info, informasi, informasi, pemberitahuan | 
| debug | biru | dbug, debug | 
| jejak | biru muda | jejak | 
| tidak diketahui | abu-abu | \$1 | 

## Sorot kata-kata yang dicari
<a name="v10-explore-highlight-searched-words"></a>

Saat kueri Anda menyertakan kata atau ekspresi tertentu untuk dicari, Explore akan menyorotnya di baris log untuk visibilitas yang lebih baik. Fitur penyorotan ini memudahkan untuk mengidentifikasi dan fokus pada konten yang relevan di log Anda.

**catatan**  
Kemampuan untuk menyorot kata pencarian dapat bervariasi tergantung pada sumber data. Untuk beberapa sumber data, penyorotan kata pencarian mungkin tidak tersedia.

## Tampilan detail log
<a name="v10-explore-log-details-view"></a>

Di Explore, setiap baris log memiliki bagian yang dapat diperluas yang disebut *Detail log* yang dapat dibuka dengan memilih baris log. Tampilan detail Log menyediakan informasi tambahan dan opsi eksplorasi dalam bentuk *Bidang* dan *Tautan* yang dilampirkan pada baris log, memungkinkan interaksi dan analisis yang lebih kuat.

**Bidang**

Dalam tampilan Detail log, Anda dapat memfilter bidang yang ditampilkan dengan dua cara: filter positif (untuk fokus pada bidang tertentu) dan filter negatif (untuk mengecualikan bidang tertentu). Filter ini akan memperbarui kueri terkait yang menghasilkan baris log, menambahkan ekspresi kesetaraan dan ketidaksetaraan yang sesuai. Jika sumber data memiliki dukungan, seperti halnya untuk Loki dan OpenSearch, detail log akan memeriksa apakah bidang sudah ada dalam tampilan kueri saat ini dan status aktif (hanya untuk filter positif), memungkinkan Anda untuk mengaktifkannya dari kueri, atau mengubah ekspresi filter dari positif ke negatif.

Anda dapat memilih subset bidang untuk divisualisasikan dalam daftar log alih-alih baris log lengkap dengan mengklik ikon mata. Setiap bidang memiliki ikon statistik untuk menampilkan statistik dalam kaitannya dengan semua log yang ditampilkan.

**Tautan**

Grafana menawarkan fungsionalitas tautan data atau korelasi, memungkinkan Anda mengonversi bagian mana pun dari pesan log menjadi tautan internal atau eksternal. Tautan ini dapat digunakan untuk menavigasi ke data terkait atau sumber daya eksternal, menyediakan cara yang mulus dan nyaman untuk mengeksplorasi informasi lebih lanjut.

## Konteks log
<a name="v10-explore-log-context"></a>

Konteks log menampilkan baris konteks tambahan di sekitar entri log yang cocok dengan kueri penelusuran tertentu. Ini dapat membantu dalam memahami konteks entri log, dan mirip dengan `-C` parameter dalam `grep` perintah.

Anda mungkin menemukan baris panjang teks yang membuatnya sulit untuk membaca dan menganalisis konteks di sekitar setiap entri log. Di sinilah sakelar **garis Bungkus** bisa berguna. Dengan mengaktifkan sakelar ini, Grafana akan secara otomatis membungkus baris teks yang panjang sehingga sesuai dengan lebar penampil yang terlihat. Ini dapat membuatnya lebih mudah untuk membaca dan memahami entri log. 

 Tombol **Buka dalam tampilan terpisah** memungkinkan Anda menjalankan kueri konteks untuk entri log di layar terpisah di tampilan Jelajahi. Memilih tombol ini akan membuka panel Jelajahi baru dengan kueri konteks yang ditampilkan di samping entri log, sehingga lebih mudah untuk menganalisis dan memahami konteks sekitarnya.

Kueri konteks log juga dapat dibuka di tab browser baru dengan menekan tombol `Ctrl` (or`Cmd`) sambil memilih tombol untuk membuka modal konteks. Saat dibuka di tab baru, filter yang dipilih sebelumnya juga diterapkan.

## Salin baris log
<a name="v10-explore-copy-log-line"></a>

Anda dapat dengan mudah menyalin konten baris log yang dipilih ke clipboard Anda dengan memilih tombol **Salin baris log**.

## Salin tautan ke baris log
<a name="v10-explore-copy-link-to-log-line"></a>

Menautkan baris log di Grafana memungkinkan Anda menavigasi dengan cepat ke entri log tertentu untuk analisis yang tepat. Dengan memilih tombol **Salin shortlink** untuk baris log, Anda dapat membuat dan menyalin URL pendek yang menyediakan akses langsung ke entri log yang tepat dalam rentang waktu absolut. Saat Anda membuka tautan, Grafana akan secara otomatis menggulir ke baris log yang sesuai dan menyorotnya dengan latar belakang biru, sehingga mudah untuk mengidentifikasi dan fokus pada informasi yang relevan.

**catatan**  
Ini hanya didukung di Loki dan sumber data lain yang menyediakan `id` bidang.

## Ekor langsung
<a name="v10-explore-log-live-tailing"></a>

Untuk melihat log real-time dari sumber data yang didukung, Anda dapat memanfaatkan fitur Live tailing di Jelajahi.

**Untuk melihat log secara real-time dengan live tailing**

1. Pilih tombol **Live** di toolbar Jelajahi untuk beralih ke tampilan Live tail.

1. Sementara dalam tampilan ekor langsung, log baru akan muncul dari bagian bawah layar, dan mereka akan memiliki latar belakang kontras yang memudar, memungkinkan Anda untuk dengan mudah melacak apa yang baru.

1. Jika Anda ingin menjeda tailing Langsung dan menjelajahi log sebelumnya tanpa gangguan, Anda dapat melakukannya dengan memilih tombol **Jeda** atau cukup menggulir tampilan log.

1. Untuk menghapus tampilan dan menghapus semua log dari tampilan, pilih tombol **Hapus log**. Tindakan ini akan mengatur ulang tampilan log dan memberi Anda batu tulis yang bersih untuk melanjutkan analisis log Anda.

1. Untuk melanjutkan Live tailing dan terus melihat log waktu nyata, pilih tombol **Lanjutkan**.

1. Jika Anda ingin keluar dari Live tailing dan kembali ke tampilan Jelajahi standar, pilih tombol **Stop**.

Dengan menggunakan fitur Live tailing, Anda dapat mengawasi log terbaru saat masuk, membuatnya lebih mudah untuk memantau peristiwa waktu nyata dan mendeteksi masalah dengan segera.

**Log sampel**

Jika sumber data yang dipilih mengimplementasikan sampel log, dan mendukung kueri log dan metrik, maka untuk kueri metrik Anda akan dapat secara otomatis melihat sampel baris log yang berkontribusi pada metrik yang divisualisasikan. Fitur ini saat ini didukung oleh sumber data Loki.

**Beralih dari metrik ke log**

 Jika Anda berasal dari sumber data metrik yang mengimplementasikan `DataSourceWithQueryExportSupport` (seperti Prometheus) ke sumber data logging yang mendukung `DataSourceWithQueryImportSupport` (seperti Loki), maka itu akan menyimpan label dari kueri Anda yang ada di log dan menggunakannya untuk menanyakan aliran log.

Misalnya, `grafana_alerting_active_alerts{job='grafana'}` kueri Prometheus berikut setelah beralih ke sumber data Loki, akan berubah menjadi. `{job='grafana'}` Ini akan mengembalikan potongan log dalam rentang waktu yang dipilih yang dapat grepped/text dicari.

# Menelusuri Jelajahi
<a name="v10-explore-tracing"></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 menggunakan Jelajahi untuk memvisualisasikan jejak dari melacak sumber data.

Sumber data berikut didukung.
+ [Tempo](tempo-data-source.md) (format konsumsi yang didukung:, Jaeger OpenTelemetry, dan Zipkin)
+ [Jaeger](jaeger-data-source.md)
+ [AWS X-Ray](x-ray-data-source.md)
+ [Zipkin](zipkin-data-source.md)

Untuk informasi tentang cara mengonfigurasi kueri untuk sumber data yang tercantum di atas, lihat dokumentasi untuk sumber data tertentu.

## Editor kueri
<a name="v10-explore-trace-queryeditor"></a>

Anda dapat menanyakan dan mencari data penelusuran menggunakan editor kueri sumber data.

Setiap sumber data dapat memiliki editor kueri sendiri. Editor kueri untuk sumber data Tempo sedikit berbeda dari editor kueri untuk sumber data Jaeger.

Untuk informasi tentang kueri setiap sumber data, lihat dokumentasinya.
+ [Tempo](tempo-data-source.md)
+ [Jaeger](jaeger-data-source.md)
+ [AWS X-Ray](x-ray-data-source.md)
+ [Zipkin](zipkin-data-source.md)

## Penjelasan Trace View
<a name="v10-explore-trace-view"></a>

Bagian ini menjelaskan elemen dasbor Trace View.

**Header**

Header tampilan jejak memiliki elemen-elemen berikut:
+ Judul header - Menunjukkan nama rentang root dan ID jejak.
+ Pencarian — Sorotan mencakup teks yang dicari.
+ Metadata — Berbagai metadata tentang jejak.

**Minimap**

Menampilkan tampilan kental atau garis waktu jejak. Seret penunjuk Anda ke peta minimum untuk memperbesar rentang waktu yang lebih kecil. Zooming juga akan memperbarui timeline utama, sehingga mudah untuk melihat rentang yang lebih pendek. Melayang di atas minimap, saat diperbesar, akan menampilkan tombol **Reset Selection yang mengatur ulang** zoom.

**Filter rentang**

Menggunakan filter rentang, Anda dapat memfilter rentang Anda di penampil garis waktu jejak. Semakin banyak filter yang Anda tambahkan, semakin spesifik rentang yang difilter.

Anda dapat menambahkan satu atau beberapa filter berikut:
+ Nama layanan sumber daya
+ Nama rentang
+ Durasi
+ Tag (yang mencakup tag, tag proses, dan bidang log)

Untuk hanya menampilkan rentang yang telah Anda cocokkan, pilih sakelar **Tampilkan kecocokan saja**.

**Garis Waktu**

Menampilkan daftar bentang dalam jejak. Setiap baris rentang terdiri dari komponen-komponen ini:
+ Perluas tombol anak — Memperluas atau menciutkan semua rentang anak dari rentang yang dipilih.
+ Nama layanan — Nama layanan yang mencatat rentang.
+ Nama operasi — Nama operasi yang diwakili oleh rentang ini.
+ Bilah durasi rentang — Representasi visual dari durasi operasi dalam jejak.

**Rincian rentang**

Memilih baris rentang menunjukkan detail rentang, termasuk yang berikut ini.
+ Nama operasi
+ Metadata rentang
+ Tag — Tag apa pun yang terkait dengan rentang ini.
+ Metadata proses — Metadata tentang proses yang mencatat rentang ini.
+ Log — Daftar log yang dicatat oleh rentang ini dan nilai kunci terkait. Dalam kasus Zipkin log bagian menunjukkan anotasi Zipkin.

**Lacak ke log**

Anda dapat menavigasi dari rentang dalam tampilan jejak langsung ke log yang relevan untuk rentang tersebut. Ini tersedia untuk sumber data Tempo, Jaeger, dan Zipkin. Lihat dokumentasi yang relevan untuk petunjuk tentang cara mengkonfigurasi setiap sumber data.

Pilih ikon dokumen untuk membuka tampilan terpisah di Jelajahi dengan sumber data yang dikonfigurasi dan kueri log yang relevan untuk rentang tersebut.

**Lacak ke metrik**

**catatan**  
Fitur ini saat ini dalam versi beta

Anda dapat menavigasi formulir rentang dalam tampilan jejak langsung ke metrik yang relevan untuk rentang tersebut. Fitur ini tersedia untuk sumber data Tempo, Jaeger, dan Zipkin. Lihat dokumentasi yang relevan untuk detail tentang konfigurasi.

**Lacak ke profil**

Menggunakan Trace to profiles, Anda dapat menggunakan kemampuan Grafana untuk mengkorelasikan sinyal yang berbeda dengan menambahkan fungsionalitas untuk menghubungkan antara jejak dan profil.

## Grafik simpul
<a name="v10-explore-trace-node-graph"></a>

Anda secara opsional dapat memperluas grafik simpul untuk jejak yang ditampilkan. Bergantung pada sumber data, ini dapat menunjukkan rentang jejak sebagai node dalam grafik, atau menambahkan beberapa konteks tambahan, termasuk grafik layanan berdasarkan jejak saat ini.

## Tampilan Grafik Layanan
<a name="v10-explore-trace-graph"></a>

Tampilan Grafik Layanan memvisualisasikan metrik rentang (melacak data untuk tarif, tingkat kesalahan, dan durasi (RED)) dan grafik layanan. Setelah persyaratan disiapkan, tampilan pra-konfigurasi ini segera tersedia.

Untuk informasi selengkapnya, lihat halaman sumber data [Tempo](tempo-data-source.md). Anda juga dapat melihat [halaman tampilan grafik layanan di dokumentasi](https://grafana.com/docs/tempo/latest/metrics-generator/service-graph-view/) *Grafana Labs Tempo*.

## Data API
<a name="v10-explore-trace-dataapi"></a>

Visualisasi ini membutuhkan bentuk data tertentu yang akan dikembalikan dari sumber data agar dapat menampilkannya dengan benar.

Sumber data perlu mengembalikan data frame dan set`frame.meta.preferredVisualisationType = 'trace'`.

**Struktur bingkai data**

Bidang yang diperlukan;


| Nama bidang | Tipe | Deskripsi | 
| --- | --- | --- | 
| TraceID | string | Pengidentifikasi untuk seluruh jejak. Seharusnya hanya ada satu jejak dalam bingkai data. | 
| SpanID | string | Pengidentifikasi untuk rentang saat ini. Rentang IDs harus unik per jejak. | 
| Orang tuaSpanid | string | spanId dari rentang induk untuk membuat hubungan induk anak dalam tampilan jejak. Bisa undefined untuk rentang root tanpa induk. | 
| serviceName | string | Nama layanan rentang ini adalah bagian dari. | 
| ServiceTags | TraceKeyValuePair[] | Daftar tag yang relevan untuk layanan ini. | 
| startTime | number | Waktu mulai rentang dalam waktu epoch milidetik. | 
| durasi | number | Durasi rentang dalam milidetik. | 

 Bidang opsional: 


| Nama bidang | Tipe | Deskripsi | 
| --- | --- | --- | 
| log | TraceLog[] | Daftar log yang terkait dengan rentang saat ini. | 
| tag | TraceKeyValuePair[] | Daftar tag yang terkait dengan rentang saat ini. | 
| peringatan | tali [] | Daftar peringatan yang terkait dengan rentang saat ini. | 
| StackTraces | tali [] | Daftar jejak tumpukan yang terkait dengan rentang saat ini. | 
| errorIconColor | string | Warna ikon kesalahan dalam rentang kasus ditandai denganerror: true. | 

Untuk detail tentang jenis lihat [TraceSpanRow](https://github.com/grafana/grafana/blob/main/packages/grafana-data/src/types/trace.ts#L28), [TraceKeyValuePair](https://github.com/grafana/grafana/blob/main/packages/grafana-data/src/types/trace.ts#L4)dan [TraceLog](https://github.com/grafana/grafana/blob/main/packages/grafana-data/src/types/trace.ts#L12)seterusnya GitHub.

# Editor korelasi di Jelajahi
<a name="v10-explore-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)

Korelasi memungkinkan pengguna untuk membangun hubungan antara dua sumber data. Untuk informasi lebih lanjut, termasuk ikhtisar korelasi, lihat[Korelasi dalam Grafana versi 10](v10-correlations.md).

## Menciptakan korelasi
<a name="v10-explore-corr-create-a-correlation"></a>

Anda dapat membuat korelasi dari halaman Jelajahi.

**Untuk membuat korelasi**

1. Di ruang kerja Grafana Terkelola Amazon Anda, navigasikan ke halaman Jelajahi.

1. Pilih sumber data yang Anda inginkan untuk menjadi sumber untuk korelasi baru.

1. Jalankan kueri yang menghasilkan data dalam visualisasi yang didukung.
**catatan**  
[Visualisasi yang didukung adalah [Log](v10-panels-logs.md) dan Tabel.](v10-panels-table.md)

1. [Pilih **\$1 Tambahkan** di bilah alat atas dan pilih **Tambahkan korelasi** (Anda juga dapat memilih **Editor Korelasi** dari Palet Perintah.](v10-search.md#v10-search-palette)

   Jelajahi sekarang dalam mode Editor Korelasi yang ditunjukkan oleh batas biru dan bilah atas. Anda dapat keluar dari Editor Korelasi dengan memilih **Keluar** di bilah atas.

1. Sekarang Anda dapat membuat korelasi baru berikut untuk visualisasi dengan tautan yang dilampirkan ke data yang dapat Anda gunakan untuk membuat kueri baru:
   + *Log* - tautan ditampilkan di sebelah nilai bidang di dalam detail log untuk setiap baris log.
   + *Tabel* — setiap sel tabel adalah tautan.

1. Pilih tautan untuk menambahkan korelasi baru. Tautan dikaitkan dengan bidang yang digunakan sebagai bidang hasil korelasi. Untuk detail selengkapnya, lihat [Konfigurasi korelasi](v10-correlations-config.md).

1. Dalam tampilan terpisah yang terbuka, gunakan panel kanan untuk mengatur sumber kueri target korelasi. Untuk detail selengkapnya, lihat [Kueri target](v10-correlations-config.md#v10-correlations-config-target-query).

1. Buat kueri target menggunakan [sintaks variabel](v10-dash-variable-syntax.md) dengan variabel dari daftar yang disediakan di bagian atas panel. Daftar ini berisi nilai sampel dari baris data yang dipilih.

1. Berikan label dan deskripsi (opsional). Label akan digunakan sebagai nama tautan di dalam visualisasi dan dapat berisi variabel.

1. Berikan transformasi (opsional; lihat di bawah untuk detailnya).

1. Pilih **Simpan** di bilah alat atas untuk menyimpan korelasi dan keluar dari mode Editor Korelasi. Tautan yang digunakan untuk membuat korelasi diganti dengan tautan data di setiap baris. Saat tautan dipilih, kueri yang Anda tentukan akan berjalan di panel lain, dengan variabel diganti secara dinamis dengan nilai dari baris yang dipilih.

## Transformasi
<a name="v10-explore-corr-transformations"></a>

Transformasi memungkinkan Anda mengekstrak nilai yang ada di bidang dengan data lain. Misalnya, menggunakan transformasi, Anda dapat mengekstrak satu bagian dari baris log untuk digunakan dalam korelasi. Untuk detail lebih lanjut tentang transformasi dalam korelasi, lihat. [Transformasi Korelasi](v10-correlations-config.md#v10-correlations-config-transformations)

Setelah memilih salah satu tautan yang dihasilkan dalam mode editor, Anda dapat menambahkan transformasi dengan memilih **Tambahkan transformasi** di menu tarik-turun **Transformasi**.

**Untuk menggunakan transformasi dalam korelasi**

1. Pilih bidang untuk menerapkan transformasi. Pilih bagian bidang yang ingin Anda gunakan untuk transformasi. Misalnya, baris log. Setelah dipilih, nilai bidang ini akan digunakan untuk membantu Anda dalam membangun transformasi.

1. Pilih jenis transformasi. Lihat [Transformasi Korelasi](v10-correlations-config.md#v10-correlations-config-transformations) opsi dan pengaturan yang relevan. 

1. Berdasarkan pilihan Anda, Anda mungkin melihat satu atau lebih variabel terisi, atau Anda mungkin perlu memberikan lebih banyak spesifikasi dalam opsi yang ditampilkan.

1. Pilih **Tambahkan transformasi ke korelasi** untuk menambahkan variabel yang ditentukan ke daftar variabel yang tersedia.

**catatan**  
Untuk ekspresi reguler dalam kotak dialog ini, yang `mapValue` dimaksud dalam dokumentasi lain disebut `Variable Name` di sini. Grafana menyoroti teks apa pun yang cocok dengan ekspresi dalam nilai bidang. Gunakan grup pengambilan ekspresi reguler untuk memilih bagian mana dari kecocokan yang harus diekstraksi. Ketika ekspresi reguler yang valid disediakan, variabel dan nilai variabel tersebut muncul di bawah `Variable Name` bidang.

## Contoh korelasi
<a name="v10-explore-corr-examples"></a>

Contoh berikut menunjukkan cara membuat korelasi menggunakan Editor Korelasi di Jelajahi. Jika Anda ingin mengikuti contoh ini, pastikan untuk menyiapkan [sumber data pengujian](testdata-data-source.md).

### Membuat korelasi teks ke grafik
<a name="v10-explore-corr-text-to-graph"></a>

Contoh ini menunjukkan cara membuat korelasi menggunakan Editor Korelasi di Jelajahi.

Korelasi memungkinkan Anda menggunakan hasil dari satu kueri untuk menjalankan kueri baru di sumber data apa pun. Dalam contoh ini, Anda akan menjalankan kueri yang membuat data tabular. Data akan digunakan untuk menjalankan kueri berbeda yang menghasilkan hasil grafik.

Untuk mengikuti contoh ini, pastikan Anda telah menyiapkan [sumber data uji](testdata-data-source.md).

**Untuk membuat korelasi teks ke grafik**

1. **Di Grafana, navigasikan ke Jelajahi.**

1. Pilih **sumber data uji** dari menu tarik-turun di kiri atas halaman.

1. Pilih **\$1 Tambahkan** di menu tarik-turun ke kanan dan pilih **Tambahkan** korelasi.

1. Jelajahi sekarang dalam mode Editor Korelasi, ditunjukkan dengan batas biru.

1. Pilih skenario berikut dari menu tarik-turun skenario: File **CSV**.

1. Pilih file, **population\$1by\$1state.csv**. Setiap sel adalah tautan yang dapat Anda klik untuk mulai membuat korelasi baru.

1. Klik pada sel mana pun di `State` kolom untuk membuat korelasi baru yang melampirkan tautan data ke entri itu. Misalnya, pilih`California`.

1. Dalam tampilan terpisah, pilih sumber data yang sama yang Anda pilih di panel kiri. Helper di atas editor kueri berisi semua variabel yang tersedia Anda dapat menggunakan kueri target. Variabel berisi semua bidang data (kolom tabel) dari baris yang dipilih.

1. Di menu **Skenario**, pilih **Nilai Metrik CSV**. `String Input`Bidang di editor Query menyediakan variabel dengan nilai populasi untuk setiap tahun:`${1980},${2000},${2020}`. Ini akan menghasilkan grafik menggunakan nilai variabel.

1. Di bidang Query Editor **Alias**, masukkan`${State}`.

   Jalankan kueri untuk melihat bahwa itu menghasilkan grafik menggunakan nilai sampel dari variabel.

1. Pilih **Simpan** untuk menyimpan korelasi dan keluar dari Editor Korelasi.

   Setelah korelasi disimpan, Explore akan menjalankan kembali kueri di panel kiri. Dengan mengklik nama negara, kueri di sebelah kanan dijalankan kembali dengan nilai dari baris yang dimasukkan ke dalam CSV, sehingga mengubah grafik. Kueri dijalankan kembali dengan nilai yang diperbarui setiap kali Anda mengklik nama negara.

Anda dapat menerapkan langkah yang sama ke sumber data apa pun. Korelasi memungkinkan Anda membuat tautan dalam visualisasi untuk menjalankan kueri dinamis berdasarkan data yang dipilih. Dalam contoh ini kami menggunakan data yang dikembalikan oleh kueri untuk membangun kueri baru yang menghasilkan visualisasi yang berbeda menggunakan sumber data yang sama. Namun, Anda dapat membuat korelasi antara sumber data apa pun untuk membuat alur eksplorasi kustom.

### Membuat log ke korelasi tabel
<a name="v10-explore-corr-logs-to-table"></a>

Dalam contoh ini, Anda akan membuat korelasi untuk menunjukkan cara menggunakan transformasi untuk mengekstrak nilai dari baris log dan bidang lain.

Untuk mengikuti contoh ini, pastikan Anda telah menyiapkan [sumber data uji](testdata-data-source.md).

**Untuk membuat log ke korelasi tabel**

1. **Di Grafana, navigasikan ke Jelajahi.**

1. Pilih **sumber data uji** dari menu tarik-turun di kiri atas halaman.

1. Pilih **\$1 Tambahkan** di menu tarik-turun ke kanan dan pilih **Tambahkan** korelasi.

1. Jelajahi sekarang dalam mode Editor Korelasi, ditunjukkan dengan batas biru.

1. Di menu **Skenario**, pilih **Log**.

1. Perluas baris log untuk melihat tautan korelasi. Pilih `Correlate with hostname`.

1. Jelajahi terbuka dalam tampilan terpisah. Pilih sumber data yang sama yang Anda pilih di panel kiri. Helper di atas editor kueri berisi semua variabel yang tersedia Anda dapat menggunakan kueri target.

1. Perluas bagian transformasi, dan klik **Tambahkan transformasi**.

1. **Di menu tarik-turun **Bidang**, pilih pesan.** Baris log muncul sebagai contoh data.

1. Di bawah **Jenis**, pilih **Logfmt**. Ini mengisi daftar variabel.

1. Pilih **Tambahkan transformasi ke korelasi**.

1. Pilih **Tambahkan transformasi** lagi dan di bawah **Bidang**, pilih **nama host**.

1. Di bawah **Jenis**, pilih **Ekspresi reguler**.

1. Di bawah **Ekspresi**, masukkan yang berikut ini:`-([0-9]\*)`. Ini memilih nomor apa pun di sebelah kanan tanda hubung.

1. Di bawah **Nama Variabel**, masukkan yang berikut ini:`hostNumber`. Ini mengisi daftar variabel. 

1. Pilih **Tambahkan transformasi ke korelasi** untuk menambahkannya ke variabel lain.

1. Di editor sumber data, buka menu tarik-turun **Skenario** dan pilih Konten **CSV**.

1. Pada kotak teks di bawah ini, berikan yang berikut dan simpan korelasinya:

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

   Ini menutup tampilan split dan menjalankan ulang kueri kiri. Perluas baris log apa pun untuk melihat tombol korelasi. *Memilih tombol korelasi membuka tampilan split dengan (bidang), `time` (diekstraksi dengan *logfmt* dari baris log), `msg` (diekstraksi dengan *regex* dari) dan `host number` (diekstraksi dengan logfmt dari baris log`hostname`). `status`*

# Inspector di Explore
<a name="v10-explore-inspector"></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)

Inspektur membantu Anda memahami dan memecahkan masalah pertanyaan Anda. Anda dapat memeriksa data mentah, mengekspor data tersebut ke file nilai yang dipisahkan koma (CSV), mengekspor hasil log dalam format TXT, dan melihat permintaan kueri.

## Inspector UI
<a name="v10-explore-inspector-ui"></a>

Inspektur memiliki tab berikut:
+ **Tab Statistik** - Menunjukkan berapa lama kueri Anda dan berapa banyak yang dikembalikan.
+ **Tab kueri** — Menampilkan permintaan ke server yang dikirim saat Grafana menanyakan sumber data.
+ **Tab JSON** - Memungkinkan Anda untuk melihat dan menyalin data JSON dan struktur bingkai data JSON.
+ **Tab data** - Menampilkan data mentah yang dikembalikan oleh kueri.
+ **Tab kesalahan** - Menampilkan kesalahan. Hanya terlihat ketika kueri mengembalikan kesalahan.

## Tugas Inspector
<a name="v10-explore-inspector-tasks"></a>

Anda dapat melakukan berbagai tugas di inspektur Jelajahi.

**Buka Inspector**

Setelah Anda menjalankan kueri yang ingin Anda periksa, pilih tombol **Inspector**.

Panel inspektur terbuka di bagian bawah layar.

**Periksa hasil kueri mentah**

Anda dapat melihat hasil kueri mentah, yaitu data yang dikembalikan oleh kueri dalam tabel.

Di tab **Inspector**, klik tab **Data**.

Untuk beberapa kueri atau untuk kueri beberapa node, ada opsi tambahan.
+ **Tampilkan bingkai data:** Pilih data set hasil yang ingin Anda lihat.
+ **Seri yang digabungkan dengan waktu:** Lihat data mentah dari semua kueri Anda sekaligus, satu set hasil per kolom. Anda dapat mengklik judul kolom untuk mengurutkan data.

**Unduh hasil kueri mentah sebagai CSV**

Grafana menghasilkan file CSV di lokasi unduhan browser default Anda. Anda dapat membukanya di pemirsa pilihan Anda.

1. Di tab **Inspector**, dapatkan hasil kueri mentah dengan mengikuti petunjuk di atas.

1. Perbaiki pengaturan kueri hingga Anda dapat melihat data mentah yang ingin Anda ekspor.

1. Pilih **Unduh CSV**.

**Untuk mengunduh file CSV yang diformat khusus untuk Excel, perluas **opsi Data** dan kemudian aktifkan tombol **Unduh untuk Excel** sebelum Anda memilih opsi Unduh CSV.**

**Unduh hasil log sebagai TXT**

**Anda dapat menghasilkan file TXT dari log yang sedang Anda lihat, dengan memilih **Unduh log** di tab Inspector.**

**Unduh hasil jejak**

Berdasarkan tipe sumber data, Grafana menghasilkan file JSON untuk hasil jejak dalam salah satu format yang didukung: format Jaeger, Zipkin, atau OTLP.

1. Buka Inspector

1. Periksa hasil kueri log. Perbaiki hasilnya sampai Anda melihat log mentah yang ingin Anda ekspor.

1. Pilih **Unduh log**.

**Periksa kinerja kueri**

Tab **Statistik** menampilkan statistik yang memberi tahu Anda berapa lama kueri Anda, berapa banyak kueri yang Anda kirim, dan jumlah baris yang dikembalikan. Informasi ini dapat membantu Anda memecahkan masalah pertanyaan Anda, terutama jika ada angka yang tiba-tiba tinggi atau rendah.

Statistik ditampilkan dalam format read-only.

**Lihat model JSON**

Anda dapat menjelajahi dan mengekspor data serta model JSON bingkai data.

**Untuk melihat model JSON**

1. Di panel Inspector, klik tab **JSON**.

1. Dari menu tarik-turun **Pilih sumber**, pilih salah satu opsi berikut:
   + **Data** - Menampilkan objek JSON yang mewakili data yang dikembalikan ke Explore.
   + **DataFrame struktur** - Menampilkan set hasil mentah.

1. Anda dapat memperluas atau menciutkan bagian JSON untuk melihat bagian terpisah. Anda juga dapat memilih opsi **Salin ke clipboard** untuk menyalin badan JSON dan menempelkannya ke aplikasi lain.

**Lihat permintaan mentah dan respons terhadap sumber data**

Saat Anda bekerja dengan Explore dan tab Inspector, Anda dapat melihat permintaan mentah dan data respons yang Anda hasilkan dengan kueri. Di Inspector, pilih tab **Query** dan pilih **Refresh** untuk melihat data mentah.

Grafana mengirimkan kueri ke server dan menampilkan hasilnya. Anda dapat menelusuri bagian-bagian tertentu dari kueri, memperluas atau menciutkan semuanya, atau menyalin data ke clipboard untuk digunakan dalam aplikasi lain.

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

# Peringatan di Grafana versi 10
<a name="v10-alerts"></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)

Dengan Grafana v10, Grafana yang Dikelola Amazon menyertakan akses ke sistem peringatan yang diperbarui, peringatan Grafana, yang memusatkan informasi *peringatan dalam satu tampilan* yang dapat dicari. Grafana alert diperkenalkan sebagai fitur opsional di Grafana v8, dan GrafanaLabs telah mengumumkan penghapusan peringatan lama di versi 11.

**catatan**  
Dokumentasi ini mencakup peringatan Grafana. Untuk informasi tentang peringatan lama, lihat. [Peringatan dasbor klasik](old-alerts-overview.md)

Grafana Alerting memungkinkan Anda untuk belajar tentang masalah dalam sistem Anda beberapa saat setelah itu terjadi.

Pantau data metrik masuk atau entri log Anda dan atur sistem Peringatan Anda untuk melihat peristiwa atau keadaan tertentu, lalu kirim pemberitahuan saat hal-hal tersebut ditemukan.

Dengan cara ini, Anda menghilangkan kebutuhan untuk pemantauan manual dan memberikan garis pertahanan pertama terhadap pemadaman sistem atau perubahan yang dapat berubah menjadi insiden besar.

Dengan Grafana Alerting, Anda membuat kueri dan ekspresi dari berbagai sumber data — di mana pun data Anda disimpan — memberi Anda fleksibilitas untuk menggabungkan data dan peringatan tentang metrik dan log Anda dengan cara baru dan unik. Anda kemudian dapat membuat, mengelola, dan mengambil tindakan pada peringatan Anda dari satu tampilan yang terkonsolidasi, dan meningkatkan kemampuan tim Anda untuk mengidentifikasi dan menyelesaikan masalah dengan cepat.

Dengan aturan peringatan Mimir dan Loki, Anda dapat menjalankan ekspresi peringatan lebih dekat ke data Anda dan dalam skala besar, semuanya dikelola oleh UI Grafana yang sudah Anda kenal.

**catatan**  
Jika Anda bermigrasi dari Grafana versi sebelumnya, tempat Anda menggunakan peringatan Grafana lama, Anda mungkin merasa terbantu untuk melihat [perbedaan antara peringatan lama](v10-alerting-use-grafana-alerts.md#v10-alerting-diff-old-new) dan peringatan Grafana baru.

## Fitur dan manfaat utama
<a name="v10-alerting-key-features"></a>

**Satu halaman untuk semua peringatan**

Satu halaman Peringatan Grafana menggabungkan peringatan dan peringatan yang dikelola Grafana yang berada di sumber data Anda yang kompatibel dengan Prometheus di satu tempat.

**Peringatan multi-dimensi**

Aturan peringatan dapat membuat beberapa instance peringatan individual per aturan peringatan, yang dikenal sebagai peringatan multi-dimensi, memberi Anda kekuatan dan fleksibilitas untuk mendapatkan visibilitas ke seluruh sistem Anda hanya dengan satu aturan peringatan. Anda melakukan ini dengan menambahkan label ke kueri Anda untuk menentukan komponen mana yang sedang dipantau dan menghasilkan beberapa instance peringatan untuk satu aturan peringatan. Misalnya, jika Anda ingin memantau setiap server dalam sebuah cluster, peringatan multi-dimensi akan mengingatkan pada setiap CPU, sedangkan peringatan standar akan mengingatkan pada keseluruhan server.

**Peringatan rute**

Rutekan setiap instance peringatan ke titik kontak tertentu berdasarkan label yang Anda tentukan. Kebijakan pemberitahuan adalah seperangkat aturan untuk di mana, kapan, dan bagaimana peringatan diarahkan ke titik kontak.

**Peringatan diam**

Keheningan menghentikan pemberitahuan agar tidak dibuat dan bertahan hanya untuk jangka waktu tertentu. Keheningan memungkinkan Anda untuk berhenti menerima pemberitahuan persisten dari satu atau beberapa aturan peringatan. Anda juga dapat menjeda sebagian peringatan berdasarkan kriteria tertentu. Silences memiliki bagian khusus mereka sendiri untuk organisasi dan visibilitas yang lebih baik, sehingga Anda dapat memindai aturan peringatan yang dijeda tanpa mengacaukan tampilan peringatan utama.

**Bisukan pengaturan waktu**

Waktu bisu adalah interval waktu berulang ketika tidak ada pemberitahuan baru untuk kebijakan yang dibuat atau dikirim. Gunakan mereka untuk mencegah peringatan menembakkan periode tertentu dan berulang, misalnya, periode pemeliharaan rutin.

Mirip dengan keheningan, pengaturan waktu bisu tidak mencegah aturan peringatan dievaluasi, juga tidak menghentikan instance peringatan ditampilkan di antarmuka pengguna. Mereka hanya mencegah pemberitahuan dibuat.

## Rancang sistem Peringatan Anda
<a name="v10-alerting-design"></a>

Memantau sistem TI yang kompleks dan memahami apakah semuanya berjalan dan berjalan dengan benar adalah tugas yang sulit. Oleh karena itu, menyiapkan sistem manajemen peringatan yang efektif sangat penting untuk memberi tahu Anda ketika ada yang salah sebelum mulai memengaruhi hasil bisnis Anda.

Merancang dan mengonfigurasi pengaturan manajemen peringatan yang berfungsi membutuhkan waktu.

Berikut adalah beberapa tips tentang cara membuat pengaturan manajemen peringatan yang efektif untuk bisnis Anda:

**Mana metrik utama untuk bisnis Anda yang ingin Anda pantau dan waspada?**
+ Temukan peristiwa yang penting untuk diketahui dan tidak terlalu sepele atau sering sehingga penerima mengabaikannya.
+ Peringatan hanya boleh dibuat untuk acara besar yang membutuhkan perhatian atau intervensi segera.
+ Pertimbangkan kualitas daripada kuantitas.

**Jenis Alerting apa yang ingin Anda gunakan?**
+ Pilih antara Peringatan yang dikelola Grafana atau Grafana Mimir atau Peringatan yang dikelola Loki; atau keduanya.

**Bagaimana Anda ingin mengatur peringatan dan notifikasi Anda?**
+ Selektif tentang siapa yang Anda tetapkan untuk menerima peringatan. Pertimbangkan untuk mengirimnya ke siapa pun yang sedang menelepon atau saluran Slack tertentu.
+ Otomatiskan sejauh mungkin menggunakan API Peringatan atau peringatan sebagai kode (Terraform).

**Bagaimana Anda bisa mengurangi kelelahan waspada?**
+ Hindari peringatan yang bising dan tidak perlu dengan menggunakan keheningan, pengaturan waktu bisu, atau menjeda evaluasi aturan peringatan.
+ Sesuaikan aturan peringatan Anda secara terus-menerus untuk meninjau efektivitas. Hapus aturan peringatan untuk menghindari duplikasi atau peringatan yang tidak efektif.
+ Pikirkan baik-baik tentang tingkat prioritas dan tingkat keparahan.
+ Terus tinjau ambang batas dan aturan evaluasi Anda.

## Keterbatasan peringatan Grafana
<a name="v10-alerting-limitations"></a>
+ Saat menggabungkan aturan dari sistem lain, sistem peringatan Grafana dapat mengambil aturan dari semua sumber data Amazon Managed Service untuk Prometheus, Prometheus, Loki, dan Alertmanager yang tersedia. Mungkin tidak dapat mengambil aturan dari sumber data lain yang didukung.

**Topics**
+ [Fitur dan manfaat utama](#v10-alerting-key-features)
+ [Rancang sistem Peringatan Anda](#v10-alerting-design)
+ [Keterbatasan peringatan Grafana](#v10-alerting-limitations)
+ [Gambaran umum](v10-alerting-overview.md)
+ [Mengatur Peringatan](v10-alerting-setup.md)
+ [Konfigurasikan peringatan](v10-alerting-configure.md)
+ [Kelola lansiran Anda](v10-alerting-manage.md)

# Gambaran umum
<a name="v10-alerting-overview"></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)

Baik Anda baru memulai atau pengguna Grafana Alerting yang lebih berpengalaman, pelajari lebih lanjut tentang dasar-dasar dan fitur yang tersedia yang membantu Anda membuat, mengelola, dan menanggapi peringatan; dan tingkatkan kemampuan tim Anda untuk menyelesaikan masalah dengan cepat.

## Prinsip
<a name="v10-alerting-overview-principles"></a>

Dalam sistem peringatan berbasis Prometheus, Anda memiliki generator peringatan yang membuat peringatan dan penerima peringatan yang menerima peringatan. Misalnya, Prometheus adalah generator peringatan dan bertanggung jawab untuk mengevaluasi aturan peringatan, sementara Alertmanager adalah penerima peringatan dan bertanggung jawab untuk mengelompokkan, menghambat, membungkam, dan mengirim pemberitahuan tentang penembakan dan peringatan yang diselesaikan.

Grafana Alerting dibangun di atas model Prometheus dalam merancang sistem peringatan. Ini memiliki generator peringatan internal yang bertanggung jawab untuk menjadwalkan dan mengevaluasi aturan peringatan, serta penerima peringatan internal yang bertanggung jawab untuk mengelompokkan, menghambat, membungkam, dan mengirim pemberitahuan. Grafana tidak menggunakan Prometheus sebagai generator peringatan karena Grafana Alerting perlu bekerja dengan banyak sumber data lain selain Prometheus. Namun, ia menggunakan Alertmanager sebagai penerima peringatan.

Peringatan dikirim ke penerima peringatan di mana mereka diarahkan, dikelompokkan, dihambat, dibungkam, dan diberitahukan. Di Grafana Alerting, penerima peringatan default adalah Alertmanager yang disematkan di dalam Grafana, dan disebut sebagai Grafana Alertmanager. Namun, Anda juga dapat menggunakan Alertmanager lainnya, dan ini disebut sebagai Manajer Peringatan [Eksternal](v10-alerting-setup-alertmanager.md).

## Dasar-dasar
<a name="v10-alerting-overview-fundamentals"></a>

Berikut ini memberikan ikhtisar tentang berbagai bagian peringatan Grafana.

### Aturan peringatan
<a name="v10-alerting-overview-alert-rules"></a>

Aturan peringatan adalah seperangkat kriteria yang menentukan kapan peringatan harus ditembakkan. Ini terdiri dari satu atau lebih pertanyaan dan ekspresi, suatu kondisi yang perlu dipenuhi, interval yang menentukan seberapa sering aturan peringatan dievaluasi, dan durasi di mana kondisi harus dipenuhi agar peringatan menyala.

Aturan peringatan dievaluasi selama intervalnya, dan setiap aturan peringatan dapat memiliki nol, satu, atau sejumlah peringatan yang ditembakkan pada satu waktu. Status aturan peringatan ditentukan oleh yang paling `severe` waspada, yang dapat berupa salah satu Normal, Tertunda, atau Penembakan. Misalnya, jika setidaknya satu dari peringatan aturan peringatan ditembakkan maka aturan peringatan juga diberlakukan. Kesehatan aturan siaga ditentukan oleh status evaluasi terbarunya. Ini bisa OK, Error, dan NoData.

Fitur yang sangat penting dari aturan peringatan adalah bahwa mereka mendukung anotasi dan label khusus. Ini memungkinkan Anda untuk instrumen peringatan dengan metadata tambahan seperti ringkasan dan deskripsi, dan menambahkan label tambahan untuk merutekan peringatan ke kebijakan pemberitahuan tertentu.

### Pemberitahuan
<a name="v10-alerting-overview-alerts"></a>

Peringatan diidentifikasi secara unik oleh kumpulan key/value pasangan yang disebut Label. Setiap kunci adalah nama label dan setiap nilai adalah nilai label. Misalnya, satu peringatan mungkin memiliki label `foo=bar` dan peringatan lain mungkin memiliki label`foo=baz`. Peringatan dapat memiliki banyak label seperti `foo=bar,bar=baz` tetapi tidak dapat memiliki label yang sama dua kali seperti`foo=bar,foo=baz`. Dua peringatan juga tidak dapat memiliki label yang sama, dan jika dua peringatan memiliki label yang sama seperti `foo=bar,bar=baz` dan `foo=bar,bar=baz` kemudian salah satu peringatan akan dibuang. Peringatan diselesaikan ketika kondisi dalam aturan peringatan tidak lagi terpenuhi, atau aturan peringatan dihapus.

Di Grafana Managed Alerts, peringatan bisa dalam status Normal, Tertunda, Peringatan, Tidak Ada Data atau Kesalahan. Di sumber Data Peringatan Terkelola, seperti Mimir dan Loki, peringatan bisa dalam Normal, Tertunda dan Peringatan, tetapi tidak atau Kesalahan. NoData 

### Titik kontak
<a name="v10-alerting-overview-contact-points"></a>

Titik kontak menentukan di mana pemberitahuan dikirim. Misalnya, Anda mungkin memiliki titik kontak yang mengirimkan pemberitahuan ke alamat email, ke Slack, ke sistem manajemen insiden (IRM) seperti Grafana OnCall atau Pagerduty, atau ke webhook.

Notifikasi yang dikirim dari titik kontak dapat disesuaikan menggunakan templat notifikasi. Anda dapat menggunakan templat notifikasi untuk mengubah judul, pesan, dan struktur notifikasi. Template notifikasi tidak spesifik untuk integrasi individual atau titik kontak.

### Kebijakan pemberitahuan
<a name="v10-alerting-overview-notification-policies"></a>

Kebijakan pemberitahuan mengelompokkan peringatan dan kemudian merutekan mereka ke titik kontak. Mereka menentukan kapan pemberitahuan dikirim, dan seberapa sering pemberitahuan harus diulang.

Peringatan dicocokkan dengan kebijakan notifikasi menggunakan pencocokan label. Ini adalah ekspresi yang dapat dibaca manusia yang menyatakan jika label peringatan sama persis, tidak sama persis, berisi, atau tidak mengandung beberapa teks yang diharapkan. Misalnya, matcher `foo=bar` mencocokkan peringatan dengan label `foo=bar` sementara matcher `foo=~[a-zA-Z]+` mencocokkan peringatan dengan label apa pun yang disebut foo dengan nilai yang cocok dengan ekspresi reguler. `[a-zA-Z]+`

Secara default, peringatan hanya dapat mencocokkan satu kebijakan notifikasi. Namun, dengan `continue` fitur peringatan dapat dibuat untuk mencocokkan sejumlah kebijakan pemberitahuan pada saat yang sama. Untuk informasi selengkapnya tentang kebijakan notifikasi, lihat [Kebijakan Pemberitahuan](v10-alerting-explore-notifications-policies-details.md).

### Keheningan dan pengaturan waktu bisu
<a name="v10-alerting-overview-silences-and-mute-timings"></a>

Diam dan pengaturan waktu bisu memungkinkan Anda menjeda notifikasi untuk peringatan tertentu atau bahkan seluruh kebijakan notifikasi. Gunakan keheningan untuk menjeda notifikasi secara ad-hoc, seperti saat mengerjakan perbaikan untuk peringatan; dan gunakan pengaturan waktu bisu untuk menjeda notifikasi secara berkala, seperti selama jendela pemeliharaan terjadwal secara rutin.

**Topics**
+ [Prinsip](#v10-alerting-overview-principles)
+ [Dasar-dasar](#v10-alerting-overview-fundamentals)
+ [Sumber data dan peringatan Grafana](v10-alerting-overview-datasources.md)
+ [Peringatan pada data numerik](v10-alerting-overview-numeric.md)
+ [Label dan anotasi](v10-alerting-overview-labels.md)
+ [Tentang aturan peringatan](v10-alerting-explore-rules.md)
+ [Pengelola Peringatan](v10-alerting-explore-alertmanager.md)
+ [Titik kontak](v10-alerting-explore-contacts.md)
+ [Notifikasi](v10-alerting-explore-notifications.md)
+ [Memperingatkan ketersediaan tinggi](v10-alerting-explore-high-availability.md)

# Sumber data dan peringatan Grafana
<a name="v10-alerting-overview-datasources"></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)

Ada sejumlah sumber data yang kompatibel dengan Grafana Alerting. Setiap sumber data didukung oleh plugin. Peringatan Grafana mengharuskan plugin sumber data menjadi plugin *backend*, untuk mengevaluasi aturan menggunakan sumber data, karena mesin evaluasi berjalan di backend. Plugin juga harus menentukan bahwa mereka kompatibel dengan peringatan Grafana.

Sumber data ditambahkan dan diperbarui dari waktu ke waktu. Sumber data berikut diketahui kompatibel dengan peringatan Grafana.
+ [Connect ke sumber CloudWatch data Amazon](using-amazon-cloudwatch-in-AMG.md)
+ [Connect ke sumber data Azure Monitor](using-azure-monitor-in-AMG.md)
+ [Connect ke sumber data Amazon OpenSearch Service](using-Amazon-OpenSearch-in-AMG.md)
+ [Connect ke sumber data Google Cloud Monitoring](using-google-cloud-monitoring-in-grafana.md)
+ [Connect ke sumber data Graphite](using-graphite-in-AMG.md)
+ [Connect ke sumber data InfluxDB](using-influxdb-in-AMG.md)
+ [Connect ke sumber data Loki](using-loki-in-AMG.md)
+ [Connect ke sumber data Microsoft SQL Server](using-microsoft-sql-server-in-AMG.md)
+ [Connect ke sumber data MySQL](using-mysql-in-AMG.md)
+ [Connect ke sumber data OpenTSDB](using-opentsdb-in-AMG.md)
+ [Connect ke sumber data PostgreSQL](using-postgresql-in-AMG.md)
+ [Connect ke Amazon Managed Service untuk Prometheus dan sumber data Prometheus sumber terbuka](prometheus-data-source.md)
+ [Connect ke sumber data Jaeger](jaeger-data-source.md)
+ [Connect ke sumber data Zipkin](zipkin-data-source.md)
+ [Connect ke sumber data Tempo](tempo-data-source.md)
+ [Konfigurasikan sumber TestData data untuk pengujian](testdata-data-source.md)

Untuk informasi selengkapnya tentang sumber data dan plugin sumber data di Grafana Terkelola Amazon, lihat. [Connect ke sumber data](AMG-data-sources.md)

# Peringatan pada data numerik
<a name="v10-alerting-overview-numeric"></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)

Topik ini menjelaskan bagaimana Grafana menangani peringatan pada data numerik daripada deret waktu.

Di antara sumber data tertentu, data numerik yang bukan deret waktu dapat langsung disiagakan, atau diteruskan ke Server Side Expressions (SSE). Hal ini memungkinkan untuk lebih banyak pemrosesan dan menghasilkan efisiensi dalam sumber data, dan juga dapat menyederhanakan aturan peringatan. Saat memperingatkan data numerik alih-alih data deret waktu, tidak perlu mengurangi setiap deret waktu berlabel menjadi satu angka. Sebaliknya, nomor berlabel dikembalikan ke Grafana sebagai gantinya.

## Data tabular
<a name="v10-alerting-numeric-tabular"></a>

Fitur ini didukung dengan sumber data backend yang menanyakan data tabular:
+ Sumber data SQL seperti MySQL, Postgres, MSSQL, dan Oracle.
+ Layanan berbasis Azure Kusto: Azure Monitor (Log), Azure Monitor (Azure Resource Graph), dan Azure Data Explorer.

Kueri dengan peringatan terkelola Grafana atau SSE dianggap numerik dengan sumber data ini, jika:
+ Opsi “Format AS” diatur ke “Tabel” dalam kueri sumber data.
+ Respons tabel yang dikembalikan ke Grafana dari kueri hanya mencakup satu kolom numerik (misalnya int, double, float), dan kolom string tambahan opsional.

Jika ada kolom string, maka kolom tersebut menjadi label. Nama kolom menjadi nama label, dan nilai untuk setiap baris menjadi nilai label yang sesuai. Jika beberapa baris dikembalikan, maka setiap baris harus diidentifikasi secara unik labelnya.

## Contoh
<a name="v10-alerting-numeric-tabexample"></a>

Untuk tabel MySQL yang disebut “”: DiskSpace


| Waktu | Host | Disk | PercentFree | 
| --- | --- | --- | --- | 
| 2021-Juni-7 | web1 | /dll | 3 | 
| 2021-Juni-7 | web2 | /var | 4 | 
| 2021-Juni-7 | web3 | /var | 8 | 
| ... | ... | ... | ... | 

Anda dapat menanyakan pemfilteran data tepat waktu, tetapi tanpa mengembalikan deret waktu ke Grafana. Misalnya, peringatan yang akan memicu per Host, Disk ketika ada kurang dari 5% ruang kosong:

```
SELECT Host , Disk , CASE WHEN PercentFree  < 5.0 THEN PercentFree  ELSE 0 END FROM ( 
       SELECT
          Host, 
          Disk, 
          Avg(PercentFree) 
       FROM DiskSpace
       Group By
          Host, 
          Disk 
       Where __timeFilter(Time)
```

Query ini mengembalikan respon Tabel berikut untuk Grafana:


| Host | Disk | PercentFree | 
| --- | --- | --- | 
| web1 | /dll | 3 | 
| web2 | /var | 4 | 
| web3 | /var | 0 | 

Ketika kueri ini digunakan sebagai **kondisi** dalam aturan peringatan, maka bukan nol akan memperingatkan. Akibatnya, tiga instance peringatan dihasilkan:


| Label | Status | 
| --- | --- | 
| \$1host = web1, disk =/dll\$1 | Peringatan | 
| \$1host = web2, disk =/var\$1 | Peringatan | 
| \$1host = web3, disk =/var\$1 | Normal | 

# Label dan anotasi
<a name="v10-alerting-overview-labels"></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)

Label dan anotasi berisi informasi tentang peringatan. Baik label dan anotasi memiliki struktur yang sama: satu set nilai bernama; namun penggunaan yang dimaksudkan berbeda. Contoh label, atau anotasi yang setara, mungkin`alertname="test"`.

Perbedaan utama antara label dan anotasi adalah label digunakan untuk membedakan peringatan dari semua peringatan lainnya, sementara anotasi digunakan untuk menambahkan informasi tambahan ke peringatan yang ada.

Misalnya, pertimbangkan dua peringatan CPU tinggi: satu untuk `server1` dan satu lagi untuk`server2`. Dalam contoh seperti itu, kita mungkin memiliki label yang disebut `server` di mana peringatan pertama memiliki label `server="server1"` dan peringatan kedua memiliki label`server="server2"`. Namun, kami mungkin juga ingin menambahkan deskripsi ke setiap peringatan seperti`"The CPU usage for server1 is above 75%."`, di `75%` mana `server1` dan diganti dengan nama dan penggunaan CPU server (silakan lihat dokumentasi tentang [Templating label dan anotasi](v10-alerting-overview-labels-templating.md) cara melakukannya). Deskripsi semacam ini akan lebih cocok sebagai anotasi.

## Label
<a name="v10-alerting-overview-labels-labels"></a>

Label berisi informasi yang mengidentifikasi peringatan. Contoh label mungkin`server=server1`. Setiap peringatan dapat memiliki lebih dari satu label, dan set lengkap label untuk peringatan disebut set labelnya. Set label inilah yang mengidentifikasi peringatan.

Misalnya, peringatan mungkin memiliki label yang disetel `{alertname="High CPU usage",server="server1"}` sementara peringatan lain mungkin memiliki label yang disetel`{alertname="High CPU usage",server="server2"}`. Ini adalah dua peringatan terpisah karena meskipun `alertname` labelnya sama, `server` labelnya berbeda.

Label yang ditetapkan untuk peringatan adalah kombinasi label dari sumber data, label khusus dari aturan peringatan, dan sejumlah label yang dicadangkan seperti. `alertname`

**Label Kustom**

Label khusus adalah label tambahan dari aturan peringatan. Seperti anotasi, label khusus harus memiliki nama, dan nilainya dapat berisi kombinasi teks dan kode templat yang dievaluasi saat peringatan diaktifkan. Dokumentasi tentang cara membuat template label kustom dapat ditemukan [di sini](v10-alerting-overview-labels-templating.md).

Saat menggunakan label khusus dengan templat, penting untuk memastikan bahwa nilai label tidak berubah di antara evaluasi berturut-turut dari aturan peringatan karena ini akan menghasilkan sejumlah besar peringatan berbeda. Namun, tidak apa-apa bagi template untuk menghasilkan nilai label yang berbeda untuk peringatan yang berbeda. Misalnya, jangan letakkan nilai kueri di label khusus karena ini akan berakhir dengan membuat kumpulan peringatan baru setiap kali nilainya berubah. Sebagai gantinya gunakan anotasi.

Penting juga untuk memastikan bahwa label yang ditetapkan untuk peringatan tidak memiliki dua atau lebih label dengan nama yang sama. Jika label kustom memiliki nama yang sama dengan label dari sumber data maka label tersebut akan menggantikan label tersebut. Namun, jika label khusus memiliki nama yang sama dengan label yang dicadangkan maka label khusus akan dihilangkan dari peringatan.

## Anotasi
<a name="v10-alerting-overview-labels-annotations"></a>

Anotasi adalah pasangan bernama yang menambahkan informasi tambahan ke peringatan yang ada. Ada sejumlah anotasi yang disarankan di Grafana `description` seperti`summary`,,`runbook_url`, `dashboardUId` dan. `panelId` Seperti label khusus, anotasi harus memiliki nama, dan nilainya dapat berisi kombinasi teks dan kode templat yang dievaluasi saat peringatan diaktifkan. Jika anotasi berisi kode templat, templat dievaluasi sekali saat peringatan diaktifkan. Itu tidak dievaluasi ulang, bahkan ketika peringatan diselesaikan. Dokumentasi tentang cara membuat templat anotasi dapat ditemukan [di sini](v10-alerting-overview-labels-templating.md).

**Topics**
+ [Label](#v10-alerting-overview-labels-labels)
+ [Anotasi](#v10-alerting-overview-labels-annotations)
+ [Cara kerja pencocokan label](v10-alerting-overview-labels-matching.md)
+ [Label di Grafana Alerting](v10-alerting-overview-labels-alerting.md)
+ [Templating label dan anotasi](v10-alerting-overview-labels-templating.md)

# Cara kerja pencocokan label
<a name="v10-alerting-overview-labels-matching"></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)

Gunakan label dan pencocokan label untuk menautkan aturan peringatan ke kebijakan pemberitahuan dan pembungkaman. Ini memungkinkan cara yang sangat fleksibel untuk mengelola instance peringatan Anda, menentukan kebijakan mana yang harus ditangani, dan peringatan mana yang akan dibungkam.

Pencocokan label terdiri dari 3 bagian yang berbeda, **label**, **nilai** dan **operator**.
+ Bidang **Label** adalah nama label yang cocok. Itu harus sama persis dengan nama label.
+ Bidang **Nilai** cocok dengan nilai yang sesuai untuk nama **Label** yang ditentukan. Bagaimana kecocokannya tergantung pada nilai **Operator**.
+ Bidang **Operator** adalah operator yang cocok dengan nilai label. Operator yang tersedia adalah:


| Operator | Deskripsi | 
| --- | --- | 
| `=` | Pilih label yang persis sama dengan nilainya. | 
| `!=` | Pilih label yang tidak sama dengan nilainya. | 
| `=~` | Pilih label yang sesuai dengan nilai regex-nya. | 
| `!~` | Pilih label yang tidak cocok dengan nilai. | 

Jika Anda menggunakan beberapa pencocokan label, mereka digabungkan menggunakan operator logis AND. Ini berarti bahwa semua pencocokan harus cocok untuk menautkan aturan ke kebijakan.

## Contoh
<a name="v10-alerting-overview-labels-matching-ex"></a>

Jika Anda menentukan kumpulan label berikut untuk peringatan Anda:

```
{ foo=bar, baz=qux, id=12 }
```

maka:
+ Pencocokan label yang didefinisikan sebagai `foo=bar` cocok dengan aturan peringatan ini.
+ Pencocokan label yang didefinisikan sebagai `foo!=bar` *tidak* cocok dengan aturan peringatan ini.
+ Pencocokan label yang didefinisikan sebagai `id=~[0-9]+` cocok dengan aturan peringatan ini.
+ Pencocokan label yang didefinisikan sebagai `baz!~[0-9]+` cocok dengan aturan peringatan ini.
+ Dua pencocokan label didefinisikan sebagai `foo=bar` dan `id=~[0-9]+` cocok dengan aturan peringatan ini.

## Kecualikan label
<a name="v10-alerting-overview-labels-matching-exclude"></a>

Anda juga dapat menulis pencocokan label untuk mengecualikan label.

Berikut adalah contoh yang menunjukkan cara mengecualikan label`team`. Anda dapat memilih di antara nilai-nilai ini untuk mengecualikan label.
+ `team=""`
+ `team!~.+`
+ `team=~^$`

# Label di Grafana Alerting
<a name="v10-alerting-overview-labels-alerting"></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)

Topik ini menjelaskan mengapa label merupakan komponen mendasar dari peringatan.
+ Set lengkap label untuk peringatan adalah apa yang secara unik mengidentifikasi peringatan dalam peringatan Grafana.
+ Alertmanager menggunakan label untuk mencocokkan peringatan untuk keheningan dan grup peringatan dalam kebijakan notifikasi.
+ UI peringatan menampilkan label untuk setiap instance peringatan yang dihasilkan selama evaluasi aturan tersebut.
+ Titik kontak dapat mengakses label untuk menghasilkan notifikasi secara dinamis yang berisi informasi khusus untuk peringatan yang menghasilkan pemberitahuan.
+ Anda dapat menambahkan label ke [aturan peringatan](v10-alerting-configure.md). Label dapat dikonfigurasi secara manual, menggunakan fungsi templat, dan dapat mereferensikan label lain. Label yang ditambahkan ke aturan peringatan diutamakan jika terjadi tabrakan antar label (kecuali dalam kasus label yang dicadangkan Grafana, lihat di bawah untuk informasi lebih lanjut).

## Kompatibilitas Alertmanager eksternal
<a name="v10-alerting-overview-labels-alerting-external"></a>

Alertmanager bawaan Grafana mendukung kunci dan nilai label Unicode. [Jika Anda menggunakan Prometheus Alertmanager eksternal, kunci label harus kompatibel dengan model datanya.](https://prometheus.io/docs/concepts/data_model/#metric-names-and-labels) Ini berarti bahwa kunci label hanya boleh berisi **huruf ASCII**, **angka**, serta **garis bawah** dan cocok dengan regex. `[a-zA-Z_][a-zA-Z0-9_]*` Setiap karakter yang tidak valid akan dihapus atau diganti oleh mesin peringatan Grafana sebelum dikirim ke Alertmanager eksternal sesuai dengan aturan berikut:
+ `Whitespace`akan dihapus.
+ `ASCII characters`akan diganti dengan`_`.
+ `All other characters`akan diganti dengan representasi hex huruf kecil mereka. Jika ini adalah karakter pertama, itu akan diawali dengan`_`.

**catatan**  
Jika beberapa kunci label disanitasi ke nilai yang sama, duplikat akan memiliki hash pendek dari label asli yang ditambahkan sebagai akhiran.

## Label yang dipesan Grafana
<a name="v10-alerting-overview-labels-alerting-reserved"></a>

**catatan**  
Label yang diawali dengan `grafana_` dicadangkan oleh Grafana untuk penggunaan khusus. Jika label yang dikonfigurasi secara manual ditambahkan dimulai dengan `grafana_` itu akan ditimpa jika terjadi tabrakan.

Label yang dicadangkan Grafana dapat digunakan dengan cara yang sama seperti label yang dikonfigurasi secara manual. Daftar label cadangan yang tersedia saat ini adalah:


| Label | Deskripsi | 
| --- | --- | 
| grafana\$1folder | Judul folder yang berisi peringatan. | 

# Templating label dan anotasi
<a name="v10-alerting-overview-labels-templating"></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 menggunakan template untuk menyertakan data dari kueri dan ekspresi dalam label dan anotasi. Misalnya, Anda mungkin ingin menyetel label tingkat keparahan untuk peringatan berdasarkan nilai kueri, atau menggunakan label instance dari kueri dalam anotasi ringkasan sehingga Anda tahu server mana yang mengalami penggunaan CPU tinggi.

Semua template harus ditulis dalam [teks/template](https://pkg.go.dev/text/template). Terlepas dari apakah Anda membuat template label atau anotasi, Anda harus menulis setiap templat sebaris di dalam label atau anotasi yang sedang Anda templating. Ini berarti Anda tidak dapat berbagi templat antara label dan anotasi, dan sebagai gantinya Anda harus menyalin templat di mana pun Anda ingin menggunakannya.

Setiap template dievaluasi setiap kali aturan peringatan dievaluasi, dan dievaluasi untuk setiap peringatan secara terpisah. Misalnya, jika aturan peringatan Anda memiliki anotasi ringkasan templat, dan aturan peringatan memiliki 10 peringatan pengaktifan, maka templat akan dieksekusi 10 kali, sekali untuk setiap peringatan. Anda harus mencoba untuk menghindari melakukan perhitungan mahal di template Anda sebanyak mungkin.

## Contoh
<a name="v10-alerting-overview-labels-templating-examples"></a>

Daripada menulis tutorial lengkap tentang text/template, the following examples attempt to show the most common use-cases we have seen for templates. You can use these examples verbatim, or adapt them as necessary for your use case. For more information about how to write text/template melihat dokumentasi [teks/template](https://pkg.go.dev/text/template).

**Cetak semua label, dipisahkan koma**

Untuk mencetak semua label, dipisahkan koma, cetak `$labels` variabel:

```
{{ $labels }}
```

Misalnya, diberi peringatan dengan label`alertname=High CPU usage`, `grafana_folder=CPU alerts` dan`instance=server1`, ini akan mencetak: 

```
alertname=High CPU usage, grafana_folder=CPU alerts, instance=server1
```

**catatan**  
Jika Anda menggunakan kondisi klasik maka tidak `$labels` akan berisi label apa pun dari kueri. Lihat [variabel \$1labels](#v10-alerting-overview-labels-templating-the-labels-variable) untuk informasi lebih lanjut.

**Cetak semua label, satu per baris**

Untuk mencetak semua label, satu per baris, gunakan a `range` untuk mengulangi setiap key/value pasangan dan mencetaknya satu per satu. Di sini `$k` mengacu pada nama dan `$v` mengacu pada nilai label saat ini: 

```
{{ range $k, $v := $labels -}}
{{ $k }}={{ $v }}
{{ end }}
```

Misalnya, diberi peringatan dengan label`alertname=High CPU usage`, `grafana_folder=CPU alerts` dan`instance=server1`, ini akan mencetak:

```
alertname=High CPU usage
grafana_folder=CPU alerts
instance=server1
```

**catatan**  
Jika Anda menggunakan kondisi klasik maka tidak `$labels` akan berisi label apa pun dari kueri. Lihat [variabel \$1labels](#v10-alerting-overview-labels-templating-the-labels-variable) untuk informasi lebih lanjut.

**Cetak label individual**

Untuk mencetak label individual, gunakan `index` fungsi dengan `$labels` variabel: 

```
The host {{ index $labels "instance" }} has exceeded 80% CPU usage for the last 5 minutes
```

Misalnya, diberi peringatan dengan label`instance=server1`, ini akan mencetak:

```
The host server1 has exceeded 80% CPU usage for the last 5 minutes
```

**catatan**  
Jika Anda menggunakan kondisi klasik maka tidak `$labels` akan berisi label apa pun dari kueri. Lihat [variabel \$1labels](#v10-alerting-overview-labels-templating-the-labels-variable) untuk informasi lebih lanjut.

**Mencetak nilai kueri**

Untuk mencetak nilai kueri instan, Anda dapat mencetak ID Ref menggunakan `index` fungsi dan `$values` variabel: 

```
{{ index $values "A" }}
```

Misalnya, diberikan kueri instan yang mengembalikan nilai 81.2345, ini akan mencetak:

```
81.2345
```

Untuk mencetak nilai kueri rentang, Anda harus terlebih dahulu menguranginya dari deret waktu menjadi vektor instan dengan ekspresi pengurangan. Anda kemudian dapat mencetak hasil ekspresi pengurangan dengan menggunakan ID Ref sebagai gantinya. Misalnya, jika ekspresi reduksi mengambil rata-rata A dan memiliki ID Ref B, Anda akan menulis: 

```
{{ index $values "B" }}
```

**Cetak nilai manusiawi dari kueri**

Untuk mencetak nilai manusiawi dari kueri instan, gunakan `humanize` fungsi:

```
{{ humanize (index $values "A").Value }}
```

Misalnya, diberikan kueri instan yang mengembalikan nilai 81.2345, ini akan mencetak: 

```
81.234
```

Untuk mencetak nilai manusiawi dari kueri rentang, Anda harus terlebih dahulu menguranginya dari deret waktu menjadi vektor instan dengan ekspresi pengurangan. Anda kemudian dapat mencetak hasil ekspresi pengurangan dengan menggunakan ID Ref sebagai gantinya. Misalnya, jika ekspresi reduksi mengambil rata-rata A dan memiliki ID Ref B, Anda akan menulis: 

```
{{ humanize (index $values "B").Value }}
```

**Cetak nilai kueri sebagai persentase**

Untuk mencetak nilai kueri instan sebagai persentase, gunakan `humanizePercentage` fungsi:

```
{{ humanizePercentage (index $values "A").Value }}
```

Fungsi ini mengharapkan nilai menjadi angka desimal antara 0 dan 1. Jika nilainya bukan angka desimal antara 0 dan 100, Anda dapat membaginya dengan 100 baik dalam kueri Anda atau menggunakan ekspresi matematika. Jika kueri adalah kueri rentang, Anda harus terlebih dahulu menguranginya dari deret waktu menjadi vektor instan dengan ekspresi pengurangan.

**Tetapkan tingkat keparahan dari nilai kueri**

Untuk menetapkan label keparahan dari nilai kueri gunakan pernyataan if dan fungsi lebih besar dari perbandingan. Pastikan untuk menggunakan desimal (`80.0`,, `50.0``0.0`, dll) saat melakukan perbandingan terhadap `$values` as text/template tidak mendukung pemaksaan tipe. Anda dapat menemukan daftar semua fungsi perbandingan yang didukung [di sini](https://pkg.go.dev/text/template#hdr-Functions).

```
{{ if (gt $values.A.Value 80.0) -}}
high
{{ else if (gt $values.A.Value 50.0) -}}
medium
{{ else -}}
low
{{- end }}
```

**Cetak semua label dari kondisi klasik**

Anda tidak dapat menggunakan `$labels` untuk mencetak label dari kueri jika Anda menggunakan kondisi klasik, dan harus menggunakannya `$values` sebagai gantinya. Alasan untuk ini adalah kondisi klasik buang label ini untuk menegakkan perilaku uni-dimensi (paling banyak satu peringatan per aturan peringatan). Jika kondisi klasik tidak membuang label ini, maka kueri yang mengembalikan banyak deret waktu akan menyebabkan peringatan menutup antara penembakan dan diselesaikan terus-menerus karena label akan berubah setiap kali aturan peringatan dievaluasi.

Sebagai gantinya, `$values` variabel berisi nilai yang dikurangi dari semua deret waktu untuk semua kondisi yang menyala. Misalnya, jika Anda memiliki aturan peringatan dengan kueri A yang mengembalikan dua deret waktu, dan kondisi klasik B dengan dua kondisi, maka `$values` akan berisi`B0`,`B1`, `B2` dan`B3`. Jika kondisi klasik B hanya memiliki satu kondisi, maka `$values` akan berisi just `B0` dan`B1`.

Untuk mencetak semua label dari semua deret waktu pengaktifan, gunakan templat berikut (pastikan untuk mengganti `B` dalam ekspresi reguler dengan ID Ref dari kondisi klasik jika berbeda): 

```
{{ range $k, $v := $values -}}
{{ if (match "B[0-9]+" $k) -}}
{{ $k }}: {{ $v.Labels }}{{ end }}
{{ end }}
```

Misalnya, kondisi klasik untuk dua deret waktu yang melebihi satu kondisi akan dicetak: 

```
B0: instance=server1
B1: instance=server2
```

Jika kondisi klasik memiliki dua kondisi atau lebih, dan deret waktu melebihi beberapa kondisi pada saat yang sama, maka labelnya akan diduplikasi untuk setiap kondisi yang terlampaui: 

```
B0: instance=server1
B1: instance=server2
B2: instance=server1
B3: instance=server2
```

Jika Anda perlu mencetak label unik, Anda harus mempertimbangkan untuk mengubah aturan peringatan Anda dari uni-dimensi ke multi-dimensi sebagai gantinya. Anda dapat melakukan ini dengan mengganti kondisi klasik Anda dengan ekspresi reduce dan matematika.

**Cetak semua nilai dari kondisi klasik**

Untuk mencetak semua nilai dari kondisi klasik, ambil contoh sebelumnya dan ganti `$v.Labels` dengan`$v.Value`: 

```
{{ range $k, $v := $values -}}
{{ if (match "B[0-9]+" $k) -}}
{{ $k }}: {{ $v.Value }}{{ end }}
{{ end }}
```

Misalnya, kondisi klasik untuk dua deret waktu yang melebihi satu kondisi akan dicetak: 

```
B0: 81.2345
B1: 84.5678
```

Jika kondisi klasik memiliki dua atau lebih kondisi, dan deret waktu melebihi beberapa kondisi pada saat yang sama, maka `$values` akan berisi nilai-nilai semua kondisi: 

```
B0: 81.2345
B1: 92.3456
B2: 84.5678
B3: 95.6789
```

## Variabel
<a name="v10-alerting-overview-labels-templating-variables"></a>

Variabel berikut tersedia untuk Anda saat membuat template label dan anotasi:

### Variabel label
<a name="v10-alerting-overview-labels-templating-the-labels-variable"></a>

`$labels`Variabel berisi semua label dari kueri. Misalnya, Anda memiliki kueri yang mengembalikan penggunaan CPU untuk semua server Anda, dan Anda memiliki aturan peringatan yang diaktifkan ketika salah satu server Anda telah melebihi 80% penggunaan CPU selama 5 menit terakhir. Anda ingin menambahkan anotasi ringkasan ke peringatan yang memberi tahu Anda server mana yang mengalami penggunaan CPU tinggi. Dengan `$labels` variabel Anda dapat menulis template yang mencetak kalimat yang dapat dibaca manusia seperti: 

```
CPU usage for {{ index $labels "instance" }} has exceeded 80% for the last 5 minutes
```

**catatan**  
Jika Anda menggunakan kondisi klasik maka tidak `$labels` akan berisi label apa pun dari kueri. Kondisi klasik membuang label ini untuk menegakkan perilaku uni-dimensi (paling banyak satu peringatan per aturan peringatan). Jika Anda ingin menggunakan label dari kueri di template Anda, ikuti contoh *Print all labels sebelumnya dari kondisi klasik*.

### Variabel nilai
<a name="v10-alerting-overview-labels-templating-the-value-variable"></a>

`$value`Variabel adalah string yang berisi label dan nilai dari semua kueri instan; ambang batas, pengurangan dan ekspresi matematika, dan kondisi klasik dalam aturan peringatan. Ini tidak berisi hasil kueri rentang, karena ini dapat kembali dari 10 hingga 10.000 baris atau metrik. Jika ya, untuk kueri yang sangat besar, satu peringatan dapat menggunakan memori 10 detik dan Grafana akan kehabisan memori dengan sangat cepat. MBs 

Untuk mencetak `$value` variabel dalam ringkasan Anda akan menulis sesuatu seperti ini: 

```
CPU usage for {{ index $labels "instance" }} has exceeded 80% for the last 5 minutes: {{ $value }}
```

Dan itu akan terlihat seperti ini:

```
CPU usage for instance1 has exceeded 80% for the last 5 minutes: [ var='A' labels={instance=instance1} value=81.234 ]
```

Di sini `var='A'` mengacu pada kueri instan dengan Ref ID A, `labels={instance=instance1}` mengacu pada label, dan `value=81.234` mengacu pada penggunaan CPU rata-rata selama 5 menit terakhir.

Jika Anda ingin mencetak hanya beberapa string alih-alih string penuh maka gunakan `$values` variabel. Ini berisi informasi yang sama seperti`$value`, tetapi dalam tabel terstruktur, dan jauh lebih mudah digunakan kemudian menulis ekspresi reguler untuk mencocokkan hanya teks yang Anda inginkan.

### Variabel nilai
<a name="v10-alerting-overview-labels-templating-the-values-variable"></a>

`$values`Variabel adalah tabel yang berisi label dan nilai floating point dari semua kueri dan ekspresi instan, diindeks oleh Ref mereka. IDs

Untuk mencetak nilai kueri instan dengan Ref ID A:

```
CPU usage for {{ index $labels "instance" }} has exceeded 80% for the last 5 minutes: {{ index $values "A" }}
```

Misalnya, diberi peringatan dengan label `instance=server1` dan kueri instan dengan nilai`81.2345`, ini akan mencetak:

```
CPU usage for instance1 has exceeded 80% for the last 5 minutes: 81.2345
```

Jika kueri di Ref ID A adalah kueri rentang daripada kueri instan, tambahkan ekspresi pengurangan dengan Ref ID B dan ganti `(index $values "A")` dengan: `(index $values "B")`

```
CPU usage for {{ index $labels "instance" }} has exceeded 80% for the last 5 minutes: {{ index $values "B" }}
```

## Fungsi
<a name="v10-alerting-overview-labels-templating-functions"></a>

Fungsi-fungsi berikut tersedia untuk Anda saat membuat template label dan anotasi:

**args**

`args`Fungsi menerjemahkan daftar objek ke peta dengan kunci arg0, arg1 dll. Ini dimaksudkan untuk memungkinkan beberapa argumen diteruskan ke template.

```
{{define "x"}}{{.arg0}} {{.arg1}}{{end}}{{template "x" (args 1 "2")}}
```

```
1 2
```

**URL eksternal**

`externalURL`Fungsi mengembalikan URL eksternal dari server Grafana.

```
{{ externalURL }}
```

```
https://example.com/grafana
```

**GraphLink**

`graphLink`Fungsi mengembalikan path ke tampilan grafis [Jelajahi di Grafana versi 10](v10-explore.md) untuk ekspresi yang diberikan dan sumber data.

```
{{ graphLink "{\"expr\": \"up\", \"datasource\": \"gdev-prometheus\"}" }}
```

```
/explore?left=["now-1h","now","gdev-prometheus",{"datasource":"gdev-prometheus","expr":"up","instant":false,"range":true}]
```

**memanusiakan**

`humanize`Fungsi memanusiakan angka desimal.

```
{{ humanize 1000.0 }}
```

```
1k
```

**manusia1024**

`humanize1024`Karya-karya yang mirip dengan `humanize` tetapi menggunakan 1024 sebagai basis daripada 1000.

```
{{ humanize1024 1024.0 }}
```

```
1ki
```

**HumanizeUrasi**

`humanizeDuration`Fungsi memanusiakan durasi dalam hitungan detik.

```
{{ humanizeDuration 60.0 }}
```

```
1m 0s
```

**HumanizePersentase**

`humanizePercentage`Fungsi memanusiakan nilai rasio terhadap persentase.

```
{{ humanizePercentage 0.2 }}
```

```
20%
```

**HumanizeTimestamp**

`humanizeTimestamp`Fungsi ini memanusiakan stempel waktu Unix.

```
{{ humanizeTimestamp 1577836800.0 }}
```

```
2020-01-01 00:00:00 +0000 UTC
```

**pertandingan**

`match`Fungsi ini cocok dengan teks terhadap pola ekspresi reguler.

```
{{ match "a.*" "abc" }}
```

```
true
```

**PathPrefix**

`pathPrefix`Fungsi mengembalikan jalur server Grafana.

```
{{ pathPrefix }}
```

```
/grafana
```

**TableLink**

`tableLink`Fungsi mengembalikan path ke tampilan tabular [Jelajahi di Grafana versi 10](v10-explore.md) untuk ekspresi yang diberikan dan sumber data.

```
{{ tableLink "{\"expr\": \"up\", \"datasource\": \"gdev-prometheus\"}" }}
```

```
/explore?left=["now-1h","now","gdev-prometheus",{"datasource":"gdev-prometheus","expr":"up","instant":true,"range":false}]
```

**judul**

`title`Fungsi ini mengkapitalisasi karakter pertama dari setiap kata.

```
{{ title "hello, world!" }}
```

```
Hello, World!
```

**ToLower**

`toLower`Fungsi mengembalikan semua teks dalam huruf kecil.

```
{{ toLower "Hello, world!" }}
```

```
hello, world!
```

**TouPper**

`toUpper`Fungsi mengembalikan semua teks dalam huruf besar.

```
{{ toUpper "Hello, world!" }}
```

```
HELLO, WORLD!
```

**reReplaceAll**

`reReplaceAll`Fungsi menggantikan teks yang cocok dengan ekspresi reguler.

```
{{ reReplaceAll "localhost:(.*)" "example.com:$1" "localhost:8080" }}
```

```
example.com:8080
```

# Tentang aturan peringatan
<a name="v10-alerting-explore-rules"></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)

Aturan peringatan adalah seperangkat kriteria evaluasi yang menentukan apakah instance peringatan akan diaktifkan. Aturan terdiri dari satu atau lebih pertanyaan dan ekspresi, kondisi, frekuensi evaluasi, dan durasi di mana kondisi harus dipenuhi untuk mulai menembak.

Sementara kueri dan ekspresi memilih kumpulan data untuk dievaluasi, *kondisi* menetapkan ambang batas yang harus dipenuhi atau dilampaui data untuk membuat peringatan.

*Interval* menentukan seberapa sering aturan peringatan dievaluasi. *Durasi*, ketika dikonfigurasi, menunjukkan berapa lama suatu kondisi harus dipenuhi. Aturan peringatan juga dapat menentukan perilaku peringatan tanpa adanya data.

**Topics**
+ [Jenis aturan peringatan](v10-alerting-explore-rules-types.md)
+ [Aturan perekaman](v10-alerting-explore-rule-recording.md)
+ [Pertanyaan dan kondisi](v10-alerting-explore-rules-queries.md)
+ [Contoh peringatan](v10-alerting-rules-instances.md)
+ [Ruang nama, folder, dan grup](v10-alerting-rules-grouping.md)
+ [Evaluasi aturan peringatan](v10-alerting-rules-evaluation.md)
+ [Keadaan dan kesehatan aturan peringatan](v10-alerting-explore-state.md)
+ [Templating pemberitahuan](v10-alerting-rules-notification-templates.md)

# Jenis aturan peringatan
<a name="v10-alerting-explore-rules-types"></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)

Grafana mendukung beberapa jenis aturan peringatan. Pelajari lebih lanjut tentang masing-masing jenis aturan peringatan, cara kerjanya, dan putuskan mana yang terbaik untuk kasus penggunaan Anda.

## Aturan terkelola Grafana
<a name="v10-alerting-explore-rule-types-grafana"></a>

Aturan terkelola Grafana adalah jenis aturan peringatan yang paling fleksibel. Mereka memungkinkan Anda membuat peringatan yang dapat bertindak berdasarkan data dari sumber data apa pun yang ada.

Selain mendukung beberapa sumber data, Anda dapat menambahkan [ekspresi](v10-panels-query-xform-expressions.md) untuk mengubah data Anda dan menyatakan kondisi peringatan.

Di Grafana, peringatan terkelola:
+ Aturan peringatan dibuat dalam Grafana, berdasarkan satu atau beberapa sumber data.
+ Aturan peringatan dievaluasi oleh mesin evaluasi aturan peringatan dari dalam Grafana.
+ Peringatan dikirimkan menggunakan Grafana Alertmanager internal.

**catatan**  
Anda juga dapat mengonfigurasi peringatan yang akan dikirimkan menggunakan Alertmanager eksternal, atau menggunakan Alertmanager internal dan eksternal. Untuk informasi selengkapnya, lihat [Menambahkan alertmanager eksternal](v10-alerting-setup-alertmanager.md).

## Aturan terkelola sumber data
<a name="v10-alerting-explore-rule-types-datasource"></a>

Untuk membuat aturan peringatan terkelola sumber data, Anda harus memiliki sumber data Prometheus atau Loki yang kompatibel. Anda dapat memeriksa apakah sumber data Anda mendukung pembuatan aturan melalui Grafana dengan menguji sumber data dan mengamati apakah Ruler API didukung.

Di sumber data, peringatan terkelola:
+ Aturan peringatan dibuat dan disimpan dalam sumber data itu sendiri.
+ Aturan peringatan hanya dapat dibuat berdasarkan data Prometheus.
+ Evaluasi dan pengiriman aturan peringatan didistribusikan di beberapa node untuk ketersediaan tinggi dan toleransi kesalahan.

## Pilih jenis aturan peringatan
<a name="v10-alerting-explore-rule-types-choose"></a>

Saat memilih jenis aturan peringatan yang akan digunakan, pertimbangkan perbandingan berikut antara aturan peringatan terkelola Grafana dan aturan peringatan terkelola sumber data.


| Fitur | Aturan peringatan yang dikelola Grafana | Aturan peringatan yang dikelola Loki/MIMIR | 
| --- | --- | --- | 
| Buat aturan peringatan berdasarkan data dari salah satu sumber data kami yang didukung | Ya | Tidak: Anda hanya dapat membuat aturan peringatan yang didasarkan pada data Prometheus. Sumber data harus mengaktifkan Ruler API.  | 
| Mencampur dan mencocokkan sumber data | Ya | Tidak | 
| Termasuk dukungan untuk aturan perekaman | Tidak | Ya | 
| Tambahkan ekspresi untuk mengubah data Anda dan mengatur kondisi peringatan | Ya | Tidak | 
| Gunakan gambar dalam notifikasi peringatan | Ya | Tidak | 
| Penskalaan | Lebih intensif sumber daya, tergantung pada database, dan cenderung menderita kesalahan sementara. Mereka hanya menskalakan secara vertikal. | Simpan aturan peringatan dalam sumber data itu sendiri dan izinkan penskalaan “tak terbatas”. Buat dan kirim pemberitahuan peringatan dari lokasi data Anda. | 
| Evaluasi dan pengiriman aturan peringatan | Evaluasi dan pengiriman aturan peringatan dilakukan dari dalam Grafana, menggunakan Alertmanager eksternal; atau keduanya. | Evaluasi aturan peringatan dan pengiriman peringatan didistribusikan, artinya tidak ada satu titik kegagalan. | 

# Aturan perekaman
<a name="v10-alerting-explore-rule-recording"></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)

*Aturan perekaman hanya tersedia untuk sumber data Prometheus atau Loki yang kompatibel.*

Aturan perekaman memungkinkan Anda untuk menghitung terlebih dahulu ekspresi yang sering dibutuhkan atau mahal secara komputasi dan menyimpan hasilnya sebagai rangkaian waktu baru. Ini berguna jika Anda ingin menjalankan peringatan pada data agregat atau jika Anda memiliki dasbor yang menanyakan ekspresi mahal secara komputasi berulang kali.

Menanyakan deret waktu baru ini lebih cepat, terutama untuk dasbor karena mereka menanyakan ekspresi yang sama setiap kali dasbor disegarkan.

Baca lebih lanjut tentang [aturan perekaman](https://prometheus.io/docs/prometheus/latest/configuration/recording_rules/) di Prometheus.

# Pertanyaan dan kondisi
<a name="v10-alerting-explore-rules-queries"></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)

Di Grafana, kueri memainkan peran penting dalam mengambil dan mengubah data dari sumber data yang didukung, yang mencakup database seperti MySQL dan PostgreSQL, database deret waktu seperti Prometheus, InfluxDB dan Graphite, dan layanan seperti, Amazon, Azure Monitor dan Google Cloud Monitoring. OpenSearch CloudWatch

Untuk informasi selengkapnya tentang sumber data yang didukung, lihat[Sumber data dan peringatan Grafana](v10-alerting-overview-datasources.md).

Proses mengeksekusi query melibatkan mendefinisikan sumber data, menentukan data yang diinginkan untuk diambil, dan menerapkan filter atau transformasi yang relevan. Bahasa kueri atau sintaks khusus untuk sumber data yang dipilih digunakan untuk membangun kueri ini.

Dalam Peringatan, Anda menentukan kueri untuk mendapatkan data yang ingin Anda ukur dan kondisi yang perlu dipenuhi sebelum aturan peringatan diaktifkan.

Aturan peringatan terdiri dari satu atau beberapa kueri dan ekspresi yang memilih data yang ingin Anda ukur.

Untuk informasi selengkapnya tentang kueri dan ekspresi, lihat[Kueri dan transformasi data](v10-panels-query-xform.md).

## Kueri sumber data
<a name="v10-alerting-explore-rules-queries-data-source-queries"></a>

Kueri di Grafana dapat diterapkan dengan berbagai cara, tergantung pada sumber data dan bahasa kueri yang digunakan. Setiap editor kueri sumber data menyediakan antarmuka pengguna yang disesuaikan yang membantu Anda menulis kueri yang memanfaatkan kemampuan uniknya.

Karena perbedaan antara bahasa kueri, setiap editor kueri sumber data terlihat dan berfungsi secara berbeda. Bergantung pada sumber data Anda, editor kueri mungkin menyediakan fitur pelengkapan otomatis, nama metrik, saran variabel, atau antarmuka pembuatan kueri visual.

Beberapa jenis komponen kueri yang umum meliputi: 

**Bidang metrik atau data** — Tentukan metrik atau bidang data tertentu yang ingin Anda ambil, seperti penggunaan CPU, lalu lintas jaringan, atau pembacaan sensor.

**Rentang waktu** - Tentukan rentang waktu yang ingin Anda ambil data, seperti jam terakhir, hari tertentu, atau rentang waktu khusus.

**Filter** — Terapkan filter untuk mempersempit data berdasarkan kriteria tertentu, seperti memfilter data dengan tag, host, atau aplikasi tertentu.

**Agregasi** — Lakukan agregasi pada data untuk menghitung metrik seperti rata-rata, jumlah, atau hitungan selama periode waktu tertentu.

**Pengelompokan** — Kelompokkan data berdasarkan dimensi atau tag tertentu untuk membuat tampilan atau rincian gabungan.

**catatan**  
Grafana tidak mendukung kueri peringatan dengan variabel template. Informasi lebih lanjut tersedia [di sini](https://community.grafana.com/t/template-variables-are-not-supported-in-alert-queries-while-setting-up-alert/2514) di forum Grafana Labs.

## Kueri ekspresi
<a name="v10-alerting-explore-rules-queries-expression-queries"></a>

Dalam Grafana, ekspresi digunakan untuk melakukan perhitungan, transformasi, atau agregasi pada data kueri sumber data. Ini memungkinkan Anda untuk membuat metrik khusus atau memodifikasi metrik yang ada berdasarkan operasi matematika, fungsi, atau ekspresi logis.

Dengan memanfaatkan kueri ekspresi, pengguna dapat melakukan tugas-tugas seperti menghitung persentase perubahan antara dua nilai, menerapkan fungsi seperti fungsi logaritmik atau trigonometri, menggabungkan data pada rentang waktu atau dimensi tertentu, dan menerapkan logika bersyarat untuk menangani skenario yang berbeda.

Di Peringatan, Anda hanya dapat menggunakan ekspresi untuk aturan peringatan yang dikelola Grafana. Untuk setiap ekspresi, Anda dapat memilih dari ekspresi matematika, kurangi, dan sampel ulang. Ini disebut aturan multi-dimensi, karena mereka menghasilkan peringatan terpisah untuk setiap seri.

Anda juga dapat menggunakan kondisi klasik, yang membuat aturan peringatan yang memicu peringatan tunggal ketika kondisinya terpenuhi. Akibatnya, Grafana hanya mengirimkan satu peringatan bahkan ketika kondisi peringatan terpenuhi untuk beberapa seri.

**catatan**  
Kondisi klasik ada terutama untuk alasan kompatibilitas dan harus dihindari jika memungkinkan.

**Mengurangi**

Mengagregat nilai deret waktu dalam rentang waktu yang dipilih menjadi satu nilai.

**Matematika**

Melakukan matematika bentuk bebas functions/operations pada deret waktu dan data angka. Dapat digunakan untuk memproses data deret waktu atau untuk menentukan kondisi peringatan untuk data angka.

**Sampel ulang**

Menyelaraskan kembali rentang waktu ke set stempel waktu baru, ini berguna saat membandingkan data deret waktu dari sumber data yang berbeda di mana stempel waktu tidak akan sejajar.

**Ambang**

Memeriksa apakah ada data deret waktu yang cocok dengan kondisi ambang batas.

Ekspresi ambang memungkinkan Anda membandingkan dua nilai tunggal. Ia kembali `0` ketika kondisinya salah dan `1` jika kondisinya benar. Fungsi ambang berikut tersedia:
+ Di atas (x> y)
+ Di bawah ini (x < y)
+ Berada dalam jangkauan (x> y1 DAN x < y2)
+ Berada di luar jangkauan (x < y1 AND x > y2)

**Kondisi klasik**

Memeriksa apakah ada data deret waktu yang cocok dengan kondisi peringatan.

**catatan**  
Kueri ekspresi kondisi klasik selalu menghasilkan satu instance peringatan saja, tidak peduli berapa banyak deret waktu yang memenuhi kondisi tersebut. Kondisi klasik ada terutama untuk alasan kompatibilitas dan harus dihindari jika memungkinkan.

## Agregasi
<a name="v10-alerting-explore-rules-queries-aggregations"></a>

Grafana Alerting menyediakan fungsi agregasi berikut untuk memungkinkan Anda menyempurnakan kueri lebih lanjut.

Fungsi-fungsi ini hanya tersedia untuk ekspresi **kondisi **Reduce** dan Classic**.


| Fungsi | Ekspresi | Apa yang dilakukannya | 
| --- | --- | --- | 
| rata-rata | Kurangi/Klasik | Menampilkan rata-rata nilai | 
| min | Kurangi/Klasik | Menampilkan nilai terendah | 
| max | Kurangi/Klasik | Menampilkan nilai tertinggi | 
| sum | Kurangi/Klasik | Menampilkan jumlah semua nilai | 
| count | Kurangi/Klasik | Menghitung jumlah nilai dalam hasil | 
| last | Kurangi/Klasik | Menampilkan nilai terakhir | 
| median | Kurangi/Klasik | Menampilkan nilai median | 
| diff | Klasik | Menampilkan perbedaan antara nilai terbaru dan terlama | 
| diff\$1abs | Klasik | Menampilkan nilai absolut diff | 
| percent\$1diff | Klasik | Menampilkan nilai persentase perbedaan antara nilai terbaru dan tertua | 
| percent\$1diff\$1abs | Klasik | Menampilkan nilai absolut dari percent\$1diff | 
| count\$1non\$1null | Klasik | Menampilkan hitungan nilai dalam kumpulan hasil yang tidak null | 

## Kondisi peringatan
<a name="v10-alerting-explore-rules-queries-alert-condition"></a>

Kondisi peringatan adalah kueri atau ekspresi yang menentukan apakah peringatan akan diaktifkan atau tidak tergantung pada nilai yang dihasilkannya. Hanya ada satu kondisi yang akan menentukan pemicu peringatan.

Setelah Anda menentukan and/or ekspresi kueri Anda, pilih salah satunya sebagai kondisi aturan peringatan.

Ketika data kueri memenuhi kondisi yang ditentukan, Grafana memicu peringatan terkait, yang dapat dikonfigurasi untuk mengirim pemberitahuan melalui berbagai saluran seperti email, Slack, atau. PagerDuty Pemberitahuan memberi tahu Anda tentang kondisi yang dipenuhi, memungkinkan Anda untuk mengambil tindakan yang sesuai atau menyelidiki masalah yang mendasarinya.

Secara default, ekspresi terakhir yang ditambahkan digunakan sebagai kondisi peringatan.

## Ambang pemulihan
<a name="v10-alerting-explore-rules-queries-recovery-threshold"></a>

Untuk mengurangi kebisingan peringatan mengepak, Anda dapat mengatur ambang pemulihan yang berbeda dengan ambang peringatan.

Peringatan mengepak terjadi ketika metrik melayang di sekitar kondisi ambang peringatan dan dapat menyebabkan perubahan status yang sering, mengakibatkan terlalu banyak notifikasi yang dihasilkan.

Aturan peringatan yang dikelola Grafana dievaluasi untuk interval waktu tertentu. Selama setiap evaluasi, hasil kueri diperiksa terhadap ambang batas yang ditetapkan dalam aturan peringatan. Jika nilai metrik berada di atas ambang batas, aturan peringatan akan diaktifkan dan pemberitahuan dikirim. Ketika nilai berada di bawah ambang batas dan ada peringatan aktif untuk metrik ini, peringatan diselesaikan, dan pemberitahuan lain dikirim.

Mungkin sulit untuk membuat aturan peringatan untuk metrik yang bising. Yaitu, ketika nilai metrik terus berjalan di atas dan di bawah ambang batas. Ini disebut mengepak dan menghasilkan serangkaian pemberitahuan penembakan - diselesaikan - penembakan dan riwayat status peringatan yang bising.

Misalnya, jika Anda memiliki peringatan untuk latensi dengan ambang 1000ms dan jumlahnya berfluktuasi sekitar 1000 (katakanlah 980 -> 1010 -> 990 -> 1020, dan seterusnya) maka masing-masing akan memicu pemberitahuan.

Untuk mengatasi masalah ini, Anda dapat menetapkan ambang pemulihan (kustom), yang pada dasarnya berarti memiliki dua ambang, bukan satu. Peringatan dipicu ketika ambang pertama dilintasi dan diselesaikan hanya ketika ambang kedua dilintasi.

Misalnya, Anda dapat menetapkan ambang 1000ms dan ambang pemulihan 900 ms. Dengan cara ini, aturan peringatan hanya akan berhenti menembak ketika berada di bawah 900 ms dan kepakan berkurang.

# Contoh peringatan
<a name="v10-alerting-rules-instances"></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)

Peringatan terkelola Grafana mendukung peringatan multi-dimensi. Setiap aturan peringatan dapat membuat beberapa instance peringatan. Ini sangat kuat jika Anda mengamati beberapa seri dalam satu ekspresi.

Pertimbangkan ekspresi PromQL berikut:

```
sum by(cpu) (
  rate(node_cpu_seconds_total{mode!="idle"}[1m])
)
```

Aturan yang menggunakan ekspresi ini akan membuat instance peringatan sebanyak jumlah yang CPUs kita amati setelah evaluasi pertama, memungkinkan satu aturan untuk melaporkan status setiap CPU.

# Ruang nama, folder, dan grup
<a name="v10-alerting-rules-grouping"></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)

Peringatan dapat diatur menggunakan folder untuk aturan dan ruang nama yang dikelola Grafana untuk aturan dan nama grup Mimir, Loki, atau Prometheus.

**Ruang nama dan folder**

Saat membuat aturan yang dikelola Grafana, folder dapat digunakan untuk melakukan kontrol akses dan memberikan atau menolak akses ke semua aturan dalam folder tertentu.

Namespace berisi satu atau lebih grup. Aturan dalam grup dijalankan secara berurutan pada interval reguler. Interval default adalah satu menit. Anda dapat mengganti nama ruang nama dan grup aturan Grafana Mimi atau Loki, dan mengedit interval evaluasi grup.

**Grup**

Aturan dalam grup dijalankan secara berurutan pada interval reguler, yang berarti tidak ada aturan yang akan dievaluasi pada saat yang sama, dan dalam urutan penampilan. Interval default adalah satu menit. Anda dapat mengganti nama ruang nama aturan Grafana Mimir atau Loki atau ruang nama dan grup aturan Loki, dan mengedit interval evaluasi grup.

**Tip**  
Jika Anda ingin aturan dievaluasi secara bersamaan dan dengan interval yang berbeda, pertimbangkan untuk menyimpannya dalam kelompok yang berbeda.

**catatan**  
Aturan peringatan terkelola Grafana dievaluasi secara bersamaan, bukan secara berurutan.

# Evaluasi aturan peringatan
<a name="v10-alerting-rules-evaluation"></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)

Gunakan evaluasi aturan peringatan untuk menentukan seberapa sering aturan peringatan harus dievaluasi dan seberapa cepat aturan tersebut harus mengubah statusnya.

Untuk melakukan ini, Anda perlu memastikan bahwa aturan peringatan Anda berada di grup evaluasi yang tepat dan menetapkan waktu periode tertunda yang paling sesuai untuk kasus penggunaan Anda.

## Kelompok evaluasi
<a name="v10-alerting-rules-evaluation-group"></a>

Setiap aturan peringatan adalah bagian dari kelompok evaluasi. Setiap kelompok evaluasi berisi interval evaluasi yang menentukan seberapa sering aturan peringatan diperiksa.

Aturan peringatan **terkelola sumber data** dalam grup yang sama dievaluasi satu demi satu, sementara aturan peringatan di grup yang berbeda dapat dievaluasi secara bersamaan. Fitur ini sangat berguna ketika Anda ingin memastikan bahwa aturan perekaman dievaluasi sebelum aturan peringatan apa pun.

Aturan peringatan yang **dikelola Grafana** dievaluasi pada saat yang sama, terlepas dari grup aturan peringatan. Interval evaluasi default diatur pada 10 detik, yang berarti bahwa aturan peringatan yang dikelola Grafana dievaluasi setiap 10 detik ke jendela 10 detik terdekat pada jam, misalnya, 10:00:00, 10:00:10, 10:00:20, dan seterusnya. Anda juga dapat mengonfigurasi interval evaluasi Anda sendiri, jika diperlukan.

**catatan**  
Grup evaluasi dan pengelompokan peringatan dalam kebijakan notifikasi adalah dua hal yang terpisah. Pengelompokan dalam kebijakan notifikasi memungkinkan beberapa lansiran yang berbagi label yang sama dikirim dalam pesan waktu yang sama.

## Periode tertunda
<a name="v10-alerting-rules-evaluation-pending-period"></a>

Dengan menetapkan periode tertunda, Anda dapat menghindari peringatan yang tidak perlu untuk masalah sementara.

Dalam periode tertunda, Anda memilih periode di mana aturan peringatan dapat melanggar kondisi sampai menyala.

**Contoh**

Bayangkan Anda memiliki interval evaluasi aturan peringatan yang ditetapkan setiap 30 detik dan periode tertunda hingga 90 detik.

Evaluasi akan terjadi sebagai berikut:

[00:30] Evaluasi pertama - kondisi tidak terpenuhi.

[01:00] Evaluasi kedua - kondisi dilanggar. Penghitung tertunda dimulai. **Peringatan mulai tertunda.**

[01:30] Evaluasi ketiga - kondisi dilanggar. Penghitung tertunda = 30-an. **Status tertunda.**

[02:00] Evaluasi keempat - kondisi dilanggar. Penghitung tertunda = 60an **Status tertunda.**

[02:30] Evaluasi kelima - kondisi dilanggar. Penghitung tertunda = 90-an. **Peringatan mulai menembak**

Jika aturan peringatan memiliki kondisi yang perlu dilanggar untuk jangka waktu tertentu sebelum mengambil tindakan, maka statusnya berubah sebagai berikut:
+ Ketika kondisi pertama kali dilanggar, aturan masuk ke status “tertunda”.
+ Aturan tetap dalam keadaan “tertunda” sampai kondisi telah dilanggar untuk jumlah waktu yang diperlukan - periode tertunda.
+ Setelah waktu yang diperlukan berlalu, aturan masuk ke keadaan “menembak”.
+ Jika kondisi tidak lagi rusak selama periode tertunda, aturan kembali ke keadaan normal.

**catatan**  
Jika Anda ingin melewati status tertunda, Anda cukup mengatur periode tertunda ke 0. Ini secara efektif melewatkan periode tertunda dan aturan peringatan Anda akan mulai menyala segera setelah kondisi dilanggar.

Saat aturan peringatan diaktifkan, instance peringatan akan dihasilkan, yang kemudian dikirim ke Alertmanager.

# Keadaan dan kesehatan aturan peringatan
<a name="v10-alerting-explore-state"></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)

Keadaan dan kesehatan aturan peringatan membantu Anda memahami beberapa indikator status utama tentang peringatan Anda.

Ada tiga komponen utama: *status aturan peringatan, status* *instance peringatan*, dan *kesehatan aturan peringatan*. Meskipun terkait, setiap komponen menyampaikan informasi yang sedikit berbeda.

**Status aturan peringatan**

Aturan peringatan dapat berada di salah satu status berikut:


| Status | Deskripsi | 
| --- | --- | 
| Normal | Tak satu pun dari deret waktu yang dikembalikan oleh mesin evaluasi dalam `Firing` keadaan `Pending` atau. | 
| Tertunda | Setidaknya satu deret waktu yang dikembalikan oleh mesin evaluasi adalah`Pending`. | 
| Menembak | Setidaknya satu deret waktu yang dikembalikan oleh mesin evaluasi adalah`Firing`. | 

**catatan**  
Peringatan akan bertransisi pertama ke `pending` dan kemudian`firing`, sehingga akan membutuhkan setidaknya dua siklus evaluasi sebelum peringatan diaktifkan.

**Status contoh peringatan**

Instance peringatan dapat berada di salah satu status berikut:


| Status | Deskripsi | 
| --- | --- | 
| Normal | Keadaan peringatan yang tidak menembak atau tertunda, semuanya berfungsi dengan benar. | 
| Tertunda | Status peringatan yang telah aktif kurang dari durasi ambang batas yang dikonfigurasi. | 
| Peringatan | Status peringatan yang telah aktif lebih lama dari durasi ambang batas yang dikonfigurasi. | 
| NoData | Tidak ada data yang diterima untuk jendela waktu yang dikonfigurasi. | 
| Kesalahan | Kesalahan yang terjadi saat mencoba mengevaluasi aturan peringatan. | 

**Pertahankan status terakhir**

Aturan peringatan dapat dikonfigurasi untuk mempertahankan status terakhir saat `NoData` atau `Error` status ditemui. Ini akan mencegah peringatan dari penembakan, dan dari penyelesaian dan penembakan kembali. Sama seperti evaluasi normal, aturan peringatan akan bertransisi dari `Pending` ke `Firing` setelah periode tertunda telah berlalu.

**Peringatan aturan kesehatan**

Aturan peringatan dapat memiliki satu status kesehatan berikut:


| Status | Deskripsi | 
| --- | --- | 
| Oke | Tidak ada kesalahan saat mengevaluasi aturan peringatan. | 
| Kesalahan | Terjadi kesalahan saat mengevaluasi aturan peringatan. | 
| NoData | Tidak adanya data dalam setidaknya satu deret waktu yang dikembalikan selama evaluasi aturan. | 

**Peringatan khusus untuk `NoData` dan `Error`**

Saat evaluasi aturan peringatan menghasilkan status `NoData` atau`Error`, Grafana Alerting akan menghasilkan instance peringatan yang memiliki label tambahan berikut:


| Label | Deskripsi | 
| --- | --- | 
| nama peringatan | Baik `DatasourceNoData` atau `DatasourceError` tergantung pada negara. | 
| datasource\$1uid | UID dari sumber data yang menyebabkan negara. | 

Anda dapat menangani peringatan ini dengan cara yang sama seperti peringatan biasa dengan menambahkan keheningan, rute ke titik kontak, dan sebagainya.

# Templating pemberitahuan
<a name="v10-alerting-rules-notification-templates"></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)

Pemberitahuan yang dikirim melalui titik kontak dibuat menggunakan templat notifikasi. Template default Grafana didasarkan pada [sistem template Go di mana beberapa bidang dievaluasi sebagai teks, sementara yang lain dievaluasi sebagai HTML (yang dapat memengaruhi pelolosan](https://golang.org/pkg/text/template)).

Template default [default\$1template.go](https://github.com/grafana/alerting/blob/main/templates/default_template.go) adalah referensi yang berguna untuk template kustom.

Karena sebagian besar bidang titik kontak dapat di-template, Anda dapat membuat templat khusus yang dapat digunakan kembali dan menggunakannya di beberapa titik kontak. Untuk mempelajari notifikasi kustom menggunakan templat, lihat[Sesuaikan notifikasi](v10-alerting-manage-notifications.md).

**Template bersarang**

Anda dapat menyematkan template dalam template lain.

Misalnya, Anda dapat menentukan fragmen template menggunakan `define` kata kunci.

```
{{ define "mytemplate" }}
  {{ len .Alerts.Firing }} firing. {{ len .Alerts.Resolved }} resolved.
{{ end }}
```

Anda kemudian dapat menyematkan template kustom dalam fragmen ini menggunakan kata kunci. `template` Contoh:

```
Alert summary:
{{ template "mytemplate" . }}
```

Anda dapat menggunakan salah satu opsi templat bawaan berikut untuk menyematkan templat khusus.


| Nama | Catatan | 
| --- | --- | 
| `default.title` | Menampilkan informasi status tingkat tinggi. | 
| `default.message` | Menyediakan ringkasan pemformatan dan peringatan yang diselesaikan. | 
| `teams.default.message` | Mirip dengan`default.messsage`, diformat untuk Microsoft Teams. | 

**HTML dalam template notifikasi**

HTML dalam peringatan template notifikasi lolos. Kami tidak mendukung rendering HTML dalam notifikasi yang dihasilkan.

Beberapa notifier mendukung metode alternatif untuk mengubah tampilan dan nuansa notifikasi yang dihasilkan. Misalnya, Grafana menginstal template dasar untuk memperingatkan email. `<grafana-install-dir>/public/emails/ng_alert_notification.html` Anda dapat mengedit file ini untuk mengubah tampilan semua email peringatan.

# Pengelola Peringatan
<a name="v10-alerting-explore-alertmanager"></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)

Alertmanager memungkinkan Anda mengelola dan merespons peringatan dengan cepat dan efisien. Ini menerima peringatan, menangani mutasi, penghambatan, pengelompokan, dan perutean dengan mengirimkan pemberitahuan melalui saluran pilihan Anda, misalnya, email atau Slack.

Di Grafana, Anda dapat menggunakan Grafana Alertmanager atau Alertmanager eksternal. Anda juga dapat menjalankan beberapa pengelola peringatan; keputusan Anda tergantung pada pengaturan Anda dan di mana peringatan Anda dihasilkan.

**Grafana Alertmanager**

Grafana Alertmanager adalah Alertmanager internal yang telah dikonfigurasi sebelumnya dan tersedia untuk dipilih secara default.

Grafana Alertmanager dapat menerima peringatan dari Grafana, tetapi tidak dapat menerima peringatan dari luar Grafana, misalnya, dari Mimir atau Loki.

**catatan**  
Aturan penghambatan tidak didukung di Grafana Alertmanager.

**Pengelola Peringatan Eksternal**

Jika Anda ingin menggunakan satu alertmanager untuk menerima semua peringatan Grafana, Loki, Mimir, dan Prometheus Anda, Anda dapat mengatur Grafana untuk menggunakan Alertmanager eksternal. Alertmanager eksternal ini dapat dikonfigurasi dan dikelola dari dalam Grafana itu sendiri.

Berikut adalah dua contoh kapan Anda mungkin ingin mengonfigurasi manajer peringatan eksternal Anda sendiri dan mengirim peringatan Anda ke sana alih-alih Grafana Alertmanager:

1. Anda sudah memiliki pengelola peringatan di lokasi di infrastruktur Cloud Anda sendiri yang telah Anda atur dan masih ingin digunakan, karena Anda memiliki generator peringatan lain, seperti Prometheus.

1. Anda ingin menggunakan Prometheus on-premise dan Grafana yang dihosting untuk mengirim peringatan ke alertmanager yang sama yang berjalan di infrastruktur Cloud Anda.

Alertmanagers terlihat dari menu tarik-turun pada halaman Alerting Contact Points, dan Notification Policies.

Jika Anda menyediakan sumber data Anda, setel tanda `handleGrafanaManagedAlerts` di `jsonData` bidang untuk mengirim peringatan yang dikelola Grafana `true` ke Alertmanager ini.

# Titik kontak
<a name="v10-alerting-explore-contacts"></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)

Titik kontak berisi konfigurasi untuk mengirim pemberitahuan. Titik kontak adalah daftar integrasi, yang masing-masing mengirimkan pemberitahuan ke alamat email, layanan, atau URL tertentu. Titik kontak dapat memiliki beberapa integrasi dari jenis yang sama, atau kombinasi integrasi dari berbagai jenis. Misalnya, titik kontak dapat berisi integrasi Pagerduty; integrasi Amazon SNS dan Slack; atau integrasi Pagerduty, integrasi Slack, dan dua integrasi Amazon SNS. Anda juga dapat mengonfigurasi titik kontak tanpa integrasi; dalam hal ini tidak ada pemberitahuan yang dikirim.

Titik kontak tidak dapat mengirim pemberitahuan sampai telah ditambahkan ke kebijakan pemberitahuan. Kebijakan pemberitahuan hanya dapat mengirim peringatan ke satu titik kontak, tetapi titik kontak dapat ditambahkan ke sejumlah kebijakan pemberitahuan secara bersamaan. Ketika peringatan cocok dengan kebijakan notifikasi, peringatan dikirim ke titik kontak dalam kebijakan notifikasi tersebut, yang kemudian mengirimkan pemberitahuan ke setiap integrasi dalam konfigurasinya.

Titik kontak dapat dikonfigurasi untuk Grafana Alertmanager serta manajer peringatan eksternal.

Anda juga dapat menggunakan template notifikasi untuk menyesuaikan pesan notifikasi untuk jenis titik kontak.

**Jenis titik kontak yang didukung**

Tabel berikut mencantumkan jenis titik kontak yang didukung oleh Grafana.


| Nama | Tipe | 
| --- | --- | 
| Amazon SNS | `sns` | 
| OpsGenie | `opsgenie` | 
| Tugas Pager | `pagerduty` | 
| Slack | `slack` | 
| VictorOps | `victorops` | 

Untuk informasi lebih lanjut tentang titik kontak, lihat [Konfigurasikan titik kontak](v10-alerting-configure-contactpoints.md) dan[Sesuaikan notifikasi](v10-alerting-manage-notifications.md).

# Notifikasi
<a name="v10-alerting-explore-notifications"></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)

Memilih bagaimana, kapan, dan di mana mengirim pemberitahuan peringatan Anda adalah bagian penting dari pengaturan sistem peringatan Anda. Keputusan ini akan berdampak langsung pada kemampuan Anda untuk menyelesaikan masalah dengan cepat dan tidak melewatkan sesuatu yang penting.

Sebagai langkah pertama, tentukan [titik kontak](v10-alerting-explore-contacts.md) Anda, yang menentukan ke mana harus mengirim pemberitahuan peringatan Anda. Titik kontak adalah satu set dari satu atau lebih integrasi yang digunakan untuk mengirimkan pemberitahuan. Tambahkan templat notifikasi ke titik kontak untuk digunakan kembali dan pesan yang konsisten di notifikasi Anda.

Selanjutnya, buat kebijakan notifikasi yang merupakan seperangkat aturan untuk di mana, kapan, dan bagaimana peringatan Anda diarahkan ke titik kontak. Dalam kebijakan pemberitahuan, Anda menentukan tempat mengirim pemberitahuan peringatan dengan memilih salah satu titik kontak yang Anda buat.

## Manajer Peringatan
<a name="v10-alerting-explore-notifications-alertmanager"></a>

Grafana menggunakan Alertmanagers untuk mengirim notifikasi untuk mengaktifkan dan menyelesaikan peringatan. [Grafana memiliki Alertmanager sendiri, disebut sebagai **Grafana** di antarmuka pengguna, tetapi juga mendukung pengiriman pemberitahuan dari Alertmanager lain juga, seperti Prometheus Alertmanager.](https://prometheus.io/docs/alerting/latest/alertmanager/) Grafana Alertmanager menggunakan kebijakan notifikasi dan titik kontak untuk mengonfigurasi bagaimana dan di mana pemberitahuan dikirim; seberapa sering pemberitahuan harus dikirim; dan apakah semua peringatan harus dikirim dalam pemberitahuan yang sama, dikirim dalam pemberitahuan yang dikelompokkan berdasarkan kumpulan label, atau sebagai pemberitahuan terpisah.

## Kebijakan pemberitahuan
<a name="v10-alerting-explore-notifications-policies"></a>

Kebijakan notifikasi mengontrol kapan dan di mana notifikasi dikirim. Kebijakan notifikasi dapat memilih untuk mengirim semua peringatan bersama-sama dalam pemberitahuan yang sama, mengirim peringatan dalam pemberitahuan yang dikelompokkan berdasarkan kumpulan label, atau mengirim peringatan sebagai pemberitahuan terpisah. Anda dapat mengonfigurasi setiap kebijakan notifikasi untuk mengontrol seberapa sering pemberitahuan harus dikirim serta memiliki satu atau lebih waktu bisu untuk menghambat pemberitahuan pada waktu-waktu tertentu dalam sehari dan pada hari-hari tertentu dalam seminggu.

Kebijakan pemberitahuan diatur dalam struktur pohon di mana pada akar pohon ada kebijakan pemberitahuan yang disebut kebijakan default. Hanya ada satu kebijakan default dan kebijakan default tidak dapat dihapus.

Kebijakan perutean khusus adalah turunan dari kebijakan root dan dapat digunakan untuk mencocokkan semua peringatan atau subset peringatan berdasarkan sekumpulan label yang cocok. Kebijakan notifikasi cocok dengan peringatan ketika label yang cocok cocok dengan label dalam peringatan.

Kebijakan bersarang dapat memiliki kebijakan bersarangnya sendiri, yang memungkinkan pencocokan peringatan tambahan. Contoh kebijakan bersarang dapat mengirimkan peringatan infrastruktur ke tim Ops; sementara kebijakan anak mungkin mengirim peringatan prioritas tinggi ke Pagerduty dan peringatan prioritas rendah ke Slack.

Semua peringatan, terlepas dari labelnya, cocok dengan kebijakan default. Namun, ketika kebijakan default menerima peringatan, kebijakan tersebut akan melihat setiap kebijakan bersarang dan mengirimkan peringatan ke kebijakan bersarang pertama yang cocok dengan peringatan. Jika kebijakan bersarang memiliki kebijakan bersarang lebih lanjut, maka kebijakan tersebut dapat mencoba mencocokkan peringatan dengan salah satu kebijakan bersarangnya. Jika tidak ada kebijakan bersarang yang cocok dengan peringatan maka kebijakan itu sendiri adalah kebijakan yang cocok. Jika tidak ada kebijakan bersarang, atau tidak ada kebijakan bersarang yang cocok dengan peringatan, maka kebijakan defaultnya adalah kebijakan yang cocok.

Untuk informasi selengkapnya tentang kebijakan notifikasi, lihat[Kebijakan pemberitahuan](v10-alerting-explore-notifications-policies-details.md).

## Template pemberitahuan
<a name="v10-alerting-explore-notifications-templating"></a>

Anda dapat menyesuaikan notifikasi dengan templat. Misalnya, template dapat digunakan untuk mengubah judul dan pesan notifikasi yang dikirim ke Slack.

Template tidak terbatas pada integrasi individu atau titik kontak, tetapi dapat digunakan dalam sejumlah integrasi di titik kontak yang sama dan bahkan integrasi di berbagai titik kontak. Misalnya, pengguna Grafana dapat membuat template yang disebut `custom_subject_or_title` dan menggunakannya untuk subjek templating di Pager Duty dan judul pesan Slack tanpa harus membuat dua templat terpisah.

Semua template notifikasi ditulis dalam [bahasa template Go](https://pkg.go.dev/text/template), dan berada di tab Titik kontak di halaman Peringatan.

Untuk informasi selengkapnya tentang menyesuaikan notifikasi, lihat[Sesuaikan notifikasi](v10-alerting-manage-notifications.md).

## Keheningan
<a name="v10-alerting-explore-notifications-silences"></a>

Anda dapat menggunakan keheningan untuk membisukan notifikasi dari satu atau beberapa aturan penembakan. Keheningan tidak menghentikan peringatan agar tidak ditembakkan atau diselesaikan, atau menyembunyikan peringatan penembakan di antarmuka pengguna. Keheningan berlangsung selama durasinya yang dapat dikonfigurasi dalam hitungan menit, jam, hari, bulan atau tahun.

Untuk informasi lebih rinci tentang menggunakan keheningan, lihat[Membungkam pemberitahuan peringatan](v10-alerting-silences.md).

# Kebijakan pemberitahuan
<a name="v10-alerting-explore-notifications-policies-details"></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)

Kebijakan pemberitahuan memberi Anda cara yang fleksibel untuk merutekan peringatan ke berbagai penerima yang berbeda. Menggunakan pencocokan label, Anda dapat memodifikasi pengiriman pemberitahuan peringatan tanpa harus memperbarui setiap aturan peringatan individual.

Di bagian ini, Anda akan mempelajari lebih lanjut tentang cara kerja kebijakan notifikasi dan terstruktur, sehingga Anda dapat memaksimalkan pengaturan kebijakan notifikasi.

## Pohon kebijakan
<a name="v10-alerting-explore-notifications-policy-tree"></a>

Kebijakan pemberitahuan *bukan* daftar, melainkan disusun menurut struktur pohon. Ini berarti bahwa setiap kebijakan dapat memiliki kebijakan anak, dan sebagainya. Akar pohon kebijakan notifikasi disebut **kebijakan pemberitahuan Default**.

Setiap kebijakan terdiri dari sekumpulan pencocokan label (0 atau lebih) yang menentukan label mana yang mereka minati atau tidak ingin ditangani.

Untuk informasi selengkapnya tentang pencocokan label, lihat[Cara kerja pencocokan label](v10-alerting-overview-labels-matching.md).

**catatan**  
Jika Anda belum mengonfigurasi pencocokan label apa pun untuk kebijakan notifikasi, kebijakan notifikasi Anda akan cocok dengan *semua* instance peringatan. Hal ini dapat mencegah kebijakan anak dievaluasi kecuali Anda telah mengaktifkan **Lanjutkan pencocokan saudara kandung** pada kebijakan pemberitahuan.

## Perutean
<a name="v10-alerting-explore-notifications-routing"></a>

Untuk menentukan kebijakan notifikasi mana yang akan menangani instance peringatan mana, Anda harus mulai dengan melihat kumpulan kebijakan notifikasi yang ada, dimulai dengan kebijakan notifikasi default.

Jika tidak ada kebijakan selain kebijakan default yang dikonfigurasi, kebijakan default akan menangani instance peringatan.

Jika kebijakan selain kebijakan default ditentukan, kebijakan notifikasi tersebut akan mengevaluasi kebijakan pemberitahuan tersebut sesuai urutan yang ditampilkan.

Jika kebijakan notifikasi memiliki pencocokan label yang cocok dengan label instance peringatan, kebijakan tersebut akan turun ke kebijakan turunannya dan, jika ada, akan terus mencari kebijakan anak yang mungkin memiliki pencocokan label yang semakin mempersempit kumpulan label, dan seterusnya sampai tidak ada lagi kebijakan anak yang ditemukan.

Jika tidak ada kebijakan anak yang ditentukan dalam kebijakan pemberitahuan atau jika tidak ada kebijakan turunan yang memiliki pencocokan label yang cocok dengan label instance peringatan, kebijakan pemberitahuan induk akan digunakan.

Segera setelah kebijakan pencocokan ditemukan, sistem tidak terus mencari kebijakan pencocokan lainnya. Jika Anda ingin terus mencari kebijakan lain yang mungkin cocok, aktifkan **Lanjutkan pencocokan saudara kandung** pada kebijakan tertentu.

Terakhir, jika tidak ada kebijakan notifikasi yang dipilih, kebijakan notifikasi default akan digunakan.

### Contoh perutean
<a name="v10-alerting-explore-notifications-routing-example"></a>

Berikut adalah contoh pohon kebijakan notifikasi yang relatif sederhana dan beberapa contoh peringatan.

![\[Gambar yang menampilkan sekumpulan kebijakan notifikasi dalam struktur pohon, dan sekumpulan instance peringatan dengan label berbeda agar sesuai dengan kebijakan.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/notification-routing.png)


Berikut adalah rincian tentang bagaimana kebijakan ini dipilih:

**Pod yang terjebak CrashLoop** tidak memiliki `severity` label, jadi tidak ada kebijakan turunannya yang cocok. Itu memang memiliki `team=operations` label, jadi kebijakan pertama dicocokkan.

`team=security`Kebijakan ini tidak dievaluasi karena kami telah menemukan kecocokan dan **Lanjutkan pencocokan saudara kandung** tidak dikonfigurasi untuk kebijakan tersebut.

**Penggunaan Disk — 80%** memiliki `severity` label `team` dan a, dan cocok dengan kebijakan anak dari tim operasi.

**Entri log yang tidak sah** memiliki `team` label tetapi tidak cocok dengan kebijakan pertama (`team=operations`) karena nilainya tidak sama, sehingga akan terus mencari dan mencocokkan `team=security` kebijakan. Itu tidak memiliki kebijakan anak, sehingga `severity=high` label tambahan diabaikan.

## Warisan
<a name="v10-alerting-explore-notifications-inheritance"></a>

Selain kebijakan anak sebagai konsep yang berguna untuk merutekan instance peringatan, mereka juga mewarisi properti dari kebijakan induknya. Ini juga berlaku untuk setiap kebijakan yang merupakan kebijakan anak dari kebijakan pemberitahuan default.

Properti berikut diwarisi oleh kebijakan anak:
+ Titik kontak
+ Opsi pengelompokan
+ Opsi waktu
+ Bisukan pengaturan waktu

Masing-masing properti ini dapat ditimpa oleh kebijakan individual jika Anda ingin mengganti properti yang diwariskan.

Untuk mewarisi titik kontak dari kebijakan induk, biarkan kosong. **Untuk mengganti opsi pengelompokan yang diwariskan, aktifkan pengelompokan Override.** Untuk mengganti opsi waktu yang diwariskan, aktifkan **Override** pengaturan waktu umum.

### Contoh warisan
<a name="v10-alerting-explore-notifications-inheritance-example"></a>

Contoh di bawah ini menunjukkan bagaimana pohon kebijakan notifikasi dari contoh sebelumnya memungkinkan kebijakan anak `team=operations` untuk mewarisi titik kontaknya.

Dengan cara ini, kita dapat menghindari keharusan menentukan titik kontak yang sama beberapa kali untuk setiap kebijakan anak.

![\[Gambar yang menunjukkan serangkaian kebijakan pemberitahuan dalam struktur pohon, dengan titik kontak yang ditetapkan ke beberapa kebijakan, tetapi dengan beberapa kebijakan anak mewarisi titik kontak orang tua mereka, daripada mendefinisikan sendiri.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/notification-inheritance.png)


## Opsi konfigurasi tambahan
<a name="v10-alerting-explore-notifications-additional-configuration-options"></a>

### Pengelompokan
<a name="v10-alerting-explore-notifications-grouping"></a>

Pengelompokan adalah fitur penting dari Grafana Alerting karena memungkinkan Anda untuk mengumpulkan peringatan yang relevan bersama-sama ke dalam jumlah notifikasi yang lebih kecil. Hal ini sangat penting jika pemberitahuan dikirimkan ke responden pertama, seperti insinyur on-call, di mana menerima banyak notifikasi dalam waktu singkat bisa sangat banyak dan dalam beberapa kasus dapat berdampak negatif pada kemampuan responden pertama untuk menanggapi suatu insiden. Misalnya, pertimbangkan pemadaman besar di mana banyak sistem Anda sedang down. Dalam hal ini, pengelompokan dapat menjadi perbedaan antara menerima 1 panggilan telepon dan 100 panggilan telepon.

Anda memilih bagaimana peringatan dikelompokkan bersama menggunakan opsi Grup menurut dalam kebijakan pemberitahuan. Secara default, kebijakan notifikasi di grup Grafana memberi peringatan bersama dengan aturan peringatan menggunakan `grafana_folder` label `alertname` dan (karena nama peringatan tidak unik di beberapa folder). Jika Anda ingin mengelompokkan peringatan dengan sesuatu selain aturan peringatan, ubah pengelompokan ke kombinasi label lainnya.

#### Nonaktifkan pengelompokan
<a name="v10-alerting-explore-notifications-disable-grouping"></a>

Jika Anda ingin menerima setiap peringatan sebagai pemberitahuan terpisah, Anda dapat melakukannya dengan mengelompokkan berdasarkan label khusus yang disebut`...`. Ini berguna ketika peringatan Anda dikirim ke sistem otomatis, bukan responden pertama.

#### Satu grup untuk semua peringatan
<a name="v10-alerting-explore-notifications-a-single-group-for-all-alerts"></a>

Jika Anda ingin menerima semua peringatan bersama-sama dalam satu pemberitahuan, Anda dapat melakukannya dengan meninggalkan Grup dengan kosong.

### Opsi waktu
<a name="v10-alerting-explore-notifications-timing-options"></a>

Opsi waktu menentukan seberapa sering pemberitahuan dikirim untuk setiap grup peringatan. Ada tiga pengatur waktu yang perlu Anda ketahui: Tunggu grup, Interval grup, dan interval Ulangi.

#### Kelompok menunggu
<a name="v10-alerting-explore-notifications-group-wait"></a>

Penantian grup adalah jumlah waktu Grafana menunggu sebelum mengirim pemberitahuan pertama untuk grup peringatan baru. Semakin lama penantian Grup adalah semakin banyak waktu yang Anda miliki untuk peringatan lain tiba. Penantian Grup yang lebih pendek adalah semakin awal pemberitahuan pertama akan dikirim, tetapi berisiko mengirim pemberitahuan yang tidak lengkap. Anda harus selalu memilih penantian Grup yang paling masuk akal untuk kasus penggunaan Anda.

**Default** 30 detik

#### Interval kelompok
<a name="v10-alerting-explore-notifications-group-interval"></a>

Setelah pemberitahuan pertama dikirim untuk grup peringatan baru, Grafana memulai pengatur waktu interval Grup. Ini adalah jumlah waktu Grafana menunggu sebelum mengirim pemberitahuan tentang perubahan pada grup. Misalnya, peringatan penembakan lain mungkin baru saja ditambahkan ke grup sementara peringatan yang ada mungkin telah diselesaikan. Jika peringatan terlambat untuk dimasukkan dalam pemberitahuan pertama karena penantian Grup, peringatan tersebut akan disertakan dalam pemberitahuan berikutnya setelah interval Grup. Setelah Interval Grup berlalu, Grafana mengatur ulang pengatur waktu interval Grup. Ini berulang sampai tidak ada lagi peringatan di grup setelah grup dihapus.

**Default** 5 menit

#### Ulangi interval
<a name="v10-alerting-explore-notifications-repeat-interval"></a>

Interval pengulangan memutuskan seberapa sering pemberitahuan diulang jika grup tidak berubah sejak pemberitahuan terakhir. Anda dapat menganggap ini sebagai pengingat bahwa beberapa peringatan masih menyala. Interval pengulangan terkait erat dengan interval Grup, yang berarti interval Ulangi Anda tidak hanya harus lebih besar dari atau sama dengan interval Grup, tetapi juga harus kelipatan interval Grup. Jika interval Ulangi bukan kelipatan interval Grup itu akan dipaksa menjadi satu. Misalnya, jika interval Grup Anda adalah 5 menit, dan interval Ulangi Anda adalah 9 menit, interval Ulangi akan dibulatkan ke kelipatan terdekat dari 5 yaitu 10 menit.

**Default** 4 jam

# Memperingatkan ketersediaan tinggi
<a name="v10-alerting-explore-high-availability"></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)

Grafana Terkelola Amazon dikonfigurasi untuk ketersediaan tinggi, termasuk menjalankan beberapa instance di beberapa zona ketersediaan untuk setiap ruang kerja yang Anda buat.

Grafana Alerting menggunakan model Prometheus untuk memisahkan evaluasi aturan peringatan dari pengiriman notifikasi. Dalam model ini evaluasi aturan peringatan dilakukan di generator peringatan dan pengiriman pemberitahuan dilakukan di penerima peringatan. Di Grafana Alerting, generator peringatan adalah Scheduler dan penerima adalah Alertmanager.

Dengan konfigurasi ketersediaan tinggi, semua aturan peringatan dievaluasi pada semua instance. Anda dapat menganggap evaluasi aturan peringatan sebagai duplikasi. Beginilah cara Grafana Alerting memastikan bahwa selama setidaknya satu instance Grafana berfungsi, aturan peringatan akan tetap dievaluasi dan pemberitahuan untuk peringatan akan tetap dikirim. Anda akan melihat duplikasi ini dalam sejarah negara bagian, dan merupakan cara yang baik untuk mengetahui apakah Anda menggunakan ketersediaan tinggi.

# Mengatur Peringatan
<a name="v10-alerting-setup"></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)

Konfigurasikan fitur dan integrasi yang Anda butuhkan untuk membuat dan mengelola peringatan Anda.

**Prasyarat**

Sebelum Anda mengatur peringatan, Anda harus melakukan hal berikut.
+ Konfigurasikan [sumber data](AMG-data-sources.md) Anda.
+ Pastikan sumber data yang Anda pilih kompatibel dan didukung oleh peringatan [Grafana](v10-alerting-overview-datasources.md).

**Untuk mengatur peringatan**

1. Konfigurasikan [aturan peringatan](v10-alerting-configure.md).
   + Buat aturan peringatan terkelola Grafana atau terkelola sumber data dan aturan perekaman.

1. Konfigurasikan [titik kontak](v10-alerting-configure-contactpoints.md).
   + Periksa titik kontak default, dan perbarui kontak untuk sistem Anda.
   + Secara opsional, tambahkan titik kontak dan integrasi baru.

1. Konfigurasikan [kebijakan pemberitahuan](v10-alerting-explore-notifications-policies-details.md)
   + Periksa kebijakan pemberitahuan default, dan perbarui untuk sistem Anda.
   + Secara opsional, tambahkan kebijakan bersarang tambahan.
   + Secara opsional, tambahkan label dan pencocokan label untuk mengontrol perutean peringatan.

Topik berikut memberi Anda informasi lebih lanjut tentang opsi konfigurasi tambahan, termasuk mengonfigurasi pengelola peringatan eksternal dan merutekan peringatan yang dikelola Grafana di luar Grafana.

**Topics**
+ [Memigrasi peringatan dasbor klasik ke peringatan Grafana](v10-alerting-use-grafana-alerts.md)
+ [Menambahkan Alertmanager eksternal](v10-alerting-setup-alertmanager.md)
+ [Penyediaan sumber daya Peringatan Grafana](v10-alerting-setup-provision.md)

# Memigrasi peringatan dasbor klasik ke peringatan Grafana
<a name="v10-alerting-use-grafana-alerts"></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)

Ruang kerja yang memilih untuk tidak menggunakan peringatan Grafana menggunakan. [Peringatan dasbor klasik](old-alerts-overview.md) Untuk beralih ke peringatan Grafana baru, Anda harus ikut serta dalam fitur tersebut. Untuk melihat detail tentang perbedaan antara peringatan dasbor klasik dan peringatan Grafana, lihat. [Peringatan Grafana vs peringatan dasbor lama](#v10-alerting-diff-old-new) GrafanaLabs telah mengumumkan bahwa peringatan dasbor klasik akan dihapus di versi 11.

Saat Anda menggunakan peringatan dasbor klasik, Grafana yang Dikelola Amazon menunjukkan pratinjau peringatan Grafana tempat Anda dapat meninjau dan memodifikasi peringatan yang ditingkatkan sebelum menyelesaikan peningkatan.

## Mempratinjau peringatan Grafana
<a name="v10-alerting-preview-grafana-alerts"></a>

Anda dapat melihat pratinjau peringatan Anda di peringatan Grafana sebelum bermigrasi. Di pratinjau, Anda dapat membuat perubahan pada peringatan yang akan mengubah migrasi.

**Untuk melihat pratinjau migrasi peringatan Grafana Anda**

1. Masuk ke ruang kerja Grafana Anda.

1. Dari menu sebelah kiri, pilih **Alerting (legacy)** untuk melihat peringatan Anda saat ini.

1. Dari menu sebelah kiri, pilih **Peringatan upgrade** untuk melihat lansiran Anda di Grafana alert.

   Dari tampilan ini, Anda dapat melihat seperti apa peringatan Anda setelah migrasi.

**catatan**  
Dari tampilan ini, Anda juga dapat membuat perubahan yang akan memengaruhi migrasi Anda. Untuk membatalkan perubahan yang Anda buat, pilih **Reset upgrade** di kanan atas halaman upgrade.

Saat Anda siap untuk meningkatkan lansiran Anda, lihat bagian selanjutnya.

## Bermigrasi ke sistem peringatan Grafana
<a name="v10-alerting-use-grafana-alerts-opt-in"></a>

Anda dapat mengonfigurasi instans Grafana Terkelola Amazon untuk menggunakan peringatan Grafana menggunakan API Grafana yang Dikelola Amazon Konsol Manajemen AWS, AWS CLI atau Amazon. Untuk detail tentang cara mengonfigurasi Grafana Terkelola Amazon, termasuk mengaktifkan atau menonaktifkan peringatan Grafana, lihat. [Konfigurasikan ruang kerja Grafana yang Dikelola Amazon](AMG-configure-workspace.md)

Saat peringatan Grafana diaktifkan, peringatan dasbor klasik yang ada bermigrasi dalam format yang kompatibel dengan peringatan Grafana. Di halaman Peringatan instans Grafana Anda, Anda dapat melihat peringatan yang dimigrasi bersama peringatan baru. Dengan peringatan Grafana, aturan peringatan yang dikelola Grafana Anda mengirim beberapa notifikasi, bukan satu peringatan saat dicocokkan.

Akses baca dan tulis ke peringatan dasbor klasik dan peringatan Grafana diatur oleh izin folder yang menyimpannya. Selama migrasi, izin peringatan dasbor klasik dicocokkan dengan izin aturan baru sebagai berikut:
+ Jika dasbor peringatan asli memiliki izin, migrasi akan membuat folder bernama dengan format ini `Migrated {"dashboardUid": "UID", "panelId": 1, "alertId": 1}` agar sesuai dengan izin dasbor asli (termasuk izin yang diwariskan dari folder).
+ Jika tidak ada izin dasbor dan dasbor berada di bawah folder, maka aturan tersebut ditautkan ke folder ini dan mewarisi izinnya.
+ Jika tidak ada izin dasbor dan dasbor berada di bawah folder Umum, maka aturan tersebut ditautkan ke folder Peringatan Umum, dan aturan mewarisi izin default.

**catatan**  
Karena tidak ada `Keep Last State` opsi untuk `NoData` peringatan Grafana, opsi ini menjadi `NoData` selama migrasi aturan klasik. Opsi `Keep Last State` untuk `Error` penanganan dimigrasikan ke opsi `Error` baru. Untuk mencocokkan perilaku`Keep Last State`, dalam kedua kasus, selama migrasi Grafana yang Dikelola Amazon secara otomatis membuat keheningan untuk setiap aturan peringatan dengan durasi satu tahun.

Saluran notifikasi dimigrasikan ke konfigurasi Alertmanager dengan rute dan penerima yang sesuai. Saluran pemberitahuan default ditambahkan sebagai titik kontak ke rute default. Saluran pemberitahuan yang tidak terkait dengan peringatan Dasbor apa pun masuk ke `autogen-unlinked-channel-recv` rute.

### Batasan
<a name="v10-alerting-use-grafana-alerts-limitations"></a>
+ Sistem peringatan Grafana dapat mengambil aturan dari semua sumber data Prometheus, Loki, dan Alertmanager yang tersedia. Mungkin tidak dapat mengambil aturan peringatan dari sumber data lain yang didukung.
+ Migrasi bolak-balik antara peringatan Grafana dan peringatan dasbor klasik dapat mengakibatkan hilangnya data untuk fitur yang didukung dalam satu sistem, tetapi tidak yang lain.
**catatan**  
Jika Anda bermigrasi kembali ke peringatan dasbor klasik, Anda kehilangan semua perubahan yang dibuat pada konfigurasi peringatan yang dibuat saat peringatan Grafana diaktifkan, termasuk aturan peringatan baru yang dibuat.

## Peringatan Grafana vs peringatan dasbor lama
<a name="v10-alerting-diff-old-new"></a>

Diperkenalkan di Grafana 8, peringatan Grafana memiliki beberapa peningkatan dibandingkan peringatan dasbor lama.

### Peringatan multi-dimensi
<a name="v10-alerts-diff-multi-dimensional"></a>

Anda sekarang dapat membuat peringatan yang memberi Anda visibilitas seluruh sistem dengan satu aturan peringatan. Hasilkan beberapa instance peringatan dari satu aturan peringatan. Misalnya, Anda dapat membuat aturan untuk memantau penggunaan disk dari beberapa titik pemasangan pada satu host. Mesin evaluasi mengembalikan beberapa deret waktu dari satu kueri, dengan setiap deret waktu diidentifikasi oleh set labelnya.

### Buat peringatan di luar Dasbor
<a name="v10-alerts-diff-alerts-outside-of-dashboards"></a>

Tidak seperti lansiran dasbor lama, peringatan Grafana memungkinkan Anda membuat kueri dan ekspresi yang menggabungkan data dari berbagai sumber dengan cara yang unik. Anda masih dapat menautkan dasbor dan panel ke aturan peringatan menggunakan ID mereka dan dengan cepat memecahkan masalah sistem yang sedang diamati.

Karena peringatan terpadu tidak lagi terkait langsung dengan kueri panel, mereka tidak menyertakan gambar atau nilai kueri dalam email notifikasi. Anda dapat menggunakan templat notifikasi yang disesuaikan untuk melihat nilai kueri.

### Buat aturan peringatan Loki dan Grafana Mimir
<a name="v10-alerts-diff-loki-mimir-alerting-rules"></a>

Di Grafana Alerting, Anda dapat mengelola aturan peringatan Loki dan Grafana Mimir menggunakan UI dan API yang sama dengan lansiran terkelola Grafana Anda.

### Lihat dan cari peringatan dari sumber data yang kompatibel dengan Prometheus
<a name="v10-alerts-diff-view-alerts-from-prometheus"></a>

Peringatan untuk sumber data yang kompatibel dengan Prometheus sekarang terdaftar di bawah bagian peringatan Grafana. Anda dapat mencari label di beberapa sumber data untuk menemukan peringatan yang relevan dengan cepat.

### Peringatan khusus untuk status peringatan NoData dan Kesalahan
<a name="v10-alerts-diff-special-alerts"></a>

Grafana Alerting memperkenalkan konsep baru status peringatan. Ketika evaluasi aturan peringatan menghasilkan status NoData atau Kesalahan, Grafana Alerting akan menghasilkan peringatan khusus yang akan memiliki label berikut:
+ `alertname`dengan nilai DatasourceNoData atau DatasourceError tergantung pada negara.
+ `rulename`nama aturan peringatan yang dimiliki oleh peringatan khusus.
+ `datasource_uid`akan memiliki UID dari sumber data yang menyebabkan negara.
+ Semua label dan anotasi aturan peringatan asli

Anda dapat menangani peringatan ini dengan cara yang sama seperti peringatan biasa dengan menambahkan keheningan, rute ke titik kontak, dan sebagainya.

**catatan**  
Jika aturan menggunakan banyak sumber data dan satu atau banyak tidak mengembalikan data, peringatan khusus akan dibuat untuk setiap sumber data yang menyebabkan status peringatan.

# Menambahkan Alertmanager eksternal
<a name="v10-alerting-setup-alertmanager"></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)

Siapkan Grafana untuk menggunakan Alertmanager eksternal sebagai Alertmanager tunggal untuk menerima semua peringatan Anda. Alertmanager eksternal ini kemudian dapat dikonfigurasi dan dikelola dari dalam Grafana itu sendiri.

**catatan**  
Anda tidak dapat menggunakan Amazon Managed Service untuk Prometheus sebagai Alertmanager eksternal.

Setelah menambahkan alertmanager, Anda dapat menggunakan Grafana Alerting UI untuk mengelola keheningan, titik kontak, dan kebijakan notifikasi. Opsi dropdown di halaman ini memungkinkan Anda untuk beralih di antara manajer peringatan.

Manajer peringatan eksternal dikonfigurasi sebagai sumber data menggunakan Konfigurasi Grafana dari menu navigasi Grafana utama. Ini memungkinkan Anda untuk mengelola titik kontak dan kebijakan pemberitahuan manajer peringatan eksternal dari dalam Grafana dan juga mengenkripsi kredensi otentikasi dasar HTTP yang sebelumnya terlihat saat mengonfigurasi pengelola peringatan eksternal berdasarkan URL.

**catatan**  
Dimulai dengan Grafana 9.2, konfigurasi URL pengelola peringatan eksternal dari tab Admin di halaman Peringatan tidak digunakan lagi. Ini akan dihapus dalam rilis future.

**Untuk menambahkan Alertmanager eksternal**

1. Pilih **Koneksi** dari menu kiri utama.

1. Cari `Alertmanager`.

1. Pilih tombol **Buat sumber data baru**.

1. Isi bidang pada halaman, sesuai kebutuhan.

   Jika Anda menyediakan sumber data Anda, setel tanda `handleGrafanaManagedAlerts` di `jsonData` bidang untuk mengirim peringatan yang dikelola Grafana `true` ke Alertmanager ini.
**catatan**  
Prometheus, Grafana Mimir, dan implementasi Cortex dari Alertmanager didukung. Untuk Prometheus, titik kontak dan kebijakan notifikasi hanya-baca di UI Peringatan Grafana.

1. Pilih **Simpan & uji**.

# Penyediaan sumber daya Peringatan Grafana
<a name="v10-alerting-setup-provision"></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)

Infrastruktur peringatan seringkali rumit, dengan banyak potongan pipa yang sering tinggal di tempat yang berbeda. Menskalakan ini di beberapa tim dan organisasi adalah tugas yang sangat menantang. Penyediaan Grafana Alerting membuat proses ini lebih mudah dengan memungkinkan Anda membuat, mengelola, dan memelihara data peringatan Anda dengan cara yang paling sesuai dengan organisasi Anda.

Ada dua opsi untuk dipilih:

1. Menyediakan sumber daya peringatan Anda menggunakan API HTTP Penyediaan Peringatan.
**catatan**  
Biasanya, Anda tidak dapat mengedit aturan peringatan yang disediakan API dari UI Grafana.  
Untuk mengaktifkan pengeditan, tambahkan x-disable-provenance header ke permintaan berikut saat membuat atau mengedit aturan peringatan Anda di API:  

   ```
   POST /api/v1/provisioning/alert-rules
   PUT /api/v1/provisioning/alert-rules/{UID}
   ```

1. Menyediakan sumber peringatan Anda menggunakan Terraform.

**catatan**  
Saat ini, penyediaan Grafana Alerting mendukung aturan peringatan, titik kontak, pengaturan waktu bisu, dan templat. Sumber daya peringatan yang disediakan menggunakan penyediaan file atau Terraform hanya dapat diedit di sumber yang membuatnya dan bukan dari dalam Grafana atau sumber lainnya. Misalnya, jika Anda menyediakan sumber peringatan menggunakan file dari disk, Anda tidak dapat mengedit data di Terraform atau dari dalam Grafana.

**Topics**
+ [Buat dan kelola sumber daya peringatan menggunakan Terraform](v10-alerting-setup-provision-terraform.md)
+ [Melihat sumber peringatan yang disediakan di Grafana](v10-alerting-setup-provision-view.md)

# Buat dan kelola sumber daya peringatan menggunakan Terraform
<a name="v10-alerting-setup-provision-terraform"></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)

Gunakan Penyedia Grafana Terraform untuk mengelola sumber daya peringatan Anda dan menyediakannya ke dalam sistem Grafana Anda. Dukungan penyedia Terraform untuk Grafana Alerting memudahkan untuk membuat, mengelola, dan memelihara seluruh tumpukan Grafana Alerting Anda sebagai kode.

Untuk informasi lebih lanjut tentang mengelola sumber daya peringatan Anda menggunakan Terraform, lihat dokumentasi [Penyedia](https://registry.terraform.io/providers/grafana/grafana/latest/docs) Grafana di dokumentasi Terraform.

Selesaikan tugas-tugas berikut untuk membuat dan mengelola sumber peringatan Anda menggunakan Terraform.

1. Buat kunci API untuk penyediaan.

1. Konfigurasikan penyedia Terraform.

1. Tentukan sumber peringatan Anda di Terraform.

1. Jalankan `terraform apply` untuk menyediakan sumber peringatan Anda.

## Prasyarat
<a name="v10-alerting-setup-provision-tf-prerequisites"></a>
+ Pastikan Anda memiliki [penyedia grafana/grafana Terraform](https://registry.terraform.io/providers/grafana/grafana/1.28.0) 1.27.0 atau lebih tinggi.
+ Pastikan Anda menggunakan Grafana 9.1 atau lebih tinggi. Jika Anda membuat instans Grafana Terkelola Amazon dengan Grafana versi 9, ini benar.

## Membuat kunci API untuk penyediaan
<a name="v10-alerting-setup-provision-tf-apikey"></a>

Anda dapat [membuat kunci API Grafana normal](Using-Grafana-APIs.md) untuk mengautentikasi Terraform dengan Grafana. Sebagian besar perkakas yang ada menggunakan kunci API akan secara otomatis bekerja dengan dukungan Grafana Alerting yang baru. Untuk informasi khusus tentang membuat kunci untuk digunakan dengan Terraform, lihat [Menggunakan Terraform untuk otomatisasi Grafana Terkelola Amazon](https://aws-observability.github.io/observability-best-practices/recipes/recipes/amg-automation-tf/).

**Untuk membuat kunci API untuk penyediaan**

1. Buat akun layanan baru untuk pipeline CI Anda.

1. Tetapkan peran “Akses API Penyediaan aturan peringatan.”

1. Buat token akun layanan baru.

1. Beri nama dan simpan token untuk digunakan di Terraform.

Atau, Anda dapat menggunakan otentikasi dasar. Untuk melihat semua format autentikasi yang didukung, lihat Autentikasi [Grafana](https://registry.terraform.io/providers/grafana/grafana/latest/docs#authentication) di dokumentasi Terraform.

## Konfigurasikan penyedia Terraform
<a name="v10-alerting-setup-provision-tf-configure"></a>

[Dukungan Grafana Alerting disertakan sebagai bagian dari penyedia Grafana Terraform.](https://registry.terraform.io/providers/grafana/grafana/latest/docs)

Berikut ini adalah contoh yang dapat Anda gunakan untuk mengonfigurasi penyedia Terraform.

```
terraform {
    required_providers {
        grafana = {
            source = "grafana/grafana"
            version = ">= 1.28.2"
        }
    }
}

provider "grafana" {
    url = <YOUR_GRAFANA_URL>
    auth = <YOUR_GRAFANA_API_KEY>
}
```

## Penyediaan titik kontak dan templat
<a name="v10-alerting-setup-provision-tf-contacts"></a>

Titik kontak menghubungkan tumpukan peringatan ke dunia luar. Mereka memberi tahu Grafana cara terhubung ke sistem eksternal Anda dan di mana mengirimkan pemberitahuan. Ada lebih dari lima belas [integrasi](https://registry.terraform.io/providers/grafana/grafana/latest/docs/resources/contact_point#optional) berbeda untuk dipilih. Contoh ini menggunakan titik kontak Slack.

**Untuk menyediakan titik kontak dan templat**

1. Salin blok kode ini ke file.tf di mesin lokal Anda. Ganti *<slack-webhook-url>* dengan URL webhook Slack Anda (atau detail titik kontak lainnya).

   Contoh ini menciptakan titik kontak yang mengirimkan pemberitahuan peringatan ke Slack.

   ```
   resource "grafana_contact_point" "my_slack_contact_point" {
       name = "Send to My Slack Channel"
   
       slack {
           url = <slack-webhook-url>
           text = <<EOT
   {{ len .Alerts.Firing }} alerts are firing!
   
   Alert summaries:
   {{ range .Alerts.Firing }}
   {{ template "Alert Instance Template" . }}
   {{ end }}
   EOT
       }
   }
   ```

1. Masukkan teks untuk notifikasi Anda di bidang teks.

   `text`Bidang ini mendukung [Templating Go-style](https://pkg.go.dev/text/template). Ini memungkinkan Anda untuk mengelola templat notifikasi Grafana Alerting Anda langsung di Terraform.

1. Jalankan perintah `terraform apply`.

1. Buka Grafana UI dan periksa detail titik kontak Anda.

   Anda tidak dapat mengedit sumber daya yang disediakan melalui Terraform dari UI. Ini memastikan bahwa tumpukan peringatan Anda selalu sinkron dengan kode Anda.

1. Klik **Uji** untuk memverifikasi bahwa titik kontak berfungsi dengan benar.

**catatan**  
Anda dapat menggunakan kembali template yang sama di banyak titik kontak. Pada contoh di atas, template bersama disematkan menggunakan pernyataan `{{ template "Alert Instance Template" . }}`  
Fragmen ini kemudian dapat dikelola secara terpisah di Terraform:  

```
resource "grafana_message_template" "my_alert_template" {
    name = "Alert Instance Template"

    template = <<EOT
{{ define "Alert Instance Template" }}
Firing: {{ .Labels.alertname }}
Silence: {{ .SilenceURL }}
{{ end }}
EOT
}
```

## Kebijakan pemberitahuan penyediaan dan perutean
<a name="v10-alerting-setup-provision-tf-notifications"></a>

Kebijakan notifikasi memberi tahu Grafana cara merutekan instance peringatan, sebagai lawan dari where. Mereka menghubungkan peringatan penembakan ke titik kontak yang Anda tentukan sebelumnya menggunakan sistem label dan pencocokan.

**Untuk menyediakan kebijakan pemberitahuan dan perutean**

1. Salin blok kode ini ke file.tf di mesin lokal Anda.

   Dalam contoh ini, peringatan dikelompokkan berdasarkan`alertname`, yang berarti bahwa setiap pemberitahuan yang berasal dari peringatan yang memiliki nama yang sama, dikelompokkan ke dalam pesan Slack yang sama.

   Jika Anda ingin merutekan pemberitahuan tertentu secara berbeda, Anda dapat menambahkan sub-kebijakan. Sub-kebijakan memungkinkan Anda menerapkan perutean ke peringatan yang berbeda berdasarkan pencocokan label. Dalam contoh ini, kami menerapkan waktu bisu ke semua peringatan dengan label a=b.

   ```
   resource "grafana_notification_policy" "my_policy" {
       group_by = ["alertname"]
       contact_point = grafana_contact_point.my_slack_contact_point.name
   
       group_wait = "45s"
       group_interval = "6m"
       repeat_interval = "3h"
   
       policy {
           matcher {
               label = "a"
               match = "="
               value = "b"
           }
           group_by = ["..."]
           contact_point = grafana_contact_point.a_different_contact_point.name
           mute_timings = [grafana_mute_timing.my_mute_timing.name]
   
           policy {
               matcher {
                   label = "sublabel"
                   match = "="
                   value = "subvalue"
               }
               contact_point = grafana_contact_point.a_third_contact_point.name
               group_by = ["..."]
           }
       }
   }
   ```

1. Di bidang mute\$1timings, tautkan waktu bisu ke kebijakan notifikasi Anda.

1. Jalankan perintah `terraform apply`.

1. Buka Grafana UI dan periksa detail kebijakan notifikasi Anda.
**catatan**  
Anda tidak dapat mengedit sumber daya yang disediakan dari Terraform dari UI. Ini memastikan bahwa tumpukan peringatan Anda selalu sinkron dengan kode Anda.

1. Klik **Uji** untuk memverifikasi bahwa titik notifikasi berfungsi dengan benar.

## Ketentuan waktu bisu
<a name="v10-alerting-setup-provision-tf-mutetiming"></a>

Pengaturan waktu bisu memberikan kemampuan untuk membisukan pemberitahuan peringatan untuk periode waktu yang ditentukan.

**Untuk menyediakan timing bisu**

1. Salin blok kode ini ke file.tf di mesin lokal Anda.

   Dalam contoh ini, pemberitahuan peringatan dimatikan pada akhir pekan.

   ```
   resource "grafana_mute_timing" "my_mute_timing" {
       name = "My Mute Timing"
   
       intervals {
           times {
             start = "04:56"
             end = "14:17"
           }
           weekdays = ["saturday", "sunday", "tuesday:thursday"]
           months = ["january:march", "12"]
           years = ["2025:2027"]
       }
   }
   ```

1. Jalankan perintah `terraform apply`.

1. Buka Grafana UI dan periksa detail waktu bisu Anda.

1. Referensikan waktu bisu yang baru dibuat dalam kebijakan notifikasi menggunakan `mute_timings` bidang. Ini akan menerapkan waktu bisu Anda ke beberapa atau semua notifikasi Anda.
**catatan**  
Anda tidak dapat mengedit sumber daya yang disediakan dari Terraform dari UI. Ini memastikan bahwa tumpukan peringatan Anda selalu sinkron dengan kode Anda.

1. Klik **Uji** untuk memverifikasi bahwa waktu bisu berfungsi dengan benar.

## Aturan peringatan ketentuan
<a name="v10-alerting-setup-provision-tf-rules"></a>

[Aturan peringatan](v10-alerting-configure.md) memungkinkan Anda untuk memperingatkan terhadap sumber data Grafana apa pun. Ini bisa berupa sumber data yang sudah Anda konfigurasikan, atau Anda dapat [menentukan sumber data Anda di Terraform bersama aturan](https://registry.terraform.io/providers/grafana/grafana/latest/docs/resources/data_source) peringatan Anda.

**Untuk menyediakan aturan peringatan**

1. Buat sumber data untuk kueri dan folder untuk menyimpan aturan Anda.

   Dalam contoh ini, sumber [Konfigurasikan sumber TestData data untuk pengujian](testdata-data-source.md) data digunakan.

   Peringatan dapat didefinisikan terhadap sumber data backend apa pun di Grafana.

   ```
   resource "grafana_data_source" "testdata_datasource" {
       name = "TestData"
       type = "testdata"
   }
   
   resource "grafana_folder" "rule_folder" {
       title = "My Rule Folder"
   }
   ```

1. Tentukan aturan peringatan.

   Untuk informasi selengkapnya tentang aturan peringatan, lihat [cara membuat lansiran yang dikelola Grafana.](https://grafana.com/blog/2022/08/01/grafana-alerting-video-how-to-create-alerts-in-grafana-9/)

1. Buat grup aturan yang berisi satu atau beberapa aturan.

   Dalam contoh ini, grup `grafana_rule_group` sumber daya digunakan.

   ```
   resource "grafana_rule_group" "my_rule_group" {
       name = "My Alert Rules"
       folder_uid = grafana_folder.rule_folder.uid
       interval_seconds = 60
       org_id = 1
   
       rule {
           name = "My Random Walk Alert"
           condition = "C"
           for = "0s"
   
           // Query the datasource.
           data {
               ref_id = "A"
               relative_time_range {
                   from = 600
                   to = 0
               }
               datasource_uid = grafana_data_source.testdata_datasource.uid
               // `model` is a JSON blob that sends datasource-specific data.
               // It's different for every datasource. The alert's query is defined here.
               model = jsonencode({
                   intervalMs = 1000
                   maxDataPoints = 43200
                   refId = "A"
               })
           }
   
           // The query was configured to obtain data from the last 60 seconds. Let's alert on the average value of that series using a Reduce stage.
           data {
               datasource_uid = "__expr__"
               // You can also create a rule in the UI, then GET that rule to obtain the JSON.
               // This can be helpful when using more complex reduce expressions.
               model = <<EOT
   {"conditions":[{"evaluator":{"params":[0,0],"type":"gt"},"operator":{"type":"and"},"query":{"params":["A"]},"reducer":{"params":[],"type":"last"},"type":"avg"}],"datasource":{"name":"Expression","type":"__expr__","uid":"__expr__"},"expression":"A","hide":false,"intervalMs":1000,"maxDataPoints":43200,"reducer":"last","refId":"B","type":"reduce"}
   EOT
               ref_id = "B"
               relative_time_range {
                   from = 0
                   to = 0
               }
           }
   
           // Now, let's use a math expression as our threshold.
           // We want to alert when the value of stage "B" above exceeds 70.
           data {
               datasource_uid = "__expr__"
               ref_id = "C"
               relative_time_range {
                   from = 0
                   to = 0
               }
               model = jsonencode({
                   expression = "$B > 70"
                   type = "math"
                   refId = "C"
               })
           }
       }
   }
   ```

1. Buka UI Grafana dan periksa aturan peringatan Anda.

   Anda dapat melihat apakah aturan peringatan menyala. Anda juga dapat melihat visualisasi setiap tahapan kueri aturan peringatan.

   Saat peringatan diaktifkan, Grafana merutekan notifikasi melalui kebijakan yang Anda tetapkan.

   Misalnya, jika Anda memilih Slack sebagai titik kontak, [Alertmanager](https://github.com/prometheus/alertmanager) tertanam Grafana secara otomatis memposting pesan ke Slack.

# Melihat sumber peringatan yang disediakan di Grafana
<a name="v10-alerting-setup-provision-view"></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 memverifikasi bahwa sumber peringatan Anda dibuat di Grafana.

**Untuk melihat sumber daya yang Anda sediakan di Grafana**

1. Buka instance Grafana Anda.

1. Arahkan ke Peringatan.

1. Klik folder sumber peringatan, misalnya, Aturan peringatan.

   Sumber daya yang disediakan diberi label **Provisioned**, sehingga jelas bahwa mereka tidak dibuat secara manual.

**catatan**  
Anda tidak dapat mengedit sumber daya yang disediakan dari Grafana. Anda hanya dapat mengubah properti sumber daya dengan mengubah file penyediaan dan memulai ulang Grafana atau melakukan hot reload. Ini mencegah perubahan yang dilakukan pada sumber daya yang akan ditimpa jika file disediakan lagi atau hot reload dilakukan.

# Konfigurasikan peringatan
<a name="v10-alerting-configure"></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)

Konfigurasikan fitur dan integrasi yang Anda butuhkan untuk membuat dan mengelola peringatan Anda.

**Topics**
+ [Konfigurasikan aturan peringatan terkelola Grafana](v10-alerting-configure-grafanamanaged.md)
+ [Konfigurasikan aturan peringatan terkelola sumber data](v10-alerting-configure-datasourcemanaged.md)
+ [Konfigurasikan aturan perekaman](v10-alerting-configure-recordingrules.md)
+ [Konfigurasikan titik kontak](v10-alerting-configure-contactpoints.md)
+ [Konfigurasikan kebijakan pemberitahuan](v10-alerting-configure-notification-policies.md)

# Konfigurasikan aturan peringatan terkelola Grafana
<a name="v10-alerting-configure-grafanamanaged"></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)

Aturan yang dikelola Grafana adalah jenis aturan peringatan yang paling fleksibel. Mereka memungkinkan Anda membuat peringatan yang dapat bertindak berdasarkan data dari sumber data kami yang didukung. Selain mendukung beberapa sumber data, Anda juga dapat menambahkan ekspresi untuk mengubah data Anda dan mengatur kondisi peringatan. Menggunakan gambar dalam pemberitahuan peringatan juga didukung. Ini adalah satu-satunya jenis aturan yang memungkinkan peringatan dari beberapa sumber data dalam satu definisi aturan.

Beberapa instance peringatan dapat dibuat sebagai hasil dari satu aturan peringatan (juga dikenal sebagai peringatan multi-dimensi).

Aturan peringatan terkelola Grafana hanya dapat diedit atau dihapus oleh pengguna dengan izin Edit untuk folder yang menyimpan aturan.

Jika Anda menghapus sumber peringatan yang dibuat di UI, Anda tidak dapat mengambilnya lagi. Untuk membuat cadangan konfigurasi Anda dan untuk dapat memulihkan sumber daya peringatan yang dihapus, buat sumber daya peringatan Anda menggunakan Terraform, atau API Peringatan.

Dalam prosedur berikut, kami akan melalui proses pembuatan aturan peringatan yang dikelola Grafana Anda.

Untuk membuat aturan peringatan yang dikelola Grafana, gunakan alur pembuatan peringatan di ruang kerja dan ikuti langkah-langkah berikut untuk membantu Anda.

**Tetapkan nama aturan peringatan**

1. Pilih **Peringatan** -> **Aturan peringatan** -> **\$1 Aturan peringatan baru**.

1. Masukkan nama untuk mengidentifikasi aturan peringatan Anda.

   Nama ini ditampilkan dalam daftar aturan peringatan. Ini juga merupakan `alertname` label untuk setiap instance peringatan yang dibuat dari aturan ini.

Selanjutnya, tentukan kueri untuk mendapatkan data yang ingin Anda ukur dan kondisi yang perlu dipenuhi sebelum aturan peringatan diaktifkan.

**Untuk menentukan query dan kondisi**

1. Pilih sumber data.

1. Dari **pilihan** dropdown, tentukan rentang [waktu](v10-dash-using-dashboards.md#v10-dash-setting-dashboard-time-range).
**catatan**  
Grafana Alerting hanya mendukung rentang waktu relatif tetap, misalnya,. `now-24hr: now`  
Ini tidak mendukung rentang waktu absolut: `2021-12-02 00:00:00 to 2021-12-05 23:59:592` atau rentang waktu semi-relatif:`now/d to: now`.

1. Tambahkan kueri.

   Untuk menambahkan beberapa [kueri](v10-panels-query-xform.md#v10-panels-query-xform-add), pilih **Tambahkan kueri**.

   Semua aturan peringatan dikelola oleh Grafana secara default. Jika Anda ingin beralih ke aturan peringatan yang dikelola sumber data, klik **Beralih ke aturan peringatan yang dikelola sumber data**.

1. Tambahkan satu atau lebih [ekspresi](v10-panels-query-xform-expressions.md).

   1. Untuk setiap ekspresi, pilih salah satu **kondisi Klasik** untuk membuat aturan peringatan tunggal, atau pilih dari opsi **Matematika**, **Kurangi**, dan **Sampel Ulang** untuk menghasilkan peringatan terpisah untuk setiap seri.
**catatan**  
Saat menggunakan Prometheus, Anda dapat menggunakan vektor instan dan fungsi bawaan, jadi Anda tidak perlu menambahkan ekspresi tambahan.

   1. Pilih **Pratinjau** untuk memverifikasi bahwa ekspresi berhasil.

1. [Opsional] Untuk menambahkan ambang pemulihan, aktifkan **ambang pemulihan kustom** dan isi nilai kapan aturan peringatan Anda harus berhenti diaktifkan.

   Anda hanya dapat menambahkan satu ambang pemulihan dalam kueri dan itu harus menjadi kondisi peringatan.

1. Pilih **Tetapkan sebagai kondisi peringatan** pada kueri atau ekspresi yang ingin Anda tetapkan sebagai kondisi peringatan Anda.

Gunakan evaluasi aturan peringatan untuk menentukan seberapa sering aturan peringatan harus dievaluasi dan seberapa cepat aturan tersebut harus mengubah statusnya.

Untuk melakukan ini, Anda perlu memastikan bahwa aturan peringatan Anda berada di grup evaluasi yang tepat dan menetapkan waktu periode tertunda yang paling sesuai untuk kasus penggunaan Anda.

**Untuk mengatur perilaku evaluasi peringatan**

1. Pilih folder atau pilih **\$1 Folder baru**.

1. Pilih grup evaluasi atau klik **\$1 Grup evaluasi baru**.

   Jika Anda membuat grup evaluasi baru, tentukan interval untuk grup.

   Semua aturan dalam kelompok yang sama dievaluasi secara bersamaan selama interval waktu yang sama.

1. Masukkan periode yang tertunda.

   Periode yang tertunda adalah periode di mana aturan peringatan dapat melanggar kondisi sampai menyala.

   Setelah kondisi terpenuhi, peringatan masuk ke status **Pending**. **Jika kondisi tetap aktif selama durasi yang ditentukan, peringatan akan beralih ke status **Firing**, jika tidak maka akan kembali ke keadaan Normal.**

1. Aktifkan notifikasi peringatan jeda, jika diperlukan.
**catatan**  
Jeda evaluasi aturan peringatan untuk mencegah peringatan berisik saat menyetel peringatan Anda. Menjeda menghentikan evaluasi aturan peringatan dan tidak membuat instance peringatan apa pun. Ini berbeda dengan pengaturan waktu bisu, yang menghentikan pemberitahuan agar tidak dikirimkan, tetapi masih memungkinkan evaluasi aturan peringatan dan pembuatan instance peringatan.  
Anda dapat menjeda evaluasi aturan peringatan untuk mencegah peringatan berisik saat menyetel peringatan Anda. Menjeda menghentikan evaluasi aturan peringatan dan tidak membuat instance peringatan apa pun. Ini berbeda dengan pengaturan waktu bisu, yang menghentikan pemberitahuan agar tidak dikirimkan, tetapi masih memungkinkan evaluasi aturan peringatan dan pembuatan instance peringatan.

1. Di **Konfigurasikan tidak ada data dan penanganan kesalahan**, konfigurasikan perilaku peringatan tanpa adanya data.

   Gunakan pedoman nanti di bagian ini.

Tambahkan label ke aturan peringatan Anda untuk menetapkan kebijakan notifikasi mana yang harus menangani instance peringatan pengaktifan Anda.

Semua aturan dan instance peringatan, terlepas dari labelnya, cocok dengan kebijakan pemberitahuan default. Jika tidak ada kebijakan bersarang, atau tidak ada kebijakan bersarang yang cocok dengan label dalam aturan peringatan atau instance peringatan, maka kebijakan notifikasi default adalah kebijakan yang cocok.

**Untuk mengonfigurasi notifikasi**

1. Tambahkan label jika Anda ingin mengubah cara pemberitahuan Anda dirutekan.

   Tambahkan label khusus dengan memilih pasangan kunci-nilai yang ada dari drop-down, atau tambahkan label baru dengan memasukkan kunci atau nilai baru.

1. Pratinjau pengaturan perutean instance peringatan Anda.

   Berdasarkan label yang ditambahkan, instance peringatan dirutekan ke kebijakan notifikasi yang ditampilkan.

   Perluas setiap kebijakan pemberitahuan untuk melihat detail selengkapnya.

1. Pilih **Lihat detail** untuk melihat detail perutean peringatan dan pratinjau.

Tambahkan [anotasi](v10-alerting-overview-labels.md#v10-alerting-overview-labels-annotations) untuk memberikan lebih banyak konteks pada peringatan dalam pesan pemberitahuan peringatan Anda.

Anotasi menambahkan metadata untuk memberikan informasi lebih lanjut tentang peringatan dalam pesan pemberitahuan peringatan Anda. Misalnya, tambahkan anotasi **Ringkasan** untuk memberi tahu Anda nilai mana yang menyebabkan peringatan diaktifkan atau server mana itu terjadi.

**Untuk menambahkan anotasi**

1. [Opsional] Tambahkan ringkasan.

   Ringkasan singkat tentang apa yang terjadi dan mengapa.

1. [Opsional] Tambahkan deskripsi.

   Deskripsi tentang apa yang dilakukan aturan peringatan.

1. [Opsional] Tambahkan URL Runbook.

   Halaman web tempat Anda menyimpan runbook untuk peringatan

1. [Opsional] Tambahkan anotasi khusus

1. [Opsional] Tambahkan dasbor dan tautan panel.

   Menautkan peringatan ke panel di dasbor.

1. Pilih **Simpan aturan**.

**Aturan tunggal dan multi-dimensi**

Untuk peringatan terkelola Grafana, Anda dapat membuat aturan dengan kondisi klasik atau Anda dapat membuat aturan multi-dimensi.
+ **Aturan dengan kondisi klasik**

  Gunakan ekspresi kondisi klasik untuk membuat aturan yang memicu peringatan tunggal saat kondisinya terpenuhi. Untuk kueri yang mengembalikan beberapa seri, Grafana tidak melacak status peringatan setiap seri. Akibatnya, Grafana hanya mengirimkan satu peringatan bahkan ketika kondisi peringatan terpenuhi untuk beberapa seri.
+ **Aturan multi-dimensi**

  Untuk menghasilkan peringatan terpisah untuk setiap seri, buat aturan multi-dimensi. Gunakan`Math`,`Reduce`, atau `Resample` ekspresi untuk membuat aturan multi-dimensi. Contoh:
  + Tambahkan `Reduce` ekspresi untuk setiap kueri ke nilai agregat dalam rentang waktu yang dipilih menjadi satu nilai (tidak diperlukan untuk [aturan yang menggunakan data numerik](v10-alerting-overview-numeric.md)).
  + Tambahkan `Math` ekspresi dengan kondisi untuk aturan. Tidak diperlukan jika kueri atau ekspresi pengurangan sudah mengembalikan `0` if rule tidak boleh diaktifkan, atau angka positif jika harus diaktifkan. Beberapa contoh: `$B > 70` jika harus menyala jika nilai B query/expression lebih dari 70. `$B < $C * 100`dalam hal itu harus menyala jika nilai B kurang dari nilai C dikalikan dengan 100. Jika kueri yang dibandingkan memiliki beberapa seri dalam hasilnya, seri dari kueri yang berbeda dicocokkan jika mereka memiliki label yang sama atau satu adalah bagian dari yang lain.

**catatan**  
Grafana tidak mendukung kueri peringatan dengan variabel template. Informasi lebih lanjut tersedia di [https://community.grafana.com/t/ - - template-variables-are-not /2514](https://community.grafana.com/t/template-variables-are-not-supported-in-alert-queries-while-setting-up-alert/2514). supported-in-alert-queries while-setting-up-alert

**Konfigurasikan tidak ada data dan penanganan kesalahan**

Konfigurasikan perilaku peringatan saat evaluasi aturan peringatan Anda tidak menampilkan data atau kesalahan.

**catatan**  
Aturan peringatan yang dikonfigurasi untuk diaktifkan ketika evaluasi tidak mengembalikan data atau kesalahan hanya menyala ketika seluruh durasi periode evaluasi telah selesai. **Ini berarti bahwa alih-alih segera menyala ketika kondisi aturan peringatan dilanggar, aturan peringatan menunggu hingga waktu yang ditetapkan sebagai bidang For telah selesai dan kemudian menyala, mengurangi kebisingan peringatan dan memungkinkan masalah ketersediaan data sementara.**

Jika evaluasi aturan peringatan Anda tidak mengembalikan data, Anda dapat mengatur status pada aturan peringatan Anda untuk muncul sebagai berikut:


| Tidak ada Data | Deskripsi | 
| --- | --- | 
| Tidak ada Data | Membuat peringatan baru DatasourceNoData dengan nama dan UID aturan peringatan, dan UID sumber data yang tidak mengembalikan data sebagai label. | 
| Peringatan | Menetapkan status aturan peringatan keAlerting. Aturan peringatan menunggu sampai waktu yang ditetapkan di bidang For telah selesai sebelum ditembakkan. | 
| Oke | Menetapkan status aturan peringatan keNormal. | 

Jika evaluasi Anda menampilkan kesalahan, Anda dapat mengatur status pada aturan peringatan Anda untuk muncul sebagai berikut:


| Kesalahan | Deskripsi | 
| --- | --- | 
| Kesalahan | Membuat instance peringatan DatasourceError dengan nama dan UID dari aturan peringatan, dan UID sumber data yang tidak mengembalikan data sebagai label. | 
| Peringatan | Menetapkan status aturan peringatan keAlerting. Aturan peringatan menunggu sampai waktu yang ditetapkan di bidang For telah selesai sebelum ditembakkan. | 
| Oke | Menetapkan status aturan peringatan keNormal. | 

**Selesaikan contoh peringatan basi**

Instance peringatan dianggap basi jika dimensi atau deretnya telah hilang dari hasil kueri seluruhnya selama dua interval evaluasi.

Instance peringatan basi yang berada di `Error` status`Alerting`/`NoData`/secara otomatis ditandai sebagai `Resolved` dan `grafana_state_reason` anotasi ditambahkan ke instance peringatan dengan alasannya. `MissingSeries`

**Buat peringatan dari panel**

Buat peringatan dari jenis panel apa pun. Ini berarti Anda dapat menggunakan kembali kueri di panel dan membuat peringatan berdasarkan pada mereka.

1. Arahkan ke dasbor di bagian **Dasbor**.

1. Di sudut kanan atas panel, pilih tiga titik (elips).

1. Dari menu tarik-turun, pilih **Lainnya...** dan kemudian pilih Aturan **peringatan baru**.

Ini akan membuka formulir aturan peringatan, memungkinkan Anda untuk mengkonfigurasi dan membuat peringatan Anda berdasarkan kueri panel saat ini.

# Konfigurasikan aturan peringatan terkelola sumber data
<a name="v10-alerting-configure-datasourcemanaged"></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)

Buat aturan peringatan untuk instance Grafana Mimir atau Loki eksternal yang mengaktifkan API penggaris; ini disebut aturan peringatan terkelola sumber data.

**catatan**  
Aturan peringatan untuk instance Grafana Mimir atau Loki eksternal dapat diedit atau dihapus oleh pengguna dengan peran Editor atau Admin.  
Jika Anda menghapus sumber peringatan yang dibuat di UI, Anda tidak dapat mengambilnya lagi. Untuk membuat cadangan konfigurasi Anda dan untuk dapat memulihkan sumber daya peringatan yang dihapus, buat sumber daya peringatan Anda menggunakan Terraform, atau API Peringatan.

**Prasyarat**
+ Verifikasi bahwa Anda memiliki izin menulis ke sumber data Prometheus atau Loki. Jika tidak, Anda tidak akan dapat membuat atau memperbarui aturan peringatan terkelola Grafana Mimir.
+ Untuk sumber data Grafana Mimir dan Loki, aktifkan Ruler API dengan mengonfigurasi layanan masing-masing.
  + **Loki** - Jenis penyimpanan `local` aturan, default untuk sumber data Loki, hanya mendukung tampilan aturan. Untuk mengedit aturan, konfigurasikan salah satu jenis penyimpanan aturan lainnya.
  + **Grafana Mimir** - gunakan awalan. `/prometheus` [https://grafana.com/docs/mimir/latest/operators-guide/reference-http-api/#querier--query-frontend](https://grafana.com/docs/mimir/latest/operators-guide/reference-http-api/#querier--query-frontend) Anda tidak dapat memberikan URL terpisah untuk Ruler API.

**catatan**  
**Jika Anda tidak ingin mengelola aturan peringatan untuk sumber data Loki atau Prometheus tertentu, buka pengaturannya dan hapus kotak centang Kelola peringatan melalui peringatan UI.**

Dalam prosedur berikut, kami akan memandu Anda melalui proses pembuatan aturan peringatan terkelola sumber data Anda.

Untuk membuat aturan peringatan yang dikelola sumber data, gunakan alur pembuatan peringatan di ruang kerja dan ikuti langkah-langkah berikut untuk membantu Anda.

**Untuk menyetel nama aturan peringatan**

1. Pilih **Peringatan** -> **Aturan peringatan** -> **\$1 Aturan peringatan baru**.

1. Masukkan nama untuk mengidentifikasi aturan peringatan Anda.

   Nama ini ditampilkan dalam daftar aturan peringatan. Ini juga merupakan `alertname` label untuk setiap instance peringatan yang dibuat dari aturan ini.

Tentukan kueri untuk mendapatkan data yang ingin Anda ukur dan kondisi yang perlu dipenuhi sebelum aturan peringatan diaktifkan.

**Untuk menentukan kueri dan kondisi**

1. Semua aturan peringatan dikelola oleh Grafana secara default. Untuk beralih ke aturan peringatan terkelola sumber data, pilih **Beralih ke aturan peringatan yang dikelola sumber data**.

1. Pilih sumber data dari daftar drop-down.

   Anda juga dapat memilih **Buka pemilih sumber data lanjutan** untuk melihat opsi lainnya, termasuk menambahkan sumber data (Khusus admin).

1. Masukkan kueri PromQL atau LogQL.

1. Pilih **Pratinjau lansiran.**

Gunakan evaluasi aturan peringatan untuk menentukan seberapa sering aturan peringatan harus dievaluasi dan seberapa cepat aturan tersebut harus mengubah statusnya.

**Untuk mengatur perilaku evaluasi peringatan**

1. Pilih namespace atau pilih **\$1 Namespace baru**.

1. Pilih grup evaluasi atau pilih **\$1 Grup evaluasi baru**.

   Jika Anda membuat grup evaluasi baru, tentukan interval untuk grup.

   Semua aturan dalam kelompok yang sama dievaluasi secara berurutan selama interval waktu yang sama.

1. Masukkan periode yang tertunda.

   Periode yang tertunda adalah periode di mana aturan peringatan dapat melanggar kondisi sampai menyala.

   Setelah suatu kondisi terpenuhi, peringatan masuk ke `Pending` negara bagian. Jika kondisi tetap aktif selama durasi yang ditentukan, peringatan akan beralih ke status, jika tidak, `Firing` kondisi akan kembali ke status. `Normal`

Tambahkan label ke aturan peringatan Anda untuk menetapkan kebijakan notifikasi mana yang harus menangani instance peringatan pengaktifan Anda.

Semua aturan dan instance peringatan, terlepas dari labelnya, cocok dengan kebijakan pemberitahuan default. Jika tidak ada kebijakan bersarang, atau tidak ada kebijakan bersarang yang cocok dengan label dalam aturan peringatan atau instance peringatan, maka kebijakan notifikasi default adalah kebijakan yang cocok.

**Mengonfigurasi notifikasi**
+ Tambahkan label jika Anda ingin mengubah cara pemberitahuan Anda dirutekan.

  Tambahkan label khusus dengan memilih pasangan kunci-nilai yang ada dari drop-down, atau tambahkan label baru dengan memasukkan kunci atau nilai baru.

Tambahkan [anotasi](v10-alerting-overview-labels.md#v10-alerting-overview-labels-annotations) untuk memberikan lebih banyak konteks pada peringatan di notifikasi peringatan Anda.

Anotasi menambahkan metadata untuk memberikan informasi lebih lanjut tentang peringatan di notifikasi peringatan Anda. Misalnya, tambahkan `Summary` anotasi untuk memberi tahu Anda nilai mana yang menyebabkan peringatan diaktifkan atau server mana itu terjadi.

**Untuk menambahkan anotasi**

1. [Opsional] Tambahkan ringkasan.

   Ringkasan singkat tentang apa yang terjadi dan mengapa.

1. [Opsional] Tambahkan deskripsi.

   Deskripsi tentang apa yang dilakukan aturan peringatan.

1. [Opsional] Tambahkan URL Runbook.

   Halaman web tempat Anda menyimpan runbook untuk peringatan

1. [Opsional] Tambahkan anotasi khusus

1. [Opsional] Tambahkan dasbor dan tautan panel.

   Menautkan peringatan ke panel di dasbor.

1. Pilih **Simpan aturan**.

# Konfigurasikan aturan perekaman
<a name="v10-alerting-configure-recordingrules"></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 dan mengelola aturan perekaman untuk instans Grafana Mimir atau Loki eksternal. Aturan perekaman menghitung ekspresi yang sering dibutuhkan atau ekspresi mahal secara komputasi terlebih dahulu dan menyimpan hasilnya sebagai rangkaian waktu baru. Menanyakan deret waktu baru ini lebih cepat, terutama untuk dasbor karena mereka menanyakan ekspresi yang sama setiap kali dasbor disegarkan.

**catatan**  
Aturan perekaman dijalankan sebagai aturan instance, dan dijalankan setiap 10 detik.

**Prasyarat**
+ Verifikasi bahwa Anda memiliki izin menulis ke sumber data Prometheus atau Loki. Anda akan membuat atau memperbarui aturan peringatan di sumber data Anda.
+ Untuk sumber data Grafana Mimir dan Loki, aktifkan API penggaris dengan mengonfigurasi layanan masing-masing.
  + **Loki** — Jenis penyimpanan `local` aturan, default untuk sumber data Loki, hanya mendukung tampilan aturan. Untuk mengedit aturan, konfigurasikan salah satu jenis penyimpanan lainnya.
  + **Grafana Mimir** — Gunakan awalan. `/prometheus` Sumber data Prometheus mendukung Grafana Mimir dan Prometheus, dan Grafana mengharapkan bahwa API Kueri dan API Penggaris berada di bawah URL yang sama. Anda tidak dapat memberikan URL terpisah untuk Ruler API.

**catatan**  
**Jika Anda tidak ingin mengelola aturan peringatan untuk sumber data Loki atau Prometheus tertentu, buka pengaturannya dan hapus kotak centang Kelola peringatan melalui UI Peringatan.**

**Untuk membuat aturan perekaman**

1. **Dari konsol Grafana Anda, di menu Grafana, pilih **Peringatan, Aturan Peringatan**.**

1. Pilih **Aturan perekaman baru**.

1. Tetapkan nama aturan.

   Nama aturan perekaman harus berupa nama metrik Prometheus dan tidak mengandung spasi putih.

1. Tentukan kueri
   + Pilih sumber data Loki atau Prometheus Anda.
   + Masukkan kueri.

1. Tambahkan namespace dan grup.
   + Dari tarik-turun **Namespace**, pilih namespace aturan yang ada atau tambahkan yang baru. Ruang nama dapat berisi satu atau lebih grup aturan dan hanya memiliki tujuan organisasi.
   + Dari dropdown **Grup**, pilih grup yang ada di dalam namespace yang dipilih atau tambahkan yang baru. Aturan yang baru dibuat ditambahkan ke akhir grup. Aturan dalam grup dijalankan secara berurutan pada interval reguler, dengan waktu evaluasi yang sama.

1. Tambahkan label.
   + Tambahkan label kustom memilih pasangan kunci-nilai yang ada dari dropdown, atau tambahkan label baru dengan memasukkan kunci atau nilai baru.

1. Pilih **Simpan aturan** untuk menyimpan aturan, atau **Simpan aturan dan keluar** untuk menyimpan aturan dan kembali ke halaman Peringatan.

# Konfigurasikan titik kontak
<a name="v10-alerting-configure-contactpoints"></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)

Gunakan titik kontak untuk menentukan bagaimana kontak Anda diberi tahu saat aturan peringatan diaktifkan.

**catatan**  
Anda dapat membuat dan mengedit titik kontak untuk peringatan terkelola Grafana. Titik kontak untuk lansiran terkelola sumber data bersifat hanya-baca.

## Bekerja dengan titik kontak
<a name="v10-alerting-configure-contactpoints-working"></a>

Prosedur berikut menunjukkan cara menambahkan, mengedit, menghapus, dan menguji titik kontak.

**Untuk menambahkan titik kontak**

1. **Di menu sebelah kiri, pilih Alerting.**

1. Pilih **Titik kontak**.

1. Dari menu tarik-turun **Pilih Alertmanager**, pilih Alertmanager. Grafana Alertmanager dipilih secara default.

1. Pada tab **Poin Kontak**, pilih **\$1 Tambahkan titik kontak**.

1. Masukkan **Nama** untuk titik kontak.

1. Dari **Integrasi**, pilih jenis, dan isi kolom wajib berdasarkan jenis itu. Misalnya, jika Anda memilih Slack, masukkan saluran Slack dan pengguna yang harus dihubungi.

1. Jika tersedia untuk titik kontak yang Anda pilih, pilih **Pengaturan opsional** yang diinginkan untuk menentukan pengaturan tambahan.

1. Di bawah **Pengaturan pemberitahuan**, pilih **Nonaktifkan pesan yang diselesaikan** secara opsional jika Anda tidak ingin diberi tahu saat peringatan diselesaikan.

1. Untuk menambahkan integrasi titik kontak lainnya, pilih **Tambahkan integrasi titik kontak** dan ulangi langkah-langkah untuk setiap jenis titik kontak yang diperlukan.

1. Simpan perubahan Anda.

**Untuk mengedit titik kontak**

1. **Di menu sebelah kiri, pilih Alerting.**

1. Pilih **Titik kontak** untuk melihat daftar titik kontak yang ada.

1. Pilih titik kontak yang akan diedit, lalu pilih **Edit**.

1. Perbarui titik kontak, lalu simpan perubahan Anda.

Anda dapat menghapus titik kontak yang tidak digunakan oleh kebijakan pemberitahuan.

**Untuk menghapus titik kontak**

1. **Di menu sebelah kiri, pilih Alerting.**

1. Pilih **Titik kontak** untuk membuka daftar titik kontak yang ada.

1. Pada **titik Kontak**, pilih titik kontak yang akan dihapus, lalu pilih **Lainnya**, **Hapus**.

1. Di kotak dialog konfirmasi, pilih **Ya, hapus**.

**catatan**  
Jika titik kontak digunakan oleh kebijakan notifikasi, Anda harus menghapus kebijakan notifikasi atau mengeditnya untuk menggunakan titik kontak yang berbeda sebelum menghapus titik kontak.

Setelah titik kontak Anda dibuat, Anda dapat mengirim pemberitahuan pengujian untuk memverifikasi bahwa itu dikonfigurasi dengan benar.

**Untuk mengirim pemberitahuan pengujian**

1. **Di menu sebelah kiri, pilih Alerting.**

1. Pilih **Titik kontak** untuk membuka daftar titik kontak yang ada.

1. Pada **titik Kontak**, pilih titik kontak yang akan diuji, lalu pilih **Edit**. Anda juga dapat membuat titik kontak baru jika diperlukan.

1. Pilih **Uji** untuk membuka dialog pengujian titik kontak.

1. Pilih apakah akan mengirim pemberitahuan pengujian yang telah ditentukan sebelumnya atau pilih **Kustom** untuk menambahkan anotasi dan label kustom Anda sendiri dalam pemberitahuan pengujian.

1. Pilih **Kirim pemberitahuan pengujian** untuk menguji peringatan dengan titik kontak yang diberikan.

## Konfigurasikan integrasi titik kontak
<a name="v10-alerting-configure-contactpoints-integration"></a>

Konfigurasikan integrasi titik kontak di Grafana untuk memilih saluran komunikasi pilihan Anda untuk menerima notifikasi saat aturan peringatan diaktifkan. Setiap integrasi memiliki opsi konfigurasi dan proses penyiapannya sendiri. Dalam kebanyakan kasus, ini melibatkan penyediaan kunci API atau URL Webhook.

Setelah dikonfigurasi, Anda dapat menggunakan integrasi sebagai bagian dari titik kontak Anda untuk menerima pemberitahuan setiap kali peringatan Anda mengubah statusnya. Di bagian ini, kami akan membahas langkah-langkah dasar untuk mengonfigurasi integrasi, menggunakan PagerDuty sebagai contoh, sehingga Anda dapat mulai menerima peringatan waktu nyata dan tetap mengikuti data pemantauan Anda.

**Daftar integrasi yang didukung**

Tabel berikut mencantumkan jenis titik kontak yang didukung oleh Grafana.


| Nama | Tipe | 
| --- | --- | 
| Amazon SNS | `sns` | 
| OpsGenie | `opsgenie` | 
| Tugas Pager | `pagerduty` | 
| Slack | `slack` | 
| VictorOps | `victorops` | 

**Mengkonfigurasi PagerDuty untuk peringatan**

Untuk mengatur PagerDuty, Anda harus memberikan kunci integrasi. Berikan detail berikut.


| Pengaturan | Deskripsi | 
| --- | --- | 
| Kunci Integrasi | Kunci integrasi untuk PagerDuty | 
| Kepelikan | Level untuk notifikasi dinamis. Default-nya adalah critical. | 
| Detail Kustom | Detail tambahan tentang acara tersebut | 

`CustomDetails`Bidang adalah objek yang berisi pasangan kunci-nilai arbitrer. Detail yang ditentukan pengguna digabungkan dengan yang digunakan secara default.

Nilai default untuk `CustomDetails` adalah:

```
{
	"firing":       `{{ template "__text_alert_list" .Alerts.Firing }}`,
	"resolved":     `{{ template "__text_alert_list" .Alerts.Resolved }}`,
	"num_firing":   `{{ .Alerts.Firing | len }}`,
	"num_resolved": `{{ .Alerts.Resolved | len }}`,
}
```

Dalam kasus kunci duplikat, detail yang ditentukan pengguna menimpa yang default.

# Konfigurasikan kebijakan pemberitahuan
<a name="v10-alerting-configure-notification-policies"></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)

Kebijakan pemberitahuan menentukan bagaimana peringatan diarahkan ke titik kontak.

Kebijakan memiliki struktur pohon, di mana setiap kebijakan dapat memiliki satu atau lebih kebijakan bersarang. Setiap kebijakan, kecuali kebijakan default, juga dapat mencocokkan label peringatan tertentu.

Setiap peringatan dievaluasi oleh kebijakan default dan selanjutnya oleh setiap kebijakan bersarang.

Jika Anda mengaktifkan `Continue matching subsequent sibling nodes` opsi untuk kebijakan bersarang, evaluasi akan berlanjut bahkan setelah satu atau beberapa kecocokan. Pengaturan konfigurasi kebijakan induk dan informasi titik kontak mengatur perilaku peringatan yang tidak cocok dengan kebijakan turunan mana pun. Kebijakan default mengatur peringatan apa pun yang tidak cocok dengan kebijakan bersarang.

Untuk informasi selengkapnya tentang kebijakan notifikasi, lihat[Notifikasi](v10-alerting-explore-notifications.md).

Prosedur berikut menunjukkan cara membuat dan mengelola kebijakan notifikasi.

**Untuk mengedit kebijakan pemberitahuan default**

1. **Di menu sebelah kiri, pilih Alerting.**

1. Pilih **Kebijakan pemberitahuan**.

1. Dari dropdown **Pilih Alertmanager**, pilih Alertmanager yang ingin Anda edit.

1. Di bagian **Kebijakan default**, pilih**...** , **Sunting**.

1. Di **titik kontak default**, perbarui titik kontak tempat pemberitahuan harus dikirim untuk aturan saat aturan peringatan tidak cocok dengan kebijakan tertentu.

1. Di **Grup menurut**, pilih label untuk mengelompokkan peringatan berdasarkan. Jika beberapa peringatan dicocokkan dengan kebijakan ini, maka mereka dikelompokkan berdasarkan label ini. Pemberitahuan dikirim per grup. Jika bidang kosong (default), maka semua notifikasi dikirim dalam satu grup. Gunakan label khusus, `...` untuk mengelompokkan peringatan berdasarkan semua label (yang secara efektif menonaktifkan pengelompokan).

1. Di **Opsi waktu**, pilih dari opsi berikut.
   + **Tunggu grup** — Saatnya menunggu untuk menyangga peringatan dari grup yang sama sebelum mengirim pemberitahuan awal. Waktu default-nya adalah 30 detik.
   + **Interval grup** — Interval waktu minimum antara dua pemberitahuan untuk grup. Default adalah 5 menit.
   + **Interval pengulangan** — Interval waktu minimum sebelum mengirim ulang pemberitahuan jika tidak ada peringatan baru yang ditambahkan ke grup. Defaultnya adalah 4 jam.

1. Pilih **Simpan** untuk menyimpan perubahan Anda.

Untuk membuat kebijakan notifikasi baru, Anda harus mengikuti struktur pohonnya. Kebijakan baru yang dibuat di batang pohon (kebijakan default), adalah cabang pohon. Setiap cabang dapat memiliki kebijakan bersarang mereka sendiri. Inilah sebabnya mengapa Anda akan selalu menambahkan kebijakan **bersarang** baru, baik di bawah kebijakan default, atau di bawah kebijakan yang sudah bersarang.

**Untuk menambahkan kebijakan bersarang baru**

1. **Di menu sebelah kiri, pilih Alerting.**

1. Pilih **Kebijakan pemberitahuan**.

1. Dari dropdown **Pilih Alertmanager**, pilih Alertmanager yang ingin Anda edit.

1. **Untuk menambahkan kebijakan spesifik tingkat atas, buka bagian Perutean khusus (misalnya ke kebijakan default, atau ke kebijakan lain yang ada di mana Anda ingin menambahkan kebijakan bersarang baru) dan pilih \$1 Kebijakan bersarang baru.**

1. Di bagian label yang cocok, tambahkan satu atau beberapa aturan untuk mencocokkan label peringatan.

1. Di menu tarik-turun **Titik kontak**, pilih titik kontak untuk mengirim pemberitahuan jika peringatan hanya cocok dengan kebijakan khusus ini dan bukan kebijakan bersarang apa pun.

1. Secara opsional, aktifkan **Lanjutkan pencocokan node saudara berikutnya** untuk terus mencocokkan kebijakan saudara kandung bahkan setelah peringatan cocok dengan kebijakan saat ini. Ketika opsi ini diaktifkan, Anda bisa mendapatkan lebih dari satu pemberitahuan untuk satu peringatan.

1. Secara opsional, aktifkan **pengelompokan Override** untuk menentukan pengelompokan yang sama dengan kebijakan default. Jika opsi tidak diaktifkan, pengelompokan kebijakan default akan digunakan.

1. Secara opsional, aktifkan **Ganti pengaturan waktu umum** untuk mengganti opsi waktu yang dikonfigurasi dalam kebijakan pemberitahuan grup.

1. Pilih **Simpan kebijakan** untuk menyimpan perubahan Anda.

**Untuk mengedit kebijakan bersarang**

1. **Di menu sebelah kiri, pilih Alerting.**

1. Pilih **Kebijakan pemberitahuan**.

1. Pilih kebijakan yang ingin Anda edit, lalu pilih**...** , **Sunting**.

1. Buat perubahan apa pun (seperti saat menambahkan kebijakan bersarang).

1. Simpan perubahan Anda.

**Mencari kebijakan**

Anda dapat mencari di dalam pohon kebijakan berdasarkan *pencocokan Label atau titik* *kontak*.
+ Untuk mencari berdasarkan titik kontak, masukkan nama sebagian atau lengkap titik kontak di bidang **Cari berdasarkan titik kontak**. Kebijakan yang menggunakan titik kontak tersebut akan disorot di antarmuka pengguna.
+ Untuk mencari berdasarkan label, masukkan pencocokan label yang valid di kolom input **Cari berdasarkan pencocokan**. Beberapa matcher dapat dimasukkan, dipisahkan dengan koma. Misalnya, masukan pencocokan yang valid bisa `severity=high, region=~EMEA|NA` jadi.
**catatan**  
Saat mencari berdasarkan label, semua kebijakan yang cocok akan sama persis. Pertandingan sebagian dan pertandingan gaya regeks tidak didukung.

# Kelola lansiran Anda
<a name="v10-alerting-manage"></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)

Setelah menyiapkan aturan peringatan, titik kontak, dan kebijakan notifikasi, Anda dapat menggunakan peringatan Grafana untuk mengelola lansiran Anda dalam praktik.

**Topics**
+ [Sesuaikan notifikasi](v10-alerting-manage-notifications.md)
+ [Kelola titik kontak](v10-alerting-manage-contactpoints.md)
+ [Membungkam pemberitahuan peringatan](v10-alerting-silences.md)
+ [Lihat dan filter aturan peringatan](v10-alerting-manage-rules-viewfilter.md)
+ [Bisukan waktu](v10-alerting-manage-muting.md)
+ [Lihat keadaan dan kesehatan aturan peringatan](v10-alerting-manage-rulestate.md)
+ [Lihat dan filter menurut grup peringatan](v10-alerting-manage-viewfiltergroups.md)
+ [Lihat kesalahan pemberitahuan](v10-alerting-manage-viewnotificationerrors.md)

# Sesuaikan notifikasi
<a name="v10-alerting-manage-notifications"></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)

Sesuaikan notifikasi Anda dengan templat notifikasi.

Anda dapat menggunakan templat notifikasi untuk mengubah judul, pesan, dan format pesan di notifikasi.

Template notifikasi tidak terkait dengan integrasi titik kontak tertentu, seperti Amazon SNS atau Slack. Namun, Anda dapat memilih untuk membuat templat notifikasi terpisah untuk integrasi titik kontak yang berbeda.

Anda dapat menggunakan template notifikasi untuk:
+ Menambahkan, menghapus, atau mengurutkan ulang informasi dalam pemberitahuan termasuk ringkasan, deskripsi, label dan anotasi, nilai, dan tautan
+ Format teks dalam huruf tebal dan miring, dan tambahkan atau hapus jeda baris

Anda tidak dapat menggunakan templat notifikasi untuk:
+ Ubah desain notifikasi di layanan pesan instan seperti Slack dan Microsoft Teams

**Topics**
+ [Menggunakan bahasa template Go](v10-alerting-notifications-go-templating.md)
+ [Buat templat notifikasi](v10-alerting-create-templates.md)
+ [Menggunakan template notifikasi](#v10-alerting-use-notification-templates)
+ [Referensi templat](v10-alerting-template-reference.md)

# Menggunakan bahasa template Go
<a name="v10-alerting-notifications-go-templating"></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 menulis template notifikasi dalam bahasa template Go, [teks/template](https://pkg.go.dev/text/template).

Bagian ini memberikan ikhtisar bahasa template Go dan template penulisan dalam teks/template.

## Dot
<a name="v10-go-dot"></a>

Di text/template sana ada kursor khusus yang disebut titik, dan ditulis sebagai`.`. Anda dapat menganggap kursor ini sebagai variabel yang nilainya berubah tergantung di mana dalam template itu digunakan. Misalnya, pada awal template notifikasi `.` mengacu pada `ExtendedData` objek, yang berisi sejumlah bidang termasuk`Alerts`,,`Status`, `GroupLabels``CommonLabels`, `CommonAnnotations` dan`ExternalURL`. Namun, dot mungkin merujuk ke sesuatu yang lain saat digunakan dalam daftar di `range` atas, saat digunakan di dalam`with`, atau saat menulis templat fitur untuk digunakan di templat lain. Anda dapat melihat contoh ini di[Buat templat notifikasi](v10-alerting-create-templates.md), dan semua data dan fungsi di[Referensi templat](v10-alerting-template-reference.md).

## Membuka dan menutup tag
<a name="v10-go-openclosetags"></a>

Dalam teks/template, template dimulai dengan `{{` dan diakhiri dengan `}}` terlepas dari apakah template mencetak variabel atau menjalankan struktur kontrol seperti pernyataan if. Ini berbeda dari bahasa templating lainnya seperti Jinja di mana pencetakan variabel menggunakan `{{` dan `}}` dan struktur kontrol menggunakan `{%` dan. `%}`

## Cetak
<a name="v10-go-print"></a>

Untuk mencetak nilai sesuatu gunakan `{{` dan`}}`. Anda dapat mencetak nilai titik, bidang titik, hasil fungsi, dan nilai [variabel](#v10-go-variables). Misalnya, untuk mencetak `Alerts` bidang di mana titik mengacu pada `ExtendedData` Anda akan menulis yang berikut:

```
{{ .Alerts }}
```

## Iterasi di atas peringatan
<a name="v10-go-iterate-alerts"></a>

Untuk mencetak hanya label setiap peringatan, bukan semua informasi tentang peringatan, Anda dapat menggunakan a `range` untuk mengulangi peringatan di: `ExtendedData`

```
{{ range .Alerts }}
{{ .Labels }}
{{ end }}
```

Di dalam rentang titik tidak lagi mengacu pada`ExtendedData`, tetapi ke`Alert`. Anda dapat menggunakan `{{ .Labels }}` untuk mencetak label setiap peringatan. Ini berfungsi karena `{{ range .Alerts }}` perubahan titik untuk merujuk ke peringatan saat ini dalam daftar peringatan. Ketika rentang selesai titik diatur ulang ke nilai yang dimilikinya sebelum dimulainya rentang, yang dalam contoh ini adalah`ExtendedData`:

```
{{ range .Alerts }}
{{ .Labels }}
{{ end }}
{{/* does not work, .Labels does not exist here */}}
{{ .Labels }}
{{/* works, cursor was reset */}}
{{ .Status }}
```

## Ulangi anotasi dan label
<a name="v10-go-iterate-labels"></a>

Mari kita menulis template untuk mencetak label setiap peringatan dalam format`The name of the label is $name, and the value is $value`, di mana `$name` dan `$value` berisi nama dan nilai setiap label.

Seperti pada contoh sebelumnya, gunakan rentang untuk mengulangi peringatan `.Alerts` sedemikian rupa sehingga titik mengacu pada peringatan saat ini dalam daftar peringatan, dan kemudian gunakan rentang kedua pada label yang diurutkan sehingga titik diperbarui untuk kedua kalinya untuk merujuk ke label saat ini. Di dalam rentang kedua gunakan `.Name` dan `.Value` untuk mencetak nama dan nilai setiap label:

```
{{ range .Alerts }}
{{ range .Labels.SortedPairs }}
The name of the label is {{ .Name }}, and the value is {{ .Value }}
{{ end }}
{{ range .Annotations.SortedPairs }}
The name of the annotation is {{ .Name }}, and the value is {{ .Value }}
{{ end }}
{{ end }}
```

## Fungsi indeks
<a name="v10-go-index"></a>

Untuk mencetak anotasi atau label tertentu, gunakan `index` fungsi.

```
{{ range .Alerts }}
The name of the alert is {{ index .Labels "alertname" }}
{{ end }}
```

## Jika pernyataan
<a name="v10-go-if"></a>

Anda dapat menggunakan pernyataan if dalam template. Misalnya, untuk mencetak `There are no alerts` jika tidak ada peringatan di `.Alerts` Anda akan menulis yang berikut:

```
{{ if .Alerts }}
There are alerts
{{ else }}
There are no alerts
{{ end }}
```

## Dengan
<a name="v10-go-with"></a>

Dengan mirip dengan pernyataan if, namun tidak seperti pernyataan if, `with` pembaruan titik untuk merujuk ke nilai with:

```
{{ with .Alerts }}
There are {{ len . }} alert(s)
{{ else }}
There are no alerts
{{ end }}
```

## Variabel
<a name="v10-go-variables"></a>

Variabel dalam text/template harus dibuat dalam template. Misalnya, untuk membuat variabel yang disebut `$variable` dengan nilai titik saat ini Anda akan menulis yang berikut ini:

```
{{ $variable := . }}
```

Anda dapat menggunakan `$variable` di dalam rentang atau `with` dan itu akan merujuk ke nilai titik pada saat variabel didefinisikan, bukan nilai titik saat ini.

Misalnya, Anda tidak dapat menulis templat yang digunakan `{{ .Labels }}` dalam rentang kedua karena di sini titik mengacu pada label saat ini, bukan peringatan saat ini:

```
{{ range .Alerts }}
{{ range .Labels.SortedPairs }}
{{ .Name }} = {{ .Value }}
{{/* does not work because in the second range . is a label not an alert */}}
There are {{ len .Labels }}
{{ end }}
{{ end }}
```

Anda dapat memperbaikinya dengan mendefinisikan variabel yang disebut `$alert` dalam rentang pertama dan sebelum rentang kedua:

```
{{ range .Alerts }}
{{ $alert := . }}
{{ range .Labels.SortedPairs }}
{{ .Name }} = {{ .Value }}
{{/* works because $alert refers to the value of dot inside the first range */}}
There are {{ len $alert.Labels }}
{{ end }}
{{ end }}
```

## Rentang dengan indeks
<a name="v10-go-rangeindex"></a>

Anda bisa mendapatkan indeks setiap peringatan dalam rentang dengan mendefinisikan indeks dan variabel nilai di awal rentang:

```
{{ $num_alerts := len .Alerts }}
{{ range $index, $alert := .Alerts }}
This is alert {{ $index }} out of {{ $num_alerts }}
{{ end }}
```

## Tentukan templat
<a name="v10-go-define"></a>

Anda dapat menentukan template yang dapat digunakan dalam template lain, menggunakan `define` dan nama template dalam tanda kutip ganda. Anda tidak boleh mendefinisikan template dengan nama yang sama dengan template lain, termasuk template default seperti`__subject`,`__text_values_list`,`__text_alert_list`, `default.title` dan`default.message`. Jika templat telah dibuat dengan nama yang sama dengan templat default, atau templat di templat notifikasi lain, Grafana mungkin menggunakan salah satu templat. Grafana tidak mencegah, atau menampilkan pesan kesalahan, ketika ada dua atau lebih templat dengan nama yang sama.

```
{{ define "print_labels" }}
{{ end }}
```

## Jalankan template
<a name="v10-go-execute"></a>

Anda dapat mengeksekusi template yang ditentukan dalam template Anda menggunakan`template`, nama template dalam tanda kutip ganda, dan kursor yang harus diteruskan ke template:

```
{{ template "print_labels" . }}
```

## Meneruskan data ke template
<a name="v10-go-passdata"></a>

Dalam titik template mengacu pada nilai yang diteruskan ke template.

Misalnya, jika templat dilewatkan daftar peringatan penembakan maka dot mengacu pada daftar peringatan penembakan tersebut:

```
{{ template "print_alerts" .Alerts }}
```

Jika templat dilewatkan label yang diurutkan untuk peringatan maka dot mengacu pada daftar label yang diurutkan:

```
{{ template "print_labels" .SortedLabels }}
```

Ini berguna saat menulis templat yang dapat digunakan kembali. Misalnya, untuk mencetak semua peringatan, Anda dapat menulis yang berikut ini:

```
{{ template "print_alerts" .Alerts }}
```

Kemudian untuk mencetak hanya peringatan penembakan Anda dapat menulis ini:

```
{{ template "print_alerts" .Alerts.Firing }}
```

Ini berfungsi karena keduanya `.Alerts` dan `.Alerts.Firing` merupakan daftar peringatan.

```
{{ define "print_alerts" }}
{{ range . }}
{{ template "print_labels" .SortedLabels }}
{{ end }}
{{ end }}
```

## Komentar
<a name="v10-go-comments"></a>

Anda dapat menambahkan komentar dengan `{{/*` dan`*/}}`:

```
{{/* This is a comment */}}
```

Untuk mencegah komentar menambahkan jeda baris gunakan:

```
{{- /* This is a comment with no leading or trailing line breaks */ -}}
```

## Lekukan
<a name="v10-go-indentation"></a>

Anda dapat menggunakan lekukan, baik tab maupun spasi, dan jeda baris, untuk membuat templat lebih mudah dibaca:

```
{{ range .Alerts }}
  {{ range .Labels.SortedPairs }}
    {{ .Name }} = {{ .Value }}
  {{ end }}
{{ end }}
```

Namun, lekukan dalam template juga akan ada dalam teks. Selanjutnya kita akan melihat cara menghapusnya.

## Hapus spasi dan jeda baris
<a name="v10-go-removespace"></a>

 text/template Digunakan `{{-` dan `-}}` untuk menghapus spasi depan dan trailing dan jeda garis.

Misalnya, saat menggunakan lekukan dan jeda baris untuk membuat templat lebih mudah dibaca:

```
{{ range .Alerts }}
  {{ range .Labels.SortedPairs }}
    {{ .Name }} = {{ .Value }}
  {{ end }}
{{ end }}
```

Lekukan dan jeda baris juga akan ada dalam teks:

```
    alertname = "Test"

    grafana_folder = "Test alerts"
```

Anda dapat menghapus lekukan dan jeda baris dari teks yang berubah `}}` menjadi `-}}` di awal setiap rentang:

```
{{ range .Alerts -}}
  {{ range .Labels.SortedPairs -}}
    {{ .Name }} = {{ .Value }}
  {{ end }}
{{ end }}
```

Indentasi dan jeda baris dalam template sekarang tidak ada dari teks:

```
alertname = "Test"
grafana_folder = "Test alerts"
```

# Buat templat notifikasi
<a name="v10-alerting-create-templates"></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)

Buat templat notifikasi yang dapat digunakan kembali untuk dikirim ke titik kontak Anda.

Anda dapat menambahkan satu atau beberapa templat ke templat notifikasi Anda.

Nama template notifikasi Anda harus unik. Anda tidak dapat memiliki dua templat dengan nama yang sama di templat notifikasi yang sama atau di templat notifikasi yang berbeda. Hindari mendefinisikan template dengan nama yang sama dengan template default, seperti:`__subject`,, `__text_values_list``__text_alert_list`, `default.title` dan`default.message`.

Di tab Titik kontak, Anda dapat melihat daftar templat notifikasi Anda.

## Membuat template notifikasi
<a name="v10-alerting-creating-templates"></a>

**Untuk membuat template notifikasi**

1. Pilih **Peringatan, Titik** **kontak**.

1. Pilih tab **Template Pemberitahuan**, lalu **\$1 Tambahkan templat notifikasi**.

1. Pilih nama untuk template notifikasi, seperti`email.subject`.

1. Tulis konten template di bidang konten.

   Contoh:

   ```
   {{ if .Alerts.Firing -}}
      {{ len .Alerts.Firing }} firing alerts
      {{ end }}
      {{ if .Alerts.Resolved -}}
      {{ len .Alerts.Resolved }} resolved alerts
      {{ end }}
   ```

1. Simpan perubahan Anda.

   `{{ define "email.subject" }}`(di `email.subject` mana nama template Anda) dan `{{ end }}` secara otomatis ditambahkan ke awal dan akhir konten.

**Untuk membuat template notifikasi yang berisi lebih dari satu template**

1. Pilih **Peringatan, Titik** **kontak**.

1. Pilih tab **Template Pemberitahuan**, lalu **\$1 Tambahkan templat notifikasi**.

1. Masukkan nama untuk template notifikasi keseluruhan. Misalnya, `email`.

1. Tulis setiap templat di bidang Konten, termasuk `{{ define "name-of-template" }}` dan `{{ end }}` di awal dan akhir setiap templat. Anda dapat menggunakan nama deskriptif untuk setiap templat di templat notifikasi, misalnya, `email.subject` atau`email.message`. Dalam hal ini, jangan gunakan kembali nama template notifikasi yang Anda masukkan di atas.

   Bagian selanjutnya menunjukkan contoh rinci untuk template yang mungkin Anda buat.

1. Klik Simpan.

## Templat pemberitahuan pratinjau
<a name="v10-alerting-preview-templates"></a>

Pratinjau bagaimana template notifikasi Anda akan terlihat sebelum menggunakannya di titik kontak Anda, membantu Anda memahami hasil template yang Anda buat serta memberi Anda kesempatan untuk memperbaiki kesalahan sebelum menyimpan template.

**catatan**  
Pratinjau notifikasi hanya tersedia untuk Grafana Alertmanager.

**Untuk melihat pratinjau templat notifikasi**

1. Pilih **Peringatan, Titik** **kontak**.

1. Pilih tab **Template Pemberitahuan**, lalu **\$1 Tambahkan templat notifikasi**, atau edit templat yang ada.

1. Tambahkan atau perbarui konten template Anda.

   Data default disediakan dan Anda dapat menambahkan atau mengedit data peringatan ke dalamnya serta instance peringatan. Anda dapat menambahkan data peringatan langsung di jendela data Payload itu sendiri, atau klik **Pilih instance peringatan** atau **Tambahkan peringatan khusus**.

1. [Opsional] Untuk menambahkan data peringatan dari instance peringatan yang ada:

   1. Pilih **Pilih instans peringatan**.

   1. Arahkan kursor ke instance peringatan untuk melihat informasi selengkapnya tentang setiap instance peringatan/

   1. Pilih **Konfirmasi** untuk menambahkan instance peringatan ke payload.

1. [Opsional] Untuk menambahkan data peringatan menggunakan editor data Peringatan, pilih **Tambahkan data khusus**:

   1. Tambahkan anotasi, label khusus, atau atur dasbor atau panel.

   1. Alihkan Penembakan atau diselesaikan, tergantung pada apakah Anda ingin menambahkan peringatan yang diaktifkan atau diselesaikan ke notifikasi Anda.

   1. Pilih **Tambahkan data peringatan**.

   1. Pilih **Refresh preview** untuk melihat seperti apa konten template Anda nantinya dan data payload yang sesuai.

   Jika ada kesalahan dalam template Anda, mereka ditampilkan di Pratinjau dan Anda dapat memperbaikinya sebelum menyimpan.

1. Simpan perubahan Anda.

## Membuat template untuk subjek pesan
<a name="v10-alerting-create-template-subject"></a>

Buat templat untuk subjek email yang berisi jumlah peringatan yang ditembakkan dan diselesaikan, seperti dalam contoh ini:

```
1 firing alerts, 0 resolved alerts
```

**Untuk membuat template untuk subjek email**

1. Buat template yang disebut `email.subject` dengan konten berikut:

   ```
   {{ define "email.subject" }}
   {{ len .Alerts.Firing }} firing alerts, {{ len .Alerts.Resolved }} resolved alerts
   {{ end }}
   ```

1. Gunakan template saat membuat integrasi titik kontak Anda dengan memasukkannya ke bidang **Subjek** dengan `template` kata kunci.

   ```
   {{ template "email.subject" . }}
   ```

## Membuat template untuk pesan email
<a name="v10-alerting-create-template-message"></a>

Buat templat untuk pesan email yang berisi ringkasan semua peringatan yang diaktifkan dan diselesaikan, seperti dalam contoh ini:

```
There are 2 firing alerts, and 1 resolved alerts

Firing alerts:

- alertname=Test 1 grafana_folder=GrafanaCloud has value(s) B=1
- alertname=Test 2 grafana_folder=GrafanaCloud has value(s) B=2

Resolved alerts:

- alertname=Test 3 grafana_folder=GrafanaCloud has value(s) B=0
```

**Untuk membuat template untuk pesan email**

1. Buat template notifikasi yang disebut `email` dengan dua templat dalam konten: `email.message_alert` dan`email.message`.

   `email.message_alert`Template digunakan untuk mencetak label dan nilai untuk setiap peringatan yang diaktifkan dan diselesaikan sementara `email.message` template berisi struktur email.

   ```
   {{- define "email.message_alert" -}}
   {{- range .Labels.SortedPairs }}{{ .Name }}={{ .Value }} {{ end }} has value(s)
   {{- range $k, $v := .Values }} {{ $k }}={{ $v }}{{ end }}
   {{- end -}}
   
   {{ define "email.message" }}
   There are {{ len .Alerts.Firing }} firing alerts, and {{ len .Alerts.Resolved }} resolved alerts
   
   {{ if .Alerts.Firing -}}
   Firing alerts:
   {{- range .Alerts.Firing }}
   - {{ template "email.message_alert" . }}
   {{- end }}
   {{- end }}
   
   {{ if .Alerts.Resolved -}}
   Resolved alerts:
   {{- range .Alerts.Resolved }}
   - {{ template "email.message_alert" . }}
   {{- end }}
   {{- end }}
   
   {{ end }}
   ```

1. Gunakan template saat membuat integrasi titik kontak Anda dengan memasukkannya ke dalam bidang **Text Body** dengan `template` kata kunci.

   ```
   {{ template "email.message" . }}
   ```

## Membuat template untuk judul pesan Slack
<a name="v10-alerting-create-template-slack-title"></a>

Buat template untuk judul pesan Slack yang berisi jumlah peringatan yang diaktifkan dan diselesaikan, seperti pada contoh berikut:

```
1 firing alerts, 0 resolved alerts
```

**Untuk membuat template untuk judul pesan Slack**

1. Buat template yang disebut `slack.title` dengan konten berikut:

   ```
   {{ define "slack.title" }}
   {{ len .Alerts.Firing }} firing alerts, {{ len .Alerts.Resolved }} resolved alerts
   {{ end }}
   ```

1. Jalankan template dari bidang judul dalam integrasi titik kontak Anda.

   ```
   {{ template "slack.title" . }}
   ```

## Membuat template untuk konten pesan Slack
<a name="v10-alerting-create-template-slack-message"></a>

Buat template untuk konten pesan Slack yang berisi deskripsi semua peringatan yang diaktifkan dan diselesaikan, termasuk label, anotasi, dan URL Dasbor.

**catatan**  
Template ini hanya untuk peringatan terkelola Grafana. Untuk menggunakan template untuk lansiran terkelola sumber data, hapus referensi ke DashboardURL dan SilenceUrl. [Untuk informasi selengkapnya tentang mengonfigurasi notifikasi Prometheus, lihat dokumentasi Prometheus tentang notifikasi.](https://prometheus.io/docs/alerting/latest/notifications/)

```
1 firing alerts:

[firing] Test1
Labels:
- alertname: Test1
- grafana_folder: GrafanaCloud
Annotations:
- description: This is a test alert
Go to dashboard: https://example.com/d/dlhdLqF4z?orgId=1

1 resolved alerts:

[firing] Test2
Labels:
- alertname: Test2
- grafana_folder: GrafanaCloud
Annotations:
- description: This is another test alert
Go to dashboard: https://example.com/d/dlhdLqF4z?orgId=1
```

**Untuk membuat template untuk konten pesan Slack**

1. Buat template yang disebut `slack` dengan dua template dalam konten: `slack.print_alert` dan`slack.message`.

   `slack.print_alert`Template digunakan untuk mencetak label, anotasi, dan dasbordURL sementara `slack.message` template berisi struktur notifikasi.

   ```
   {{ define "slack.print_alert" -}}
   [{{.Status}}] {{ .Labels.alertname }}
   Labels:
   {{ range .Labels.SortedPairs -}}
   - {{ .Name }}: {{ .Value }}
   {{ end -}}
   {{ if .Annotations -}}
   Annotations:
   {{ range .Annotations.SortedPairs -}}
   - {{ .Name }}: {{ .Value }}
   {{ end -}}
   {{ end -}}
   {{ if .DashboardURL -}}
     Go to dashboard: {{ .DashboardURL }}
   {{- end }}
   {{- end }}
   
   {{ define "slack.message" -}}
   {{ if .Alerts.Firing -}}
   {{ len .Alerts.Firing }} firing alerts:
   {{ range .Alerts.Firing }}
   {{ template "slack.print_alert" . }}
   {{ end -}}
   {{ end }}
   {{ if .Alerts.Resolved -}}
   {{ len .Alerts.Resolved }} resolved alerts:
   {{ range .Alerts.Resolved }}
   {{ template "slack.print_alert" .}}
   {{ end -}}
   {{ end }}
   {{- end }}
   ```

1. Jalankan template dari bidang isi teks dalam integrasi titik kontak Anda:

   ```
   {{ template "slack.message" . }}
   ```

## Template email dan Slack dengan template bersama
<a name="v10-alerting-create-shared-templates"></a>

Alih-alih membuat template notifikasi terpisah untuk setiap titik kontak, seperti email dan Slack, Anda dapat berbagi template yang sama.

Misalnya, jika Anda ingin mengirim email dengan subjek ini dan pesan Slack dengan judul ini`1 firing alerts, 0 resolved alerts`, Anda dapat membuat templat bersama.

**Untuk membuat template bersama**

1. Buat template yang disebut `common.subject_title` dengan konten berikut:

   ```
   {{ define "common.subject_title" }}
   {{ len .Alerts.Firing }} firing alerts, {{ len .Alerts.Resolved }} resolved alerts
   {{ end }}
   ```

1. Untuk email, jalankan template dari bidang subjek dalam integrasi titik kontak email Anda:

   ```
   {{ template "common.subject_title" . }}
   ```

1. Untuk Slack, jalankan template dari bidang judul di integrasi titik kontak Slack Anda:

   ```
   {{ template "common.subject_title" . }}
   ```

## Menggunakan template notifikasi
<a name="v10-alerting-use-notification-templates"></a>

Gunakan templat di titik kontak untuk menyesuaikan notifikasi Anda.

**Untuk menggunakan template saat membuat titik kontak**

1. Dari menu **Peringatan**, pilih tab **Titik kontak** untuk melihat daftar titik kontak yang ada.

1. Pilih **Baru**. Sebagai alternatif, Anda dapat mengedit titik kontak yang ada dengan memilih ikon **Edit**.

1. Masukkan templat yang ingin Anda gunakan di bidang, seperti **Pesan** atau **Subjek**. Untuk memasukkan templat, gunakan formulir`{{ template "template_name" . }}`, ganti *template\$1name* dengan nama templat yang ingin Anda gunakan.

1. Pilih **Simpan titik kontak**.

# Referensi templat
<a name="v10-alerting-template-reference"></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)

Bagian ini memberikan informasi referensi untuk membuat template Anda.

**Peringatan (tipe)**

Jenis peringatan berisi data berikut.


| Nama | Jenis | Deskripsi | Contoh | 
| --- | --- | --- | --- | 
|  Status  |  string  |  `firing` atau `resolved`.  | \$1\$1 .Status \$1\$1 | 
|  Label  |  KeyValue  |  Satu set label yang dilampirkan pada peringatan.  | \$1\$1 .Labels \$1\$1 | 
|  Anotasi  |  KeyValue  |  Satu set anotasi yang dilampirkan pada peringatan.  | \$1\$1 .Annotations \$1\$1 | 
| Nilai | KeyValue | Nilai dari semua ekspresi, termasuk Kondisi Klasik | \$1\$1 .Values \$1\$1 | 
|  StartsAt  |  waktu.waktu  |  Waktu peringatan mulai menembak.  | \$1\$1 .StartsAt \$1\$1 | 
|  EndsAt  |  waktu.waktu  |  Hanya atur jika waktu akhir peringatan diketahui. Jika tidak, atur ke periode batas waktu yang dapat dikonfigurasi sejak peringatan terakhir diterima.  | \$1\$1 .EndsAt \$1\$1 | 
|  GeneratorURL  |  string  |  Tautan balik ke Grafana atau Alertmanager eksternal.  | \$1\$1 .GeneratorURL \$1\$1 | 
|  SilenceUrl  |  string  |  Tautan untuk membungkam peringatan (dengan label untuk peringatan ini telah diisi sebelumnya). Hanya untuk peringatan terkelola Grafana.  | \$1\$1 .SilenceURL\$1\$1 | 
|  DashboardURL  |  string  |  Tautkan ke dasbor grafana, jika aturan peringatan milik salah satunya. Hanya untuk peringatan terkelola Grafana.  | \$1\$1 .DashboardURL \$1\$1 | 
|  PanelURL  |  string  |  Tautkan ke panel dasbor grafana, jika aturan peringatan milik salah satunya. Hanya untuk peringatan terkelola Grafana.  | \$1\$1 .PanelURL \$1\$1 | 
|  Sidik jari  |  string  |  Sidik jari yang dapat digunakan untuk mengidentifikasi peringatan.  | \$1\$1 .Fingerprint \$1\$1 | 
|  ValueString  |  string  |  String yang berisi label dan nilai setiap ekspresi yang dikurangi dalam peringatan.  | \$1\$1 .ValueString \$1\$1 | 

 **ExtendedData**

 ExtendedData Objek berisi properti berikut.


| Nama | Jenis | Deskripsi | Contoh | 
| --- | --- | --- | --- | 
|  Penerima  |  `string`  |  Nama titik kontak yang mengirimkan notifikasi.  |  `{{ .Receiver }}`  | 
|  Status  |  `string`  |  Statusnya adalah `firing` jika setidaknya satu peringatan ditembakkan, jika tidak`resolved`.  |  `{{ .Status }}`  | 
|  Pemberitahuan  |  `[]Alert`  |  Daftar semua peringatan yang ditembakkan dan diselesaikan dalam pemberitahuan ini.  |  `There are {{ len .Alerts }} alerts`  | 
|  Peringatan penembakan  |  `[]Alert`  |  Daftar semua peringatan penembakan dalam pemberitahuan ini.  |  `There are {{ len .Alerts.Firing }} firing alerts`  | 
|  Peringatan terselesaikan  |  `[]Alert`  |  Daftar semua peringatan yang diselesaikan dalam pemberitahuan ini.  |  `There are {{ len .Alerts.Resolved }} resolved alerts`  | 
|  GroupLabels  |  `KeyValue`  |  Label yang mengelompokkan peringatan ini termasuk pemberitahuannya.  |  `{{ .GroupLabels }}`  | 
|  CommonLabels  |  `KeyValue`  |  Label yang umum untuk semua peringatan dalam notifikasi ini.  |  `{{ .CommonLabels }}`  | 
|  CommonAnnotations  |  `KeyValue`  |  Anotasi umum untuk semua peringatan dalam pemberitahuan ini.  |  `{{ .CommonAnnotations }}`  | 
|  URL eksternal  |  `string`  |  Tautan ke ruang kerja Grafana atau Alertmanager yang mengirimkan pemberitahuan ini.  |  `{{ .ExternalURL }}`  | 

**KeyValue jenis**

`KeyValue`Tipe adalah satu set pasangan key/value string yang mewakili label dan anotasi.

Selain akses langsung dari data yang disimpan sebagai a`KeyValue`, ada juga metode untuk menyortir, menghapus, dan mengubah data.


| Nama | Pendapat | Pengembalian | Catatan | Contoh | 
| --- | --- | --- | --- | --- | 
|  SortedPairs  |    |  Daftar yang diurutkan dari pasangan string kunci dan nilai  |    | `{{ .Annotations.SortedPairs }}` | 
|  Menghapus  |  [] string  |  KeyValue  |  Mengembalikan salinan Key/Value peta tanpa kunci yang diberikan.  | `{{ .Annotations.Remove "summary" }}` | 
|  Nama  |    |  [] string  |  Daftar nama  | `{{ .Names }}` | 
|  Nilai  |    |  [] string  |  Daftar nilai  | `{{ .Values }}` | 

**Waktu**

Waktu dari [https://pkg.go.dev/time#Time](https://pkg.go.dev/time#Time)paket Go. Anda dapat mencetak waktu dalam sejumlah format berbeda. Misalnya, untuk mencetak waktu peringatan diaktifkan dalam format`Monday, 1st January 2022 at 10:00AM`, Anda menulis template berikut:

```
{{ .StartsAt.Format "Monday, 2 January 2006 at 3:04PM" }}
```

Anda dapat menemukan referensi untuk format waktu Go [di sini](https://pkg.go.dev/time#pkg-constants).

# Kelola titik kontak
<a name="v10-alerting-manage-contactpoints"></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)

Tampilan daftar **titik Kontak** mencantumkan semua titik kontak dan templat notifikasi yang ada.

Pada tab **Titik kontak**, Anda dapat:
+ Cari nama dan jenis titik kontak dan integrasi.
+ Lihat semua titik kontak dan integrasi yang ada.
+ Lihat berapa banyak kebijakan notifikasi yang digunakan untuk setiap titik kontak, dan arahkan langsung ke kebijakan notifikasi yang ditautkan.
+ Lihat status pengiriman notifikasi.
+ Ekspor titik kontak individu atau semua titik kontak dalam format JSON, YAMAL, atau Terraform.
+ Hapus titik kontak yang tidak digunakan oleh kebijakan notifikasi.

Pada tab **Template notifikasi**, Anda dapat:
+ Lihat, edit, salin, atau hapus templat notifikasi yang ada.

# Membungkam pemberitahuan peringatan
<a name="v10-alerting-silences"></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 menekan pemberitahuan peringatan dengan *diam*. Keheningan hanya menghentikan pemberitahuan agar tidak dibuat: Keheningan tidak mencegah aturan peringatan dievaluasi, dan mereka tidak menghentikan peringatan instance agar tidak ditampilkan di antarmuka pengguna. Saat Anda membungkam peringatan, Anda menentukan jendela waktu untuk ditekan.

**catatan**  
Untuk menekan pemberitahuan peringatan pada interval waktu reguler, misalnya, selama periode pemeliharaan rutin, gunakan [Bisukan waktu](v10-alerting-manage-muting.md) bukan diam.

**Untuk menambahkan keheningan**

1. **Dari konsol Grafana Anda, di menu Grafana, pilih Peringatan.**

1. Pilih **Silences.**

1. Pilih Alertmanager dari dropdown **Alertmanager**.

1. Pilih **Buat Keheningan**.

1. Pilih tanggal mulai dan berakhir di **Silence start and end** untuk menunjukkan kapan keheningan akan berlaku dan kapan harus berakhir.

1. Sebagai alternatif untuk mengatur waktu akhir, di **Durasi**, tentukan berapa lama keheningan diberlakukan. Ini secara otomatis memperbarui waktu akhir di bidang **Mulai dan Akhir Diam**.

1. Di bidang **Label** dan **Nilai**, masukkan satu atau beberapa *Label Pencocokan*. Matcher menentukan aturan mana yang berlaku untuk keheningan. Setiap peringatan yang cocok (dalam status aktif), akan ditampilkan di bidang Instance **lansiran yang terpengaruh**.

1. Secara opsional, tambahkan **Komentar** yang menjelaskan keheningan.

1. Pilih **Kirim**.

**Untuk mengedit keheningan**

1. **Dari konsol Grafana Anda, di menu Grafana, pilih Peringatan.**

1. Pilih **Silences** untuk melihat daftar keheningan yang ada.

1. Temukan keheningan yang ingin Anda edit, lalu pilih **Edit** (ikon pena).

1. Buat perubahan yang diinginkan, lalu pilih **Kirim** untuk menyimpan perubahan Anda.

Anda dapat mengedit keheningan yang ada dengan memilih ikon **Edit** (pena).

**Untuk membuat tautan URL ke formulir diam**

Saat menautkan ke formulir diam, berikan label pencocokan default dan komentar melalui `matcher` dan parameter `comment` kueri. `matcher`Parameter harus dalam format berikut di `[label][operator][value]` mana `operator` parameter dapat berupa salah satu dari yang berikut: `=` (sama, bukan regex), (tidak sama, bukan regex), `!=` (sama, regex), `=~` (tidak sama, regex). `!~` URL dapat berisi banyak parameter kueri dengan kunci`matcher`. Misalnya, untuk menautkan ke formulir diam dengan label `severity=critical` & `cluster!~europe-.*` komentar yang cocok`Silence critical EU alerts`, buat URL`https://mygrafana/alerting/silence/new?matcher=severity%3Dcritical&matcher=cluster!~europe-*&comment=Silence%20critical%20EU%20alert`.

Untuk menautkan ke halaman diam baru untuk Alertmanager eksternal, tambahkan parameter kueri `alertmanager`

**Untuk menghilangkan keheningan**

1. **Dari konsol Grafana Anda, di menu Grafana, pilih Peringatan.**

1. Pilih **Silences** untuk melihat daftar keheningan yang ada.

1. Pilih keheningan yang ingin Anda akhiri, dan pilih **Unsilence**. Ini mengakhiri penindasan peringatan.
**catatan**  
Unsilencing mengakhiri penindasan peringatan, seolah-olah waktu akhir ditetapkan untuk waktu saat ini. Keheningan yang telah berakhir (secara otomatis atau manual) dipertahankan dan terdaftar selama lima hari. Anda tidak dapat menghapus keheningan dari daftar secara manual.

# Lihat dan filter aturan peringatan
<a name="v10-alerting-manage-rules-viewfilter"></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)

Halaman **Peringatan mencantumkan** aturan peringatan. Secara default, aturan dikelompokkan berdasarkan jenis sumber data. Bagian **Grafana mencantumkan** aturan yang dikelola oleh Grafana. Aturan peringatan untuk sumber data yang kompatibel dengan Prometheus juga tercantum di sini. Anda dapat melihat aturan peringatan untuk sumber data yang kompatibel dengan Prometheus tetapi Anda tidak dapat mengeditnya.

Bagian Mimir/Cortex/Loki aturan mencantumkan semua aturan untuk sumber data Mimir, Cortex, atau Loki. Aturan peringatan cloud juga tercantum di bagian ini.

Saat mengelola volume peringatan yang besar, Anda dapat menggunakan kemampuan pencarian aturan peringatan yang diperluas untuk memfilter folder, grup evaluasi, dan aturan. Selain itu, Anda dapat memfilter aturan peringatan berdasarkan propertinya seperti label, status, jenis, dan kesehatan.

## Lihat aturan peringatan
<a name="v10-alerting-manage-rules-view"></a>

Menggunakan peringatan Grafana, Anda dapat melihat semua peringatan Anda dalam satu halaman.

**Untuk melihat detail peringatan**

1. **Dari konsol Grafana Anda, di menu Grafana, pilih **Peringatan, Aturan Peringatan**.** Secara default, tampilan daftar ditampilkan.

1. Di **View as**, Anda dapat beralih antara tampilan Dikelompokkan, Daftar, dan Status dengan memilih opsi yang Anda inginkan.

1. Perluas baris aturan untuk melihat label aturan, anotasi, sumber data, kueri aturan, dan daftar instance peringatan yang dihasilkan dari aturan.

Dari halaman ini, Anda juga dapat membuat salinan aturan peringatan untuk membantu Anda menggunakan kembali aturan yang ada.

## Aturan peringatan ekspor
<a name="v10-alerting-manage-rules-export"></a>

Anda dapat mengekspor aturan ke YAMAL atau JSON di ruang kerja Grafana.
+ Pilih ikon **grup aturan Ekspor** di samping setiap grup aturan peringatan untuk diekspor ke YAMG, JSON, atau Terraform.
+ Pilih **Ekspor aturan** untuk mengekspor semua aturan peringatan terkelola Grafana ke YAMG, JSON, atau Terraform.
+ Pilih **Lainnya**, **Ubah ekspor** di samping setiap aturan peringatan individu dalam grup untuk mengedit aturan peringatan yang disediakan dan mengekspor versi yang dimodifikasi.

## Lihat definisi kueri untuk peringatan yang disediakan
<a name="v10-alerting-manage-rules-querydef"></a>

Lihat definisi kueri hanya-baca untuk peringatan yang disediakan. Periksa dengan cepat apakah kueri aturan peringatan Anda benar, tanpa menyelam ke repositori “as-code” Anda untuk definisi aturan.

**Tampilan yang dikelompokkan**

Tampilan yang dikelompokkan menunjukkan aturan peringatan Grafana yang dikelompokkan berdasarkan folder dan aturan peringatan Loki atau Prometheus yang dikelompokkan berdasarkan \$1. `namespace` `group` Ini adalah tampilan daftar aturan default, yang ditujukan untuk mengelola aturan. Anda dapat memperluas setiap grup untuk melihat daftar aturan dalam grup ini. Perluas aturan lebih lanjut untuk melihat detailnya. Anda juga dapat memperluas tombol tindakan dan peringatan yang dihasilkan dari aturan untuk melihat detailnya.

**Tampilan negara**

Tampilan status menunjukkan aturan peringatan yang dikelompokkan berdasarkan negara bagian. Gunakan tampilan ini untuk mendapatkan gambaran umum tentang aturan mana yang berada dalam keadaan apa. Setiap aturan dapat diperluas untuk melihat detailnya. Tombol tindakan dan peringatan apa pun yang dihasilkan oleh aturan ini, dan setiap peringatan dapat diperluas lebih lanjut untuk melihat detailnya.

## Memfilter aturan peringatan
<a name="v10-alerting-manage-rules-filter"></a>

Anda dapat memfilter aturan peringatan yang muncul di halaman **Peringatan dengan** beberapa cara.

**Untuk memfilter aturan peringatan**

1. Dari **Pilih sumber data**, pilih sumber data.. Anda dapat melihat aturan peringatan yang menanyakan sumber data yang dipilih.

1. Di **Cari berdasarkan label**, masukkan kriteria pencarian menggunakan pemilih label. Misalnya, `environment=production;region=~US|EU,severity!=warning`.

1. Dari **Filter peringatan menurut negara**, pilih status peringatan yang ingin Anda lihat. Anda dapat melihat aturan peringatan yang cocok dengan status itu. Aturan yang cocok dengan negara bagian lain disembunyikan.

# Bisukan waktu
<a name="v10-alerting-manage-muting"></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)

Waktu bisu adalah interval waktu berulang ketika tidak ada pemberitahuan baru untuk kebijakan yang dibuat atau dikirim. Gunakan mereka untuk mencegah peringatan menembakkan periode tertentu dan berulang, misalnya, periode pemeliharaan rutin.

Mirip dengan diam, pengaturan waktu bisu tidak mencegah aturan peringatan dievaluasi, juga tidak menghentikan instance peringatan ditampilkan di antarmuka pengguna. Mereka hanya mencegah pemberitahuan dibuat.

Anda dapat mengonfigurasi pengaturan waktu bisu terkelola Grafana serta pengaturan waktu bisu untuk sumber data Alertmanager eksternal.

## Bisukan waktu vs Keheningan
<a name="v10-alerting-manage-muting-compare"></a>

Tabel berikut menyoroti perbedaan antara timing bisu dan keheningan.


| Bisukan waktu | Pembisuan | 
| --- | --- | 
| Menggunakan definisi interval waktu yang dapat terulang kembali. | Memiliki waktu mulai dan berakhir yang tetap. | 
| Dibuat dan kemudian ditambahkan ke kebijakan pemberitahuan. | Menggunakan label untuk mencocokkan dengan peringatan untuk menentukan apakah akan diam atau tidak. | 

## Menambahkan waktu bisu
<a name="v10-alerting-manage-muting-add"></a>

Anda dapat membuat pengaturan waktu bisu di ruang kerja Grafana Anda.

**Untuk menambahkan waktu bisu**

1. **Dari konsol Grafana Anda, di menu Grafana, pilih Peringatan.**

1. Pilih **Kebijakan pemberitahuan**, lalu pilih tab **Pengaturan Waktu Bisu**.

1. Dari dropdown **Alertmanager**, pilih Alertmanager yang ingin Anda edit.

1. Pilih tombol **\$1 Tambahkan waktu bisu**.

1. Isi formulir untuk membuat [interval waktu](#v10-alerting-manage-muting-interval) yang sesuai dengan waktu bisu Anda.

1. Simpan waktu bisu Anda.

## Menambahkan waktu bisu ke kebijakan notifikasi
<a name="v10-alerting-manage-muting-add-notif"></a>

Setelah Anda memiliki waktu bisu, Anda menggunakannya dengan menambahkannya ke kebijakan notifikasi yang ingin Anda bisukan secara berkala.

**Untuk menambahkan waktu bisu ke kebijakan notifikasi**

1. **Dari konsol Grafana Anda, di menu Grafana, pilih Peringatan.**

1. Pilih **Kebijakan pemberitahuan**, lalu pilih tab **Kebijakan Pemberitahuan**.

1. **Pilih kebijakan notifikasi yang ingin Anda tambahkan waktu bisu, dan pilih...** , **Sunting**.

1. Dari menu tarik-turun **Pengaturan waktu bisu**, pilih pengaturan waktu bisu yang ingin ditambahkan ke kebijakan.

1. Simpan perubahan Anda.

## Interval waktu
<a name="v10-alerting-manage-muting-interval"></a>

Interval waktu adalah durasi tertentu di mana peringatan ditekan. Durasi biasanya terdiri dari rentang waktu tertentu dan hari-hari dalam seminggu, bulan, atau tahun. 

Opsi interval waktu Support adalah:
+ **Rentang waktu** — Waktu termasuk waktu mulai dan eksklusif waktu akhir (di UTC, jika tidak ada lokasi yang dipilih, jika tidak ada waktu setempat.
+ **Lokasi** - Menetapkan lokasi untuk waktu—rentang waktu ditampilkan dalam waktu lokal untuk lokasi tersebut.
+ **Hari dalam seminggu** — Hari atau rentang hari dalam seminggu. Misalnya, `monday:thursday`.
+ **Hari dalam sebulan** — Tanggal dalam sebulan. Nilai dapat berkisar dari `1` -`31`. Nilai negatif menentukan hari dalam sebulan dalam urutan terbalik, jadi `-1` mewakili hari terakhir bulan itu.
+ **Bulan** — Bulan dalam setahun baik numerik nama bulan kalender lengkap. Misalnya, `1, may:august`.
+ **Tahun** — Tahun atau tahun untuk interval. Misalnya, `2023:2024`.

Masing-masing elemen ini dapat berupa daftar, dan setidaknya satu item dalam elemen harus dipenuhi untuk menjadi kecocokan. Bidang juga mendukung rentang, menggunakan`:`. Misalnya, `monday:thursday`.

Jika bidang dibiarkan kosong, setiap saat akan cocok dengan bidang. Untuk sekejap untuk mencocokkan interval waktu penuh, semua bidang harus cocok. Waktu bisu dapat berisi beberapa interval waktu.

Jika Anda ingin menentukan durasi yang tepat, tentukan semua opsi yang diperlukan untuk durasi tersebut. Misalnya, jika Anda ingin membuat interval waktu untuk Senin pertama setiap bulan, untuk bulan Maret, Juni, September, dan Desember, antara jam 12:00 dan 24:00 UTC, spesifikasi interval waktu Anda dapat berupa:
+ Rentang waktu:
  + Waktu mulai: `12:00`
  + Waktu akhir: `24:00`
+ Hari dalam seminggu: `monday`
+ Bulan: `3, 6, 9, 12`
+ Hari dalam sebulan: `1:7`

# Lihat keadaan dan kesehatan aturan peringatan
<a name="v10-alerting-manage-rulestate"></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)

Keadaan dan kesehatan aturan peringatan memberi Anda beberapa indikator status utama tentang peringatan Anda.

Ada tiga komponen:
+ [Status aturan peringatan](#v10-alerting-manage-rulestate-state)
+ [Status contoh peringatan](#v10-alerting-manage-rulestate-instance)
+ [Peringatan aturan kesehatan](#v10-alerting-manage-rulestate-health)

Meskipun terkait, setiap komponen menyampaikan informasi yang sedikit berbeda.

**Untuk melihat keadaan dan kesehatan aturan peringatan Anda**

1. **Dari konsol Grafana Anda, di menu Grafana, pilih Peringatan.**

1. Pilih **Aturan peringatan** untuk melihat daftar peringatan yang ada.

1. Pilih aturan peringatan untuk melihat keadaan dan kesehatannya.

## Status aturan peringatan
<a name="v10-alerting-manage-rulestate-state"></a>

Aturan peringatan dapat berada di salah satu negara bagian berikut:


| Status | Deskripsi | 
| --- | --- | 
| Normal | Tak satu pun dari deret waktu yang dikembalikan oleh mesin evaluasi dalam firing keadaan pending atau. | 
| Tertunda | Setidaknya satu seri waktu yang dikembalikan oleh mesin evaluasi adalahpending. | 
| Menembak | Setidaknya satu seri waktu yang dikembalikan oleh mesin evaluasi adalahfiring. | 

**catatan**  
Peringatan beralih pertama ke `pending` dan kemudian`firing`, sehingga dibutuhkan setidaknya dua siklus evaluasi sebelum peringatan diaktifkan.

## Status contoh peringatan
<a name="v10-alerting-manage-rulestate-instance"></a>

Instance peringatan dapat berada di salah satu status berikut:


| Status | Deskripsi | 
| --- | --- | 
| Normal | Keadaan peringatan yang bukan pending ataufiring. Semuanya bekerja seperti yang diharapkan. | 
| Tertunda | Status peringatan yang telah aktif kurang dari durasi ambang batas yang dikonfigurasi. | 
| Peringatan | Status peringatan yang telah aktif lebih lama dari durasi ambang batas yang dikonfigurasi. | 
| Tidak ada data | Tidak ada data yang diterima untuk jendela waktu yang dikonfigurasi. | 
| Peringatan | Terjadi kesalahan saat mencoba mengevaluasi aturan peringatan. | 

## Pertahankan status terakhir
<a name="v10-alerting-manage-rulestate-keepstate"></a>

Aturan peringatan dapat dikonfigurasi untuk mempertahankan status terakhir saat `Error` status `NoData` atau ditemui. Ini akan mencegah peringatan dari penembakan, dan dari penyelesaian dan penembakan kembali. Sama seperti evaluasi normal, aturan peringatan akan bertransisi dari `pending` ke `firing` setelah periode tertunda telah berlalu.

## Peringatan aturan kesehatan
<a name="v10-alerting-manage-rulestate-health"></a>

Aturan peringatan dapat memiliki salah satu status kesehatan berikut.


| Status | Deskripsi | 
| --- | --- | 
| Ok | Tidak ada kesalahan saat mengevaluasi aturan peringatan. | 
| Kesalahan | Terjadi kesalahan saat mengevaluasi aturan peringatan. | 
| NoData | Tidak adanya data dalam setidaknya satu deret waktu yang dikembalikan selama evaluasi aturan. | 
| \$1status\$1, KeepLast | Aturan akan menerima status lain, tetapi dikonfigurasi untuk mempertahankan status terakhir dari aturan peringatan. | 

## Peringatan khusus untuk NoData dan Kesalahan
<a name="v10-alerting-manage-rulestate-special"></a>

Saat evaluasi aturan peringatan menghasilkan status `NoData` atau`Error`, peringatan Grafana akan menghasilkan instance peringatan yang memiliki label tambahan berikut.


| Label | Deskripsi | 
| --- | --- | 
| nama peringatan | Entah DatasourceNoData atauDatasourceError, tergantung negara. | 
| datasource\$1uid | UID dari sumber data yang menyebabkan negara. | 

**catatan**  
Anda perlu mengatur tidak ada data atau penanganan kesalahan ke `NoData` atau `Error` dalam aturan peringatan, seperti yang dijelaskan dalam [Konfigurasikan aturan peringatan terkelola Grafana](v10-alerting-configure-grafanamanaged.md) topik, untuk menghasilkan label tambahan.

Anda dapat menangani peringatan ini dengan cara yang sama seperti peringatan biasa, termasuk menambahkan keheningan, perutean ke titik kontak, dan sebagainya.

# Lihat dan filter menurut grup peringatan
<a name="v10-alerting-manage-viewfiltergroups"></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)

Grup peringatan menampilkan peringatan yang dikelompokkan dari instance Alertmanager. Secara default, aturan peringatan dikelompokkan berdasarkan kunci label untuk kebijakan default dalam kebijakan notifikasi. Mengelompokkan aturan peringatan umum ke dalam satu grup peringatan mencegah aturan peringatan duplikat dipecat.

Anda dapat melihat grup peringatan dan juga memfilter aturan peringatan yang sesuai dengan kriteria tertentu.

**Untuk melihat grup peringatan**

1. **Dari konsol Grafana Anda, di menu Grafana, pilih Peringatan.**

1. Pilih **Grup** untuk melihat grup yang ada.

1. Dari tarik-turun **Alertmanager**, pilih Alertmanager eksternal sebagai sumber data Anda.

1. Dari **grup Kustom menurut** tarik-turun, pilih kombinasi label untuk melihat pengelompokan selain default. Ini berguna untuk men-debug dan memverifikasi pengelompokan kebijakan pemberitahuan Anda.

Jika peringatan tidak berisi label yang ditentukan baik dalam pengelompokan kebijakan root atau pengelompokan kustom, maka peringatan akan ditambahkan ke grup catch all dengan header. `No grouping`

Anda dapat memfilter peringatan berdasarkan label atau status peringatan.

**Untuk memfilter berdasarkan label**
+ Di **Penelusuran**, masukkan label yang ada untuk melihat peringatan yang cocok dengan label.

  Misalnya, `environment=production,region=~US|EU,severity!=warning`.

**Untuk memfilter menurut negara**
+ Di **Negara Bagian**, pilih dari Status Aktif, Ditekan, atau Tidak Diproses untuk melihat peringatan yang cocok dengan status yang Anda pilih. Semua peringatan lainnya disembunyikan.

# Lihat kesalahan pemberitahuan
<a name="v10-alerting-manage-viewnotificationerrors"></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)

Lihat kesalahan pemberitahuan dan pahami mengapa kesalahan tersebut gagal dikirim atau tidak diterima.

**catatan**  
Fitur ini hanya didukung untuk Grafana Alertmanager.

**Untuk melihat kesalahan pemberitahuan**

1. Dari menu sebelah kiri, pilih **Alerting** lalu **Contact points**.

   Jika ada titik kontak yang gagal, pesan di sudut kanan ruang kerja memberi tahu Anda bahwa ada kesalahan, dan berapa banyak.

1. Pilih titik kontak untuk melihat rincian kesalahan untuk titik kontak tersebut.

   Detail kesalahan ditampilkan jika Anda mengarahkan kursor ke ikon Kesalahan.

   Jika titik kontak memiliki lebih dari satu integrasi, Anda melihat semua kesalahan untuk setiap integrasi yang terdaftar.

1. Di kolom Health, periksa status notifikasi.

   Ini bisa berupa OK, Tidak ada upaya, atau Kesalahan.