Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Peringatan di Grafana versi 10
****
**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
**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
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
+ 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
****
**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
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
Berikut ini memberikan ikhtisar tentang berbagai bagian peringatan Grafana.
### Aturan peringatan
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
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
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
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
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
****
**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
****
**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
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 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
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
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
****
**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
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
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
****
**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
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 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
****
**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
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
Variabel berikut tersedia untuk Anda saat membuat template label dan anotasi:
### Variabel label
`$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
`$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
`$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
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
****
**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
****
**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
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
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
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
****
**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
****
**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
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
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
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
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
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
****
**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
****
**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
****
**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
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
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
****
**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
****
**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. `/public/emails/ng_alert_notification.html` Anda dapat mengedit file ini untuk mengubah tampilan semua email peringatan.
# Pengelola Peringatan
****
**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
****
**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
****
**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
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 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
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
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
****
**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
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
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
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
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
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
### Pengelompokan
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
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
Jika Anda ingin menerima semua peringatan bersama-sama dalam satu pemberitahuan, Anda dapat melakukannya dengan meninggalkan Grup dengan kosong.
### Opsi waktu
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
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
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
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
****
**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
****
**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
****
**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
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
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
+ 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
Diperkenalkan di Grafana 8, peringatan Grafana memiliki beberapa peningkatan dibandingkan peringatan dasbor lama.
### Peringatan multi-dimensi
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
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
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
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
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
****
**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
****
**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
****
**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
+ 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
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
[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 =
auth =
}
```
## Penyediaan titik kontak dan templat
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 ** 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 =
text = <
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
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
[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 = <
****
**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
****
**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
****
**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
****
**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
****
**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
****
**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
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
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
****
**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
****
**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
****
**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
****
**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
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
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 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
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
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
Untuk mencetak anotasi atau label tertentu, gunakan `index` fungsi.
```
{{ range .Alerts }}
The name of the alert is {{ index .Labels "alertname" }}
{{ end }}
```
## Jika pernyataan
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
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
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
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
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
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
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
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
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
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
****
**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
**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
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
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
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
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
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
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
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
****
**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
****
**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
****
**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
****
**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
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
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
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
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
****
**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
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
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
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
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
****
**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
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
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
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
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
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
****
**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
****
**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.