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

# Membuat dan mengelola aturan peringatan Grafana
<a name="alert-rules"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 12.x, lihat. [Bekerja di Grafana versi 12](using-grafana-v12.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

Aturan peringatan adalah seperangkat kriteria evaluasi yang menentukan apakah peringatan dimulai. Aturan terdiri dari satu atau lebih pertanyaan dan ekspresi, kondisi, frekuensi evaluasi, dan opsional durasi di mana kondisi terpenuhi.

Sementara kueri dan ekspresi memilih kumpulan data untuk dievaluasi, kondisi menetapkan ambang batas yang harus dipenuhi peringatan, atau melebihi untuk membuat peringatan. Interval menentukan seberapa sering aturan peringatan dievaluasi. Durasi, ketika dikonfigurasi, menunjukkan berapa lama suatu kondisi harus dipenuhi. Aturan juga dapat menentukan perilaku peringatan tanpa adanya data.

Bagian berikut menjelaskan pembuatan dan pengelolaan berbagai jenis aturan peringatan Grafana.

**Topics**
+ [Membuat aturan peringatan terkelola Cortex atau Loki](#create-alert-rule)
+ [Membuat aturan perekaman terkelola Cortex atau Loki](#create-alert-recording-rule)
+ [Membuat aturan peringatan terkelola Grafana](#create-grafana-alert-rule)
+ [Anotasi dan label untuk aturan peringatan](#alert-rule-labels)
+ [Mengelola aturan peringatan](#manage-alert-rules)
+ [Grup aturan dan ruang nama Cortex atau Loki](#alert-rule-groups)

## Membuat aturan peringatan terkelola Cortex atau Loki
<a name="create-alert-rule"></a>

Menggunakan Grafana, Anda dapat membuat aturan peringatan untuk instance Cortex atau Loki eksternal.

**catatan**  
Cortex adalah database deret waktu yang digunakan oleh Amazon Managed Service untuk sumber data Prometheus dan Prometheus.

**Prasyarat**
+ Verifikasi bahwa Anda memiliki izin menulis ke sumber data Prometheus. Jika tidak, Anda tidak dapat membuat atau memperbarui aturan peringatan terkelola Cortex.
+ Untuk sumber data Cortex 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.
  + **Cortex** — Gunakan `/api/prom` awalan warisan, bukan. `/prometheus` Sumber data Prometheus mendukung Cortex 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 menambahkan aturan peringatan terkelola Cortex atau Loki**

1. Dari konsol Grafana Anda, di menu Grafana, pilih ikon **Peringatan (bel) untuk membuka halaman Peringatan yang mencantumkan** **peringatan** yang ada.

1. Pilih **Aturan peringatan baru**.

1. Pada **Langkah 1**, tambahkan nama aturan, jenis dan lokasi penyimpanan, sebagai berikut:
   + Dalam **nama Aturan**, tambahkan nama deskriptif. Nama ini ditampilkan dalam daftar aturan peringatan. Ini juga merupakan `alertname` label untuk setiap instance peringatan yang dibuat dari aturan ini.
   + Dari tarik-turun **Jenis aturan**, pilih lansiran **Cortex/Loki terkelola**.
   + Dari menu tarik-turun **Pilih sumber data**, pilih Prometheus, atau sumber data Loki.
   + Dari dropdown **Namespace**, pilih namespace aturan yang ada. Jika tidak, pilih **Tambahkan baru** dan masukkan nama untuk membuatnya. Ruang nama dapat berisi satu atau lebih grup aturan dan hanya memiliki tujuan organisasi. Untuk informasi selengkapnya, lihat [Grup aturan dan ruang nama Cortex atau Loki](#alert-rule-groups).
   + Dari dropdown **Grup**, pilih grup yang ada dalam namespace yang dipilih. Jika tidak, pilih **Tambahkan baru** dan masukkan nama untuk membuatnya. Aturan yang baru dibuat ditambahkan ke akhir grup. Aturan dalam grup dijalankan secara berurutan pada interval reguler, dengan waktu evaluasi yang sama.

1. Pada **Langkah 2**, tambahkan kueri untuk mengevaluasi.

   Nilai dapat berupa ekspresi promQL atau logQL. Aturan memulai peringatan jika hasil evaluasi memiliki setidaknya satu seri dengan nilai yang lebih besar dari 0. Peringatan dibuat untuk setiap seri.

1. Pada **Langkah 3**, tambahkan kondisi.

   Dalam Untuk kotak teks kondisi, tentukan durasi kondisinya harus benar sebelum peringatan dimulai. Jika Anda menentukan`5m`, kondisi harus benar selama lima menit sebelum peringatan dimulai.
**catatan**  
Setelah suatu kondisi terpenuhi, peringatan masuk ke `Pending` negara. Jika kondisi tetap aktif selama durasi yang ditentukan, peringatan akan beralih ke `Firing` status. Jika tidak lagi terpenuhi, ia kembali ke `Normal` negara.

1. Pada **Langkah 4**, tambahkan metadata tambahan yang terkait dengan aturan.
   + Tambahkan deskripsi dan ringkasan untuk menyesuaikan pesan peringatan. Gunakan pedoman di[Anotasi dan label untuk aturan peringatan](#alert-rule-labels).
   + Tambahkan URL Runbook, panel, dasbor, dan ID peringatan.
   + Tambahkan label khusus.

1. Pilih **Pratinjau lansiran** untuk mengevaluasi aturan dan melihat peringatan apa yang akan dihasilkannya. Ini menampilkan daftar peringatan dengan status dan nilai masing-masing.

1. Pilih **Simpan** untuk menyimpan aturan atau **Simpan dan keluar** untuk menyimpan aturan dan kembali ke halaman **Peringatan**.

## Membuat aturan perekaman terkelola Cortex atau Loki
<a name="create-alert-recording-rule"></a>

Anda dapat membuat dan mengelola aturan perekaman untuk instance Cortex 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.

**Prasyarat**

Untuk sumber data Cortex 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.
+ **Korteks** — Saat mengonfigurasi sumber data Grafana Prometheus untuk menunjuk ke Cortex, gunakan awalan lama, bukan. `/api/prom` `/prometheus` Sumber data Prometheus mendukung Cortex 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 menambahkan aturan perekaman terkelola Cortex atau Loki**

1. Dari konsol Grafana Anda, di menu Grafana, pilih ikon **Peringatan (bel) untuk membuka halaman Peringatan yang mencantumkan** **peringatan** yang ada.

1. Pilih **Aturan peringatan baru**.

1. Pada **Langkah 1**, tambahkan nama aturan, jenis dan lokasi penyimpanan, sebagai berikut.
   + Dalam **nama Aturan**, tambahkan nama deskriptif. Nama ini ditampilkan dalam daftar aturan peringatan. Ini juga merupakan `alertname` label untuk setiap instance peringatan yang dibuat dari aturan ini.
   + Dari tarik-turun **Jenis aturan**, pilih lansiran **Cortex/Loki terkelola**.
   + Dari menu tarik-turun **Pilih sumber data**, pilih Prometheus, atau sumber data Loki.
   + Dari dropdown **Namespace**, pilih namespace aturan yang ada. Jika tidak, pilih **Tambahkan baru** dan masukkan nama untuk membuatnya. Ruang nama dapat berisi satu atau lebih grup aturan dan hanya memiliki tujuan organisasi. Untuk informasi selengkapnya, lihat [Grup aturan dan ruang nama Cortex atau Loki](#alert-rule-groups).
   + Dari dropdown **Grup**, pilih grup yang ada dalam namespace yang dipilih. Jika tidak, pilih **Tambahkan baru** dan masukkan nama untuk membuatnya. Aturan yang baru dibuat ditambahkan ke akhir grup. Aturan dalam grup dijalankan secara berurutan pada interval reguler, dengan waktu evaluasi yang sama.

1. Pada **Langkah 2**, tambahkan kueri untuk mengevaluasi.

   Nilai dapat berupa ekspresi promQL atau logQL. Aturan memulai peringatan jika hasil evaluasi memiliki setidaknya satu seri dengan nilai yang lebih besar dari 0. Peringatan dibuat untuk setiap seri.

1. Pada **Langkah 3**, tambahkan metadata tambahan yang terkait dengan aturan.
   + Tambahkan deskripsi dan ringkasan untuk menyesuaikan pesan peringatan. Gunakan pedoman di[Anotasi dan label untuk aturan peringatan](#alert-rule-labels).
   + Tambahkan URL Runbook, panel, dasbor, dan ID peringatan.
   + Tambahkan label khusus.

1. Pilih **Simpan** untuk menyimpan aturan atau **Simpan dan keluar** untuk menyimpan aturan dan kembali ke halaman **Peringatan**.

## Membuat aturan peringatan terkelola Grafana
<a name="create-grafana-alert-rule"></a>

Grafana memungkinkan Anda membuat aturan peringatan yang menanyakan satu atau lebih sumber data, mengurangi atau mengubah hasil dan membandingkannya satu sama lain atau untuk memperbaiki ambang batas. Ketika ini diproses, Grafana mengirimkan pemberitahuan ke titik kontak.

**catatan**  
Membuat aturan peringatan terkelola Grafana saat menggunakan peringatan Grafana menyebabkan beberapa notifikasi dikirim saat aturan dicocokkan. Beberapa penyedia titik kontak mungkin memiliki opsi yang dapat dikonfigurasi untuk menghapus duplikat notifikasi.

**Untuk menambahkan aturan terkelola Grafana**

1. Dari konsol Grafana Anda, di menu Grafana, pilih ikon **Peringatan (bel) untuk membuka halaman Peringatan yang mencantumkan** **peringatan** yang ada.

1. Pilih **Aturan peringatan baru**.

1. Pada **Langkah 1**, tambahkan nama aturan, jenis dan lokasi penyimpanan, sebagai berikut:
   + Dalam **nama Aturan**, tambahkan nama deskriptif. Nama ini ditampilkan dalam daftar aturan peringatan. Ini juga merupakan `alertname` label untuk setiap instance peringatan yang dibuat dari aturan ini.
   + **Dari tarik-turun **Jenis aturan**, pilih Grafana managed alert.**
   + Dari dropdown **Folder**, pilih folder tempat Anda ingin menyimpan aturan. Jika Anda tidak memilih folder, aturan disimpan dalam `General` folder. Untuk membuat folder, pilih dropdown dan masukkan nama folder baru.

1. Pada **Langkah 2**, tambahkan kueri dan ekspresi untuk mengevaluasi.
   + Simpan nama default atau arahkan kursor ke atas dan pilih ikon edit untuk mengubah nama.
   + Untuk kueri, pilih sumber data dari dropdown.
   + Tambahkan satu atau beberapa [kueri](panel-queries.md) atau ekspresi (untuk detail tentang ekspresi, lihat [Ekspresi](https://grafana.com/docs/grafana/next/panels/query-a-data-source/) dalam dokumentasi *Grafana*).
   + Untuk setiap ekspresi, pilih salah satu **kondisi Klasik** untuk membuat aturan peringatan tunggal, atau pilih dari opsi **Matematika**, **Kurangi**, **Sampel ulang** untuk menghasilkan peringatan terpisah untuk setiap seri. Untuk detail tentang opsi ini, lihat[Aturan tunggal dan multidimensi](#single-multi-rule).
   + Pilih **Jalankan kueri** untuk memverifikasi bahwa kueri berhasil.

1. Pada **Langkah 3**, tambahkan kondisi.
   + Dari **kondisi** tarik-turun, pilih kueri atau ekspresi untuk memulai aturan peringatan.
   + Untuk **Evaluasi setiap**, tentukan frekuensi evaluasi. Harus kelipatan 10 detik. Misalnya,`1m`,`30s`.
   + **Untuk Evaluasi** untuk, tentukan durasi kondisinya harus benar sebelum peringatan dimulai.
**catatan**  
Setelah suatu kondisi dilanggar, peringatan masuk ke `Pending` status. Jika kondisi tetap dilanggar selama durasi yang ditentukan, peringatan akan beralih ke status. `Firing` Jika tidak lagi terpenuhi, ia kembali ke `Normal` negara.
   + Di **Konfigurasikan tidak ada data dan penanganan kesalahan**, konfigurasikan perilaku peringatan jika tidak ada data. gunakan pedoman di. [Tidak menangani data atau kasus kesalahan](#rule-no-data-error)
   + Pilih **Pratinjau lansiran** untuk memeriksa hasil menjalankan kueri saat ini. Pratinjau mengecualikan tidak ada data dan kondisi penanganan kesalahan.

1. Pada **Langkah 4**, tambahkan metadata tambahan yang terkait dengan aturan.
   + Tambahkan deskripsi dan ringkasan untuk menyesuaikan pesan peringatan. Gunakan pedoman di[Anotasi dan label untuk aturan peringatan](#alert-rule-labels).
   + Tambahkan URL Runbook, panel, dasbor, dan ID peringatan.
   + Tambahkan label khusus.

1. Pilih **Simpan** untuk menyimpan aturan atau **Simpan dan keluar** untuk menyimpan aturan dan kembali ke halaman **Peringatan**.

### Aturan tunggal dan multidimensi
<a name="single-multi-rule"></a>

Untuk aturan peringatan terkelola Grafana, Anda dapat membuat aturan dengan kondisi klasik atau Anda dapat membuat aturan multidimensi.

**Aturan dimensi tunggal (kondisi klasik)**

Gunakan ekspresi kondisi klasik untuk membuat aturan yang memulai peringatan tunggal ketika 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.

Untuk informasi selengkapnya tentang cara memformat ekspresi, lihat [Ekspresi](https://grafana.com/docs/grafana/next/panels/query-a-data-source/) dalam dokumentasi *Grafana*.

**Aturan multidimensi**

Untuk menghasilkan instance peringatan terpisah untuk setiap seri yang dikembalikan dalam kueri, buat aturan multidimensi.

**catatan**  
Setiap instance peringatan yang dihasilkan oleh aturan multi-dimensi dihitung terhadap total kuota peringatan Anda. Aturan tidak dievaluasi ketika Anda mencapai kuota peringatan Anda. Untuk informasi selengkapnya tentang kuota untuk aturan multi-dimensi, lihat. [Kuota mencapai kesalahan](#rule-quota-reached)

Untuk membuat beberapa instance dari satu aturan, gunakan `Math``Reduce`, atau `Resample` ekspresi untuk membuat aturan multidimensi. Misalnya, Anda dapat:
+ Tambahkan `Reduce` ekspresi untuk setiap kueri ke nilai agregat dalam rentang waktu yang dipilih menjadi satu nilai. (Tidak diperlukan untuk [aturan menggunakan data numerik](alert-fundamentals.md#alert-numeric)).
+ Tambahkan `Math` ekspresi dengan kondisi untuk aturan. Ini tidak diperlukan jika kueri atau ekspresi pengurangan sudah mengembalikan 0 jika aturan tidak harus memulai peringatan, atau angka positif jika harus memulai peringatan. 

  Beberapa contoh: 
  + `$B > 70`jika harus memulai peringatan jika nilai B query/expression lebih dari 70. 
  + `$B < $C * 100`dalam hal itu harus memulai peringatan 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 halaman komunitas [Variabel Template tidak didukung dalam kueri peringatan saat menyiapkan Peringatan](https://community.grafana.com/t/template-variables-are-not-supported-in-alert-queries-while-setting-up-alert/2514).



**Pertimbangan kinerja untuk aturan multidimensi**

Setiap instance peringatan dihitung terhadap kuota peringatan. Aturan multidimensi yang membuat lebih banyak instance daripada yang dapat diakomodasi dalam kuota peringatan tidak dievaluasi dan mengembalikan kesalahan kuota. Untuk informasi selengkapnya, lihat [Kuota mencapai kesalahan](#rule-quota-reached).

Peringatan multidimensi dapat berdampak tinggi pada kinerja ruang kerja Grafana Anda, serta kinerja sumber data Anda saat Grafana menanyakannya untuk mengevaluasi aturan peringatan Anda. Pertimbangan berikut dapat membantu saat Anda mencoba mengoptimalkan kinerja sistem pemantauan Anda.
+ **Frekuensi evaluasi aturan — Evaluasi** **Setiap** properti dari aturan peringatan mengontrol frekuensi evaluasi aturan. Kami merekomendasikan menggunakan frekuensi evaluasi terendah yang dapat diterima. 
+ **Hasil set kardinalitas** — Jumlah instance peringatan yang Anda buat dengan aturan memengaruhi kinerjanya. Misalkan Anda memantau kesalahan respons API untuk setiap jalur API, di setiap VM di armada Anda. Set ini memiliki kardinalitas jumlah jalur dikalikan dengan jumlah VM. Anda dapat mengurangi kardinalitas set hasil, misalnya, dengan memantau kesalahan total per VM, bukan per jalur per VM.
+ **Kompleksitas kueri — Kueri** yang sumber data dapat memproses dan merespons dengan cepat mengkonsumsi lebih sedikit sumber daya. Meskipun pertimbangan ini kurang penting daripada pertimbangan lain yang tercantum di atas, jika Anda telah menguranginya sebanyak mungkin, melihat kinerja kueri individu dapat membuat perbedaan. Anda juga harus menyadari dampak kinerja yang mengevaluasi aturan ini terhadap sumber data Anda. Kueri peringatan seringkali merupakan sebagian besar kueri yang ditangani oleh database pemantauan, jadi faktor beban yang sama yang memengaruhi instance Grafana juga memengaruhi mereka.

### Kuota mencapai kesalahan
<a name="rule-quota-reached"></a>

Ada kuota untuk jumlah instance peringatan yang dapat Anda miliki dalam satu ruang kerja. Ketika Anda mencapai nomor itu, Anda tidak dapat lagi membuat aturan peringatan baru di ruang kerja itu. Dengan peringatan multidimensi, jumlah instance peringatan dapat bervariasi dari waktu ke waktu.

Berikut ini penting untuk diingat saat bekerja dengan instance peringatan.
+ Jika Anda hanya membuat aturan satu dimensi, setiap aturan adalah contoh peringatan tunggal. Anda dapat membuat jumlah aturan yang sama dalam satu ruang kerja dengan kuota instans peringatan, dan tidak lebih.
+ Aturan multidimensi membuat beberapa contoh peringatan, namun jumlahnya tidak diketahui sampai dievaluasi. Misalnya, jika Anda membuat aturan peringatan yang melacak penggunaan CPU instans Amazon EC2 Anda, mungkin ada 50 instans EC2 saat Anda membuatnya (dan karenanya 50 instans peringatan), tetapi jika Anda menambahkan 10 instans EC2 lagi seminggu kemudian, evaluasi berikutnya memiliki 60 instance peringatan.

  Jumlah instans peringatan dievaluasi ketika Anda membuat peringatan multidimensi, dan Anda tidak dapat membuat satu yang segera menempatkan Anda di atas kuota instance peringatan Anda. Karena jumlah instans peringatan dapat berubah, kuota Anda akan diperiksa setiap kali aturan Anda dievaluasi.
+ Pada waktu evaluasi aturan, jika aturan menyebabkan Anda melampaui kuota untuk instans peringatan, aturan tersebut tidak dievaluasi sampai pembaruan dibuat pada aturan peringatan yang membawa jumlah total instance peringatan di bawah kuota layanan. Ketika ini terjadi, Anda menerima pemberitahuan peringatan yang memberi tahu Anda bahwa kuota Anda telah tercapai (notifikasi menggunakan kebijakan notifikasi untuk aturan yang sedang dievaluasi). Pemberitahuan mencakup `Error` anotasi dengan nilai`QuotaReachedError`.
+ Aturan yang menyebabkan `QuotaReachedError` berhenti dievaluasi. Evaluasi hanya dilanjutkan ketika pembaruan dilakukan dan evaluasi setelah pembaruan tidak sendiri menyebabkan a. `QuotaReachedError` Aturan yang tidak dievaluasi menunjukkan kesalahan **Kuota yang dicapai** di konsol Grafana.
+ Anda dapat menurunkan jumlah instance peringatan dengan menghapus aturan peringatan, atau dengan mengedit peringatan multidimensi agar lebih sedikit instance peringatan (misalnya, dengan memiliki satu peringatan tentang kesalahan per VM, daripada satu peringatan tentang kesalahan per API di VM).
+ Untuk melanjutkan evaluasi, perbarui peringatan dan simpan. Anda dapat memperbaruinya untuk menurunkan jumlah instance peringatan, atau jika Anda telah membuat perubahan lain untuk menurunkan jumlah instance peringatan, Anda dapat menyimpannya tanpa perubahan. Jika bisa dilanjutkan, memang begitu. Jika itu menyebabkan yang lain`QuotaReachedError`, Anda tidak dapat menyimpannya.
+ Ketika peringatan disimpan dan melanjutkan evaluasi tanpa melewati kuota peringatan, kesalahan **Kuota tercapai** dapat terus ditampilkan di konsol Grafana untuk beberapa waktu (hingga interval evaluasinya), namun, evaluasi aturan peringatan akan dimulai dan peringatan dikirim jika ambang batas aturan terpenuhi.
+ Untuk detail tentang kuota peringatan, serta kuota lainnya, lihat. [Kuota layanan Grafana yang Dikelola Amazon](AMG_quotas.md)

### Tidak menangani data atau kasus kesalahan
<a name="rule-no-data-error"></a>

Pilih opsi untuk menangani perilaku peringatan jika tidak ada data atau ketika ada kesalahan.

Opsi untuk menangani tidak ada data tercantum dalam tabel berikut.


| Tidak ada opsi Data | Perilaku | 
| --- | --- | 
| Tidak ada Data | Buat peringatan `DatasourceNoData` dengan nama dan UID aturan peringatan, dan UID sumber data yang tidak mengembalikan data sebagai label. | 
| Peringatan | Tetapkan status aturan peringatan ke`Alerting`. | 
| OK | Tetapkan status aturan peringatan ke`Normal`. | 

Opsi untuk menangani kasus kesalahan tercantum dalam tabel berikut.


| Opsi kesalahan atau batas waktu | Perilaku | 
| --- | --- | 
| Peringatan | Tetapkan status aturan peringatan ke `Alerting` | 
| OK | Tetapkan status aturan peringatan ke `Normal` | 
| Kesalahan | Buat peringatan `DatasourceError` dengan nama dan UID aturan peringatan, dan UID sumber data yang tidak mengembalikan data sebagai label. | 

## Anotasi dan label untuk aturan peringatan
<a name="alert-rule-labels"></a>

Anotasi dan label adalah pasangan nilai kunci yang terkait dengan peringatan yang berasal dari aturan peringatan, respons sumber data, dan sebagai hasil dari evaluasi aturan peringatan. Mereka dapat digunakan dalam pemberitahuan peringatan secara langsung atau dalam [template](alert-message-templates.md) dan [fungsi template](alert-message-templates.md#alert-template-functions) untuk membuat kontak notifikasi secara dinamis.

**Anotasi**

Anotasi adalah pasangan nilai kunci yang memberikan informasi tambahan tentang peringatan. Anda dapat menggunakan anotasi berikut:`description`,,`summary`,`runbook_url`, `alertId``dashboardUid`, dan`panelId`. Ini ditampilkan dalam detail aturan dan peringatan di UI dan dapat digunakan dalam templat pesan titik kontak.

**Label**

Label adalah pasangan nilai kunci yang berisi informasi tentang peringatan. Label yang ditetapkan untuk peringatan dibuat dan ditambahkan ke seluruh evaluasi peringatan dan proses notifikasi. Mereka digunakan dengan cara-cara berikut.
+ Kumpulan label lengkap untuk peringatan secara unik mengidentifikasi peringatan itu dalam Peringatan Grafana.
+ [Alertmanager menggunakan label untuk mencocokkan peringatan untuk [keheningan](alert-silences.md) dan [grup peringatan](alert-groups.md) dalam kebijakan notifikasi.](alert-notifications.md)
+ UI peringatan menampilkan label untuk setiap instance peringatan yang dihasilkan oleh evaluasi aturan tersebut.
+ Titik kontak dapat mengakses label untuk menghasilkan notifikasi secara dinamis yang berisi informasi khusus untuk peringatan yang menghasilkan pemberitahuan.
+ Label dapat ditambahkan ke [aturan peringatan](#alert-rules). Label yang dikonfigurasi secara manual ini dapat menggunakan fungsi templat dan referensi label lain. Label yang ditambahkan ke aturan peringatan di sini diutamakan jika terjadi tabrakan antar label.

Variabel template berikut tersedia saat memperluas anotasi dan label.


| Nama | Deskripsi | 
| --- | --- | 
| `$labels` | Label dari kueri atau kondisi. Misalnya, `{{ $labels.instance }}` dan `{{ $labels.job }}`. Ini tidak tersedia ketika aturan menggunakan kondisi klasik. | 
| `$values` | Nilai dari semua ekspresi reduce dan matematika yang dievaluasi untuk aturan peringatan ini. Misalnya,`{{ $values.A }}`, `{{ $values.A.Labels }}` dan `{{ $values.A.Value }}` di mana `A` ekspresi. `refID` Ini tidak tersedia ketika aturan menggunakan kondisi klasik | 
| `$value` | String nilai dari instance peringatan. Misalnya, `[ var='A' labels={instance=foo} value=10 ]`. | 

## Mengelola aturan peringatan
<a name="manage-alert-rules"></a>



Halaman **Peringatan mencantumkan** aturan peringatan. Secara default, aturan dikelompokkan berdasarkan jenis sumber data. Bagian **Grafana mencantumkan** aturan yang dikelola oleh Grafana, dan bagian tersebut mencantumkan aturan untuk sumber data yang **Cortex/Loki**kompatibel dengan Prometheus. Anda dapat melihat aturan peringatan untuk sumber data yang kompatibel dengan Prometheus tetapi Anda tidak dapat mengeditnya.

### Lihat aturan peringatan
<a name="manage-alerts-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 ikon **Peringatan** (bel) untuk membuka halaman Peringatan.** Secara default, aturan ditampilkan dalam grup berdasarkan tipe sumber data. Anda juga dapat melihat berdasarkan status saat ini dari setiap peringatan (ini dijelaskan secara lebih rinci dalam teks berikut).

1. Di **View as**, Anda dapat beralih antara tampilan grup dan status dengan memilih opsi yang Anda inginkan.

1. Pilih panah di sebelah baris untuk melihat detail lebih lanjut untuk baris itu. Detail untuk aturan mencakup label aturan, anotasi, sumber data, dan kueri, serta daftar instance peringatan yang dihasilkan dari aturan.

**Tampilan grup**

Tampilan grup menunjukkan aturan peringatan Grafana yang dikelompokkan berdasarkan folder dan aturan peringatan Loki atau Prometheus yang dikelompokkan berdasarkan \+. `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.

**Filter aturan peringatan**

Anda dapat memfilter aturan peringatan yang muncul di halaman **Peringatan dengan** beberapa cara.
+ Anda dapat memfilter untuk menampilkan aturan yang menanyakan sumber data tertentu dengan memilih **Pilih sumber data**, lalu memilih sumber data yang akan difilter.
+ Anda dapat memfilter berdasarkan label dengan memilih kriteria pencarian di **Cari berdasarkan label**. Beberapa kriteria sampel meliputi`environment=production`,`region=~US|EU`,`severity!=warning`.
+ Anda dapat memfilter untuk menampilkan aturan dalam keadaan tertentu dengan memilih **Menyaring peringatan menurut negara**, lalu memilih status yang ingin Anda lihat.

### Mengedit atau menghapus aturan peringatan
<a name="manage-alerts-edit"></a>

Aturan peringatan terkelola Grafana hanya dapat diedit atau dihapus oleh pengguna dengan izin Edit untuk folder yang menyimpan aturan. Aturan peringatan untuk instance Cortex atau Loki eksternal dapat diedit atau dihapus oleh pengguna dengan peran Editor atau Admin.

**Untuk mengedit atau menghapus aturan**

1. Perluas aturan hingga Anda dapat melihat kontrol aturan untuk **Lihat**, **Edit**, dan **Hapus**.

1. Pilih **Edit** untuk membuka halaman aturan buat. Buat pembaruan dengan cara yang sama seperti Anda membuat aturan. Untuk detailnya, lihat instruksi di [Membuat aturan peringatan terkelola Grafana](#create-grafana-alert-rule) atau[Membuat aturan peringatan terkelola Cortex atau Loki](#create-alert-rule).

1. Secara opsional, pilih **Hapus** untuk menghapus aturan.

## Grup aturan dan ruang nama Cortex atau Loki
<a name="alert-rule-groups"></a>

Anda dapat mengatur aturan Anda. Aturan dibuat dalam grup aturan, dan grup aturan diatur ke dalam ruang nama. Aturan dalam kelompok aturan dijalankan secara berurutan pada interval reguler. Interval default adalah satu menit. Anda dapat mengganti nama ruang nama Cortex atau Loki dan grup aturan, dan mengedit interval evaluasi grup aturan.

**Untuk mengedit grup aturan atau namespace**

1. **Dari konsol Grafana Anda, di menu Grafana, pilih ikon **Peringatan** (bel) untuk membuka halaman Peringatan.**

1. Arahkan ke aturan dalam grup aturan atau namespace yang ingin Anda edit.

1. Pilih ikon **Edit** (pena).

1. Buat perubahan pada grup aturan atau namespace.
**catatan**  
Untuk ruang nama, Anda hanya dapat mengedit nama. Untuk grup aturan, Anda mengubah nama, atau interval evaluasi untuk aturan dalam grup. Misalnya, Anda dapat memilih `1m` agar aturan dievaluasi sekali per menit, atau `30s` mengevaluasi setiap 30 detik sekali.

1. Pilih **Simpan perubahan**.