Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# 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.