Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Menjelajahi peringatan
****
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**
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 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)
Baik Anda memulai atau memperluas implementasi Grafana Alerting, pelajari lebih lanjut tentang konsep utama dan fitur yang tersedia yang membantu Anda membuat, mengelola, dan mengambil tindakan pada peringatan Anda dan meningkatkan kemampuan tim Anda untuk menyelesaikan masalah dengan cepat.
Pertama-tama, mari kita lihat berbagai jenis aturan peringatan yang ditawarkan Grafana Alerting.
## Jenis aturan peringatan
**Aturan yang dikelola Grafana**
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. Ini adalah satu-satunya jenis aturan yang memungkinkan peringatan dari beberapa sumber data dalam satu definisi aturan.
**Aturan Mimir dan Loki**
Untuk membuat peringatan Mimir atau Loki, 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 API penggaris didukung.
**Aturan perekaman**
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.
## Konsep dan fitur utama
Tabel berikut mencakup daftar konsep kunci, fitur, dan definisinya, yang dirancang untuk membantu Anda memaksimalkan Grafana Alerting.
| Konsep atau fitur kunci | Definisi |
| --- | --- |
| Sumber data untuk Peringatan | Pilih sumber data yang ingin Anda kueri dan visualisasikan metrik, log, dan jejak. |
| Penyediaan untuk Peringatan | Kelola sumber daya peringatan Anda dan sediakan ke dalam sistem Grafana Anda menggunakan penyediaan file atau Terraform. |
| Pengelola Peringatan | Mengelola perutean dan pengelompokan instance peringatan. |
| Aturan peringatan | Seperangkat kriteria evaluasi kapan aturan peringatan harus ditembakkan. Aturan peringatan terdiri dari satu atau lebih pertanyaan dan ekspresi, kondisi, frekuensi evaluasi, dan durasi di mana kondisi terpenuhi. Aturan peringatan dapat menghasilkan beberapa instance peringatan. |
| Contoh peringatan | Sebuah instance peringatan adalah contoh dari aturan peringatan. Aturan peringatan satu dimensi memiliki satu contoh peringatan. Aturan peringatan multidimensi memiliki satu atau lebih contoh peringatan. Aturan peringatan tunggal yang cocok dengan beberapa hasil, seperti CPU terhadap 10 VMs, dihitung sebagai beberapa (dalam hal ini 10) instance peringatan. Jumlah ini dapat bervariasi dari waktu ke waktu. Misalnya, aturan peringatan yang memantau penggunaan CPU untuk semua VMs dalam sistem memiliki lebih banyak instance peringatan seperti VMs yang ditambahkan. Untuk informasi selengkapnya tentang kuota instance peringatan, lihat. [Kuota mencapai kesalahan](v9-alerting-managerules-grafana.md#v9-alerting-rule-quota-reached) |
| Grup peringatan | Alertmanager mengelompokkan instance peringatan secara default menggunakan label untuk kebijakan notifikasi root. Ini mengontrol de-duplikasi dan grup instance peringatan, yang dikirim ke titik kontak. |
| Titik kontak | Tentukan bagaimana kontak Anda diberi tahu saat aturan peringatan diaktifkan. |
| Templating pesan | Buat templat khusus yang dapat digunakan kembali dan gunakan di titik kontak. |
| Kebijakan pemberitahuan | Set aturan untuk di mana, kapan, dan bagaimana peringatan dikelompokkan dan diarahkan ke titik kontak. |
| Label dan pencocokan label | Label secara unik mengidentifikasi aturan peringatan. Mereka menghubungkan aturan peringatan dengan kebijakan pemberitahuan dan pembungkaman, menentukan kebijakan mana yang harus menanganinya dan aturan peringatan mana yang harus dibungkam. |
| Keheningan | Hentikan pemberitahuan dari satu atau beberapa contoh peringatan. Perbedaan antara keheningan dan waktu bisu adalah bahwa keheningan hanya berlangsung hanya untuk jendela waktu tertentu sedangkan waktu bisu dimaksudkan untuk berulang pada jadwal. Menggunakan pencocokan label untuk membungkam instance peringatan. |
| Bisukan waktu | Tentukan interval waktu saat Anda tidak ingin notifikasi baru dibuat atau dikirim. Anda juga dapat membekukan notifikasi peringatan untuk periode waktu berulang, seperti selama periode pemeliharaan. Harus ditautkan ke kebijakan pemberitahuan yang ada. |
# Sumber data
****
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**
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 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)
Ada sejumlah [sumber data](AMG-data-sources-builtin.md) yang kompatibel dengan Grafana Alerting. Setiap sumber data didukung oleh plugin. Anda dapat menggunakan salah satu sumber data bawaan yang tercantum di bawah ini.
Ini adalah sumber data yang kompatibel dengan dan didukung oleh Grafana yang Dikelola Amazon.
+ [Connect ke sumber data Alertmanager](data-source-alertmanager.md)
+ [Connect ke sumber CloudWatch data Amazon](using-amazon-cloudwatch-in-AMG.md)
+ [Connect ke sumber data Amazon OpenSearch Service](using-Amazon-OpenSearch-in-AMG.md)
+ [Connect ke sumber AWS IoT SiteWise data](using-iotsitewise-in-AMG.md)
+ [Connect ke sumber AWS IoT TwinMaker data](AMG-iot-twinmaker.md)
+ [Connect ke Amazon Managed Service untuk Prometheus dan sumber data Prometheus sumber terbuka](prometheus-data-source.md)
+ [Connect ke sumber data Amazon Timestream](timestream-datasource.md)
+ [Connect ke sumber data Amazon Athena](AWS-Athena.md)
+ [Connect ke sumber data Amazon Redshift](AWS-Redshift.md)
+ [Connect ke sumber AWS X-Ray data](x-ray-data-source.md)
+ [Connect ke sumber data Azure Monitor](using-azure-monitor-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 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)
# Tentang aturan peringatan
****
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**
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 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 opsional, durasi di mana kondisi terpenuhi.
Sementara kueri dan ekspresi memilih kumpulan data untuk dievaluasi, kondisi menetapkan ambang batas yang harus dipenuhi atau dilampaui peringatan 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](v9-alerting-explore-rules-types.md)
+ [Contoh peringatan](v9-alerting-rules-instances.md)
+ [Ruang nama dan grup](v9-alerting-rules-grouping.md)
+ [Templating pemberitahuan](v9-alerting-rules-notification-templates.md)
# Jenis aturan peringatan
****
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**
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 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)
Grafana mendukung beberapa jenis aturan peringatan. Bagian berikut akan menjelaskan kelebihan dan kekurangannya dan membantu Anda memilih jenis peringatan yang tepat untuk kasus penggunaan Anda.
Aturan terkelola Grafana
Aturan yang dikelola 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 sumber data apa pun, Anda dapat menambahkan [ekspresi](v9-panels-query-xform-expressions.md) untuk mengubah data Anda dan menyatakan kondisi peringatan.
Aturan Mimir, Loki dan Cortex
Untuk membuat peringatan Mimir, Loki, atau Cortex, Anda harus memiliki sumber data Prometheus yang kompatibel. Anda dapat memeriksa apakah sumber data Anda kompatibel dengan menguji sumber data dan memeriksa detailnya jika API penggaris didukung.
Aturan perekaman
Aturan perekaman hanya tersedia untuk sumber data Prometheus yang kompatibel seperti Mimir, Loki, dan Cortex.
Aturan perekaman memungkinkan Anda menyimpan hasil ekspresi ke rangkaian deret waktu baru. Ini berguna jika Anda ingin menjalankan peringatan pada data agregat atau jika Anda memiliki dasbor yang menanyakan ekspresi yang sama berulang kali.
Baca lebih lanjut tentang [aturan perekaman](https://prometheus.io/docs/prometheus/latest/configuration/recording_rules/) di Prometheus.
# Contoh peringatan
****
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**
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 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 diamati selama evaluasi, memungkinkan satu aturan untuk melaporkan status setiap CPU.
# Ruang nama dan grup
****
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**
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 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**
Saat membuat aturan yang dikelola Grafana, folder dapat digunakan untuk melakukan kontrol akses dan memberikan atau menolak akses ke semua aturan dalam folder tertentu.
**Grup**
Semua aturan dalam kelompok dievaluasi pada **interval** yang sama.
Aturan peringatan dan aturan perekaman dalam grup akan selalu dievaluasi **secara berurutan**, artinya tidak ada aturan yang akan dievaluasi pada saat yang sama dan dalam urutan penampilan.
**Tip**
Jika Anda ingin aturan dievaluasi secara bersamaan dan dengan interval yang berbeda, pertimbangkan untuk menyimpannya dalam kelompok yang berbeda.
# Templating pemberitahuan
****
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**
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 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](v9-alerting-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. `/public/emails/ng_alert_notification.html` Anda dapat mengedit file ini untuk mengubah tampilan semua email peringatan.
# Peringatan pada data numerik
****
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**
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 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 tidak 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**
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**
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
****
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**
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 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](v9-alerting-explore-labels-templating.md) cara melakukannya). Deskripsi semacam ini akan lebih cocok sebagai anotasi.
## Label
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](v9-alerting-explore-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
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](v9-alerting-explore-labels-templating.md).
# Cara kerja pencocokan label
****
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**
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 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 skenario**
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.
# Label di Grafana Alerting
****
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**
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 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](v9-alerting-managerules.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**
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**
**catatan**
Label yang diawali dengan `grafana_` dicadangkan oleh Grafana untuk penggunaan khusus. Jika label yang dikonfigurasi secara manual ditambahkan dimulai dengan `grafana_` itu dapat 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
****
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**
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 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)
Di Grafana, Anda membuat template label dan anotasi seperti yang Anda lakukan di Prometheus. Jika Anda telah menggunakan Prometheus sebelumnya maka Anda harus terbiasa dengan `$labels` variabel `$value` dan, yang berisi label dan nilai peringatan. Anda dapat menggunakan variabel yang sama di Grafana, bahkan jika peringatan tidak menggunakan sumber data Prometheus. Jika Anda belum pernah menggunakan Prometheus sebelumnya maka jangan khawatir karena masing-masing variabel ini, dan cara membuat template mereka, akan dijelaskan saat Anda mengikuti sisa halaman ini.
## Bahasa Templating Go
[Template untuk label dan anotasi ditulis dalam bahasa template Go, teks/template.](https://pkg.go.dev/text/template)
**Membuka dan menutup tag**
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**
Untuk mencetak nilai sesuatu gunakan `{{` dan`}}`. Anda dapat mencetak hasil fungsi atau nilai variabel. Misalnya, untuk mencetak `$labels` variabel Anda akan menulis yang berikut:
```
{{ $labels }}
```
**Iterasi di atas label**
Untuk mengulangi setiap label di `$labels` Anda dapat menggunakan. `range` Di sini `$k` mengacu pada nama dan `$v` mengacu pada nilai label saat ini. Misalnya, jika kueri Anda mengembalikan label `instance=test` maka `$k` akan `instance` dan `$v` akan menjadi`test`.
```
{{ range $k, $v := $labels }}
{{ $k }}={{ $v }}
{{ end }}
```
## Label, nilai dan nilai variabel
**Variabel label**
`$labels`Variabel berisi label dari kueri. Misalnya, kueri yang memeriksa apakah instance sedang down mungkin mengembalikan label instance dengan nama instance yang sedang down. Misalnya, Anda memiliki aturan peringatan yang menyala ketika salah satu instance Anda telah mati selama lebih dari 5 menit. Anda ingin menambahkan ringkasan ke peringatan yang memberi tahu Anda instance mana yang sedang down. Dengan `$labels` variabel, Anda dapat membuat ringkasan yang mencetak label instance dalam ringkasan:
```
Instance {{ $labels.instance }} has been down for more than 5 minutes
```
**Label dengan titik-titik**
Jika label yang ingin Anda cetak berisi titik (penghentian penuh atau titik) dalam namanya menggunakan titik yang sama di templat tidak akan berfungsi:
```
Instance {{ $labels.instance.name }} has been down for more than 5 minutes
```
Ini karena template mencoba menggunakan bidang yang tidak ada yang dipanggil`name`. `$labels.instance` Anda sebaiknya menggunakan `index` fungsi, yang mencetak label `instance.name` dalam `$labels` variabel:
```
Instance {{ index $labels "instance.name" }} has been down for more than 5 minutes
```
**Variabel nilai**
`$value`Variabel bekerja berbeda dari Prometheus. Dalam `$value` Prometheus adalah nomor floating point yang berisi nilai ekspresi, tetapi di Grafana itu adalah string yang berisi label dan nilai dari semua ekspresi Ambang, Kurangi dan Matematika, dan Kondisi Klasik untuk aturan peringatan ini. Ini tidak berisi hasil kueri, karena ini dapat kembali dari 10 hingga 10.000 baris atau metrik.
Jika Anda menggunakan `$value` variabel dalam ringkasan peringatan:
```
{{ $labels.service }} has over 5% of responses with 5xx errors: {{ $value }})
```
Ringkasannya mungkin terlihat seperti berikut:
```
api has an over 5% of responses with 5xx errors: [ var='B' labels={service=api} value=6.789 ]
```
Di sini `var='B'` mengacu pada ekspresi dengan RefiD B. Di Grafana, semua kueri dan ekspresi diidentifikasi oleh ReFID yang mengidentifikasi setiap kueri dan ekspresi dalam aturan peringatan. Demikian pula `labels={service=api}` mengacu pada label, dan `value=6.789` mengacu pada nilai.
Anda mungkin telah mengamati bahwa tidak ada ReFID A. Itu karena di sebagian besar aturan peringatan ReFID A mengacu pada kueri, dan karena kueri dapat mengembalikan banyak baris atau deret waktu mereka tidak termasuk dalam. `$value`
**Variabel nilai**
Jika `$value` variabel berisi lebih banyak informasi daripada yang Anda butuhkan, Anda dapat mencetak label dan nilai ekspresi individu menggunakan`$values`. Tidak seperti`$value`, `$values` variabel adalah tabel objek yang berisi label dan nilai floating point dari setiap ekspresi, diindeks oleh ReFID mereka.
Jika Anda mencetak nilai ekspresi dengan ReFID `B` dalam ringkasan peringatan:
```
{{ $labels.service }} has over 5% of responses with 5xx errors: {{ $values.B }}%
```
Ringkasan hanya akan berisi nilai:
```
api has an over 5% of responses with 5xx errors: 6.789%
```
Namun, saat `{{ $values.B }}` mencetak angka 6.789, itu sebenarnya adalah string karena Anda mencetak objek yang berisi label dan nilai untuk RefiD B, bukan nilai floating point B. Untuk menggunakan nilai floating point dari RefiD B Anda harus menggunakan bidang dari. `Value` `$values.B` Jika Anda memanusiakan nilai floating point dalam ringkasan peringatan:
```
{{ $labels.service }} has over 5% of responses with 5xx errors: {{ humanize $values.B.Value }}%
```
**Tidak ada data, kesalahan runtime, dan batas waktu**
Jika kueri dalam aturan peringatan Anda tidak mengembalikan data, atau gagal karena kesalahan sumber data atau batas waktu, maka ekspresi Threshold, Reduce atau Math apa pun yang menggunakan kueri itu juga tidak akan mengembalikan data atau kesalahan. Ketika ini terjadi ungkapan ini akan absen dari`$values`. Merupakan praktik yang baik untuk memeriksa apakah ReFID ada sebelum menggunakannya karena jika tidak, template Anda akan rusak jika kueri Anda tidak mengembalikan data atau kesalahan. Anda dapat melakukan ini menggunakan pernyataan if:
```
{{ if $values.B }}{{ $labels.service }} has over 5% of responses with 5xx errors: {{ humanizePercentage $values.B.Value }}{{ end }}
```
## Kondisi Klasik
Jika aturan menggunakan Classic Conditions bukan Threshold, Reduce dan Math ekspresi, maka `$values` variabel diindeks oleh kedua ID Ref dan posisi kondisi dalam Kondisi Klasik. Misalnya, jika Anda memiliki Kondisi Klasik dengan ReFID B yang berisi dua kondisi, maka `$values` akan berisi dua kondisi `B0` dan. `B1`
```
The first condition is {{ $values.B0 }}, and the second condition is {{ $values.B1 }}
```
## Fungsi
Fungsi-fungsi berikut juga tersedia saat memperluas 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.
**Contoh**
```
{{define "x"}}{{.arg0}} {{.arg1}}{{end}}{{template "x" (args 1 "2")}}
```
```
1 2
```
**URL eksternal**
`externalURL`Fungsi mengembalikan URL eksternal dari server Grafana seperti yang dikonfigurasi dalam file ini (s).
**Contoh**
```
{{ externalURL }}
```
```
https://example.com/grafana
```
**GraphLink**
`graphLink`Fungsi mengembalikan path ke tampilan grafis [Jelajahi di Grafana versi 9](v9-explore.md) untuk ekspresi yang diberikan dan sumber data.
**Contoh**
```
{{ 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.
**Contoh**
```
{{ humanize 1000.0 }}
```
```
1k
```
**manusia1024**
`humanize1024`Karya-karya yang mirip dengan `humanize` tetapi menggunakan 1024 sebagai basis daripada 1000.
**Contoh**
```
{{ humanize1024 1024.0 }}
```
```
1ki
```
**HumanizeUrasi**
`humanizeDuration`Fungsi memanusiakan durasi dalam hitungan detik.
**Contoh**
```
{{ humanizeDuration 60.0 }}
```
```
1m 0s
```
**HumanizePersentase**
`humanizePercentage`Fungsi memanusiakan nilai rasio terhadap persentase.
**Contoh**
```
{{ humanizePercentage 0.2 }}
```
```
20%
```
**HumanizeTimestamp**
`humanizeTimestamp`Fungsi ini memanusiakan stempel waktu Unix.
**Contoh**
```
{{ humanizeTimestamp 1577836800.0 }}
```
```
2020-01-01 00:00:00 +0000 UTC
```
**pertandingan**
`match`Fungsi ini cocok dengan teks terhadap pola ekspresi reguler.
**Contoh**
```
{{ match "a.*" "abc" }}
```
```
true
```
**PathPrefix**
`pathPrefix`Fungsi mengembalikan path dari server Grafana seperti yang dikonfigurasi dalam file ini (s).
**Contoh**
```
{{ pathPrefix }}
```
```
/grafana
```
**TableLink**
`tableLink`Fungsi mengembalikan path ke tampilan tabular [Jelajahi di Grafana versi 9](v9-explore.md) untuk ekspresi yang diberikan dan sumber data.
**Contoh**
```
{{ 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.
**Contoh**
```
{{ title "hello, world!" }}
```
```
Hello, World!
```
**ToLower**
`toLower`Fungsi mengembalikan semua teks dalam huruf kecil.
**Contoh**
```
{{ toLower "Hello, world!" }}
```
```
hello, world!
```
**TouPper**
`toUpper`Fungsi mengembalikan semua teks dalam huruf besar.
**Contoh**
```
{{ toUpper "Hello, world!" }}
```
```
HELLO, WORLD!
```
**reReplaceAll**
`reReplaceAll`Fungsi menggantikan teks yang cocok dengan ekspresi reguler.
**Contoh**
```
{{ reReplaceAll "localhost:(.*)" "example.com:$1" "localhost:8080" }}
```
```
example.com:8080
```
# Keadaan dan kesehatan aturan peringatan
****
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**
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 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 dari 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 dari 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. |
**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.
# Titik kontak
****
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**
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 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. Titik kontak dapat memiliki satu atau lebih jenis titik kontak, misalnya, email, Slack, webhook, dan sebagainya. Ketika aturan peringatan diaktifkan, pemberitahuan dikirim ke semua jenis titik kontak yang terdaftar untuk titik kontak. 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 [Bekerja dengan titik kontak](v9-alerting-contact-points.md) dan[Sesuaikan notifikasi](v9-alerting-notifications.md).
# Notifikasi
****
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**
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 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)
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
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 root. Hanya ada satu kebijakan root dan kebijakan root 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 perutean tertentu dapat memiliki kebijakan turunannya sendiri, yang disebut kebijakan bersarang, yang memungkinkan pencocokan peringatan tambahan. Contoh kebijakan perutean tertentu 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 root. Namun, ketika kebijakan root menerima peringatan, kebijakan perutean akan melihat setiap kebijakan perutean tertentu dan mengirimkan peringatan ke kebijakan perutean spesifik pertama yang cocok dengan peringatan tersebut. Jika kebijakan perutean tertentu memiliki kebijakan turunan 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 perutean tertentu adalah kebijakan yang cocok. Jika tidak ada kebijakan perutean tertentu, atau tidak ada kebijakan perutean tertentu yang cocok dengan peringatan, maka kebijakan root adalah kebijakan yang cocok.
## Titik kontak
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 Pager Duty; Pager Duty dan integrasi Slack; atau integrasi Pager Duty, 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.
**catatan**
Untuk informasi tentang integrasi yang didukung untuk titik kontak, lihat[Titik kontak](v9-alerting-explore-contacts.md).
## Pemberitahuan Templating
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.
## Keheningan
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.