

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

# Kelola lansiran Anda
<a name="v10-alerting-manage"></a>

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

Setelah menyiapkan aturan peringatan, titik kontak, dan kebijakan notifikasi, Anda dapat menggunakan peringatan Grafana untuk mengelola lansiran Anda dalam praktik.

**Topics**
+ [Sesuaikan notifikasi](v10-alerting-manage-notifications.md)
+ [Kelola titik kontak](v10-alerting-manage-contactpoints.md)
+ [Membungkam pemberitahuan peringatan](v10-alerting-silences.md)
+ [Lihat dan filter aturan peringatan](v10-alerting-manage-rules-viewfilter.md)
+ [Bisukan waktu](v10-alerting-manage-muting.md)
+ [Lihat keadaan dan kesehatan aturan peringatan](v10-alerting-manage-rulestate.md)
+ [Lihat dan filter menurut grup peringatan](v10-alerting-manage-viewfiltergroups.md)
+ [Lihat kesalahan pemberitahuan](v10-alerting-manage-viewnotificationerrors.md)

# Sesuaikan notifikasi
<a name="v10-alerting-manage-notifications"></a>

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

Sesuaikan notifikasi Anda dengan templat notifikasi.

Anda dapat menggunakan templat notifikasi untuk mengubah judul, pesan, dan format pesan di notifikasi.

Template notifikasi tidak terkait dengan integrasi titik kontak tertentu, seperti Amazon SNS atau Slack. Namun, Anda dapat memilih untuk membuat templat notifikasi terpisah untuk integrasi titik kontak yang berbeda.

Anda dapat menggunakan template notifikasi untuk:
+ Menambahkan, menghapus, atau mengurutkan ulang informasi dalam pemberitahuan termasuk ringkasan, deskripsi, label dan anotasi, nilai, dan tautan
+ Format teks dalam huruf tebal dan miring, dan tambahkan atau hapus jeda baris

Anda tidak dapat menggunakan templat notifikasi untuk:
+ Ubah desain notifikasi di layanan pesan instan seperti Slack dan Microsoft Teams

**Topics**
+ [Menggunakan bahasa template Go](v10-alerting-notifications-go-templating.md)
+ [Buat templat notifikasi](v10-alerting-create-templates.md)
+ [Menggunakan template notifikasi](#v10-alerting-use-notification-templates)
+ [Referensi templat](v10-alerting-template-reference.md)

# Menggunakan bahasa template Go
<a name="v10-alerting-notifications-go-templating"></a>

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

Anda menulis template notifikasi dalam bahasa template Go, [teks/template](https://pkg.go.dev/text/template).

Bagian ini memberikan ikhtisar bahasa template Go dan template penulisan dalam teks/template.

## Dot
<a name="v10-go-dot"></a>

Di text/template sana ada kursor khusus yang disebut titik, dan ditulis sebagai`.`. Anda dapat menganggap kursor ini sebagai variabel yang nilainya berubah tergantung di mana dalam template itu digunakan. Misalnya, pada awal template notifikasi `.` mengacu pada `ExtendedData` objek, yang berisi sejumlah bidang termasuk`Alerts`,,`Status`, `GroupLabels``CommonLabels`, `CommonAnnotations` dan`ExternalURL`. Namun, dot mungkin merujuk ke sesuatu yang lain saat digunakan dalam daftar di `range` atas, saat digunakan di dalam`with`, atau saat menulis templat fitur untuk digunakan di templat lain. Anda dapat melihat contoh ini di[Buat templat notifikasi](v10-alerting-create-templates.md), dan semua data dan fungsi di[Referensi templat](v10-alerting-template-reference.md).

## Membuka dan menutup tag
<a name="v10-go-openclosetags"></a>

Dalam teks/template, template dimulai dengan `{{` dan diakhiri dengan `}}` terlepas dari apakah template mencetak variabel atau menjalankan struktur kontrol seperti pernyataan if. Ini berbeda dari bahasa templating lainnya seperti Jinja di mana pencetakan variabel menggunakan `{{` dan `}}` dan struktur kontrol menggunakan `{%` dan. `%}`

## Cetak
<a name="v10-go-print"></a>

Untuk mencetak nilai sesuatu gunakan `{{` dan`}}`. Anda dapat mencetak nilai titik, bidang titik, hasil fungsi, dan nilai [variabel](#v10-go-variables). Misalnya, untuk mencetak `Alerts` bidang di mana titik mengacu pada `ExtendedData` Anda akan menulis yang berikut:

```
{{ .Alerts }}
```

## Iterasi di atas peringatan
<a name="v10-go-iterate-alerts"></a>

Untuk mencetak hanya label setiap peringatan, bukan semua informasi tentang peringatan, Anda dapat menggunakan a `range` untuk mengulangi peringatan di: `ExtendedData`

```
{{ range .Alerts }}
{{ .Labels }}
{{ end }}
```

Di dalam rentang titik tidak lagi mengacu pada`ExtendedData`, tetapi ke`Alert`. Anda dapat menggunakan `{{ .Labels }}` untuk mencetak label setiap peringatan. Ini berfungsi karena `{{ range .Alerts }}` perubahan titik untuk merujuk ke peringatan saat ini dalam daftar peringatan. Ketika rentang selesai titik diatur ulang ke nilai yang dimilikinya sebelum dimulainya rentang, yang dalam contoh ini adalah`ExtendedData`:

```
{{ range .Alerts }}
{{ .Labels }}
{{ end }}
{{/* does not work, .Labels does not exist here */}}
{{ .Labels }}
{{/* works, cursor was reset */}}
{{ .Status }}
```

## Ulangi anotasi dan label
<a name="v10-go-iterate-labels"></a>

Mari kita menulis template untuk mencetak label setiap peringatan dalam format`The name of the label is $name, and the value is $value`, di mana `$name` dan `$value` berisi nama dan nilai setiap label.

Seperti pada contoh sebelumnya, gunakan rentang untuk mengulangi peringatan `.Alerts` sedemikian rupa sehingga titik mengacu pada peringatan saat ini dalam daftar peringatan, dan kemudian gunakan rentang kedua pada label yang diurutkan sehingga titik diperbarui untuk kedua kalinya untuk merujuk ke label saat ini. Di dalam rentang kedua gunakan `.Name` dan `.Value` untuk mencetak nama dan nilai setiap label:

```
{{ range .Alerts }}
{{ range .Labels.SortedPairs }}
The name of the label is {{ .Name }}, and the value is {{ .Value }}
{{ end }}
{{ range .Annotations.SortedPairs }}
The name of the annotation is {{ .Name }}, and the value is {{ .Value }}
{{ end }}
{{ end }}
```

## Fungsi indeks
<a name="v10-go-index"></a>

Untuk mencetak anotasi atau label tertentu, gunakan `index` fungsi.

```
{{ range .Alerts }}
The name of the alert is {{ index .Labels "alertname" }}
{{ end }}
```

## Jika pernyataan
<a name="v10-go-if"></a>

Anda dapat menggunakan pernyataan if dalam template. Misalnya, untuk mencetak `There are no alerts` jika tidak ada peringatan di `.Alerts` Anda akan menulis yang berikut:

```
{{ if .Alerts }}
There are alerts
{{ else }}
There are no alerts
{{ end }}
```

## Dengan
<a name="v10-go-with"></a>

Dengan mirip dengan pernyataan if, namun tidak seperti pernyataan if, `with` pembaruan titik untuk merujuk ke nilai with:

```
{{ with .Alerts }}
There are {{ len . }} alert(s)
{{ else }}
There are no alerts
{{ end }}
```

## Variabel
<a name="v10-go-variables"></a>

Variabel dalam text/template harus dibuat dalam template. Misalnya, untuk membuat variabel yang disebut `$variable` dengan nilai titik saat ini Anda akan menulis yang berikut ini:

```
{{ $variable := . }}
```

Anda dapat menggunakan `$variable` di dalam rentang atau `with` dan itu akan merujuk ke nilai titik pada saat variabel didefinisikan, bukan nilai titik saat ini.

Misalnya, Anda tidak dapat menulis templat yang digunakan `{{ .Labels }}` dalam rentang kedua karena di sini titik mengacu pada label saat ini, bukan peringatan saat ini:

```
{{ range .Alerts }}
{{ range .Labels.SortedPairs }}
{{ .Name }} = {{ .Value }}
{{/* does not work because in the second range . is a label not an alert */}}
There are {{ len .Labels }}
{{ end }}
{{ end }}
```

Anda dapat memperbaikinya dengan mendefinisikan variabel yang disebut `$alert` dalam rentang pertama dan sebelum rentang kedua:

```
{{ range .Alerts }}
{{ $alert := . }}
{{ range .Labels.SortedPairs }}
{{ .Name }} = {{ .Value }}
{{/* works because $alert refers to the value of dot inside the first range */}}
There are {{ len $alert.Labels }}
{{ end }}
{{ end }}
```

## Rentang dengan indeks
<a name="v10-go-rangeindex"></a>

Anda bisa mendapatkan indeks setiap peringatan dalam rentang dengan mendefinisikan indeks dan variabel nilai di awal rentang:

```
{{ $num_alerts := len .Alerts }}
{{ range $index, $alert := .Alerts }}
This is alert {{ $index }} out of {{ $num_alerts }}
{{ end }}
```

## Tentukan templat
<a name="v10-go-define"></a>

Anda dapat menentukan template yang dapat digunakan dalam template lain, menggunakan `define` dan nama template dalam tanda kutip ganda. Anda tidak boleh mendefinisikan template dengan nama yang sama dengan template lain, termasuk template default seperti`__subject`,`__text_values_list`,`__text_alert_list`, `default.title` dan`default.message`. Jika templat telah dibuat dengan nama yang sama dengan templat default, atau templat di templat notifikasi lain, Grafana mungkin menggunakan salah satu templat. Grafana tidak mencegah, atau menampilkan pesan kesalahan, ketika ada dua atau lebih templat dengan nama yang sama.

```
{{ define "print_labels" }}
{{ end }}
```

## Jalankan template
<a name="v10-go-execute"></a>

Anda dapat mengeksekusi template yang ditentukan dalam template Anda menggunakan`template`, nama template dalam tanda kutip ganda, dan kursor yang harus diteruskan ke template:

```
{{ template "print_labels" . }}
```

## Meneruskan data ke template
<a name="v10-go-passdata"></a>

Dalam titik template mengacu pada nilai yang diteruskan ke template.

Misalnya, jika templat dilewatkan daftar peringatan penembakan maka dot mengacu pada daftar peringatan penembakan tersebut:

```
{{ template "print_alerts" .Alerts }}
```

Jika templat dilewatkan label yang diurutkan untuk peringatan maka dot mengacu pada daftar label yang diurutkan:

```
{{ template "print_labels" .SortedLabels }}
```

Ini berguna saat menulis templat yang dapat digunakan kembali. Misalnya, untuk mencetak semua peringatan, Anda dapat menulis yang berikut ini:

```
{{ template "print_alerts" .Alerts }}
```

Kemudian untuk mencetak hanya peringatan penembakan Anda dapat menulis ini:

```
{{ template "print_alerts" .Alerts.Firing }}
```

Ini berfungsi karena keduanya `.Alerts` dan `.Alerts.Firing` merupakan daftar peringatan.

```
{{ define "print_alerts" }}
{{ range . }}
{{ template "print_labels" .SortedLabels }}
{{ end }}
{{ end }}
```

## Komentar
<a name="v10-go-comments"></a>

Anda dapat menambahkan komentar dengan `{{/*` dan`*/}}`:

```
{{/* This is a comment */}}
```

Untuk mencegah komentar menambahkan jeda baris gunakan:

```
{{- /* This is a comment with no leading or trailing line breaks */ -}}
```

## Lekukan
<a name="v10-go-indentation"></a>

Anda dapat menggunakan lekukan, baik tab maupun spasi, dan jeda baris, untuk membuat templat lebih mudah dibaca:

```
{{ range .Alerts }}
  {{ range .Labels.SortedPairs }}
    {{ .Name }} = {{ .Value }}
  {{ end }}
{{ end }}
```

Namun, lekukan dalam template juga akan ada dalam teks. Selanjutnya kita akan melihat cara menghapusnya.

## Hapus spasi dan jeda baris
<a name="v10-go-removespace"></a>

 text/template Digunakan `{{-` dan `-}}` untuk menghapus spasi depan dan trailing dan jeda garis.

Misalnya, saat menggunakan lekukan dan jeda baris untuk membuat templat lebih mudah dibaca:

```
{{ range .Alerts }}
  {{ range .Labels.SortedPairs }}
    {{ .Name }} = {{ .Value }}
  {{ end }}
{{ end }}
```

Lekukan dan jeda baris juga akan ada dalam teks:

```
    alertname = "Test"

    grafana_folder = "Test alerts"
```

Anda dapat menghapus lekukan dan jeda baris dari teks yang berubah `}}` menjadi `-}}` di awal setiap rentang:

```
{{ range .Alerts -}}
  {{ range .Labels.SortedPairs -}}
    {{ .Name }} = {{ .Value }}
  {{ end }}
{{ end }}
```

Indentasi dan jeda baris dalam template sekarang tidak ada dari teks:

```
alertname = "Test"
grafana_folder = "Test alerts"
```

# Buat templat notifikasi
<a name="v10-alerting-create-templates"></a>

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

Buat templat notifikasi yang dapat digunakan kembali untuk dikirim ke titik kontak Anda.

Anda dapat menambahkan satu atau beberapa templat ke templat notifikasi Anda.

Nama template notifikasi Anda harus unik. Anda tidak dapat memiliki dua templat dengan nama yang sama di templat notifikasi yang sama atau di templat notifikasi yang berbeda. Hindari mendefinisikan template dengan nama yang sama dengan template default, seperti:`__subject`,, `__text_values_list``__text_alert_list`, `default.title` dan`default.message`.

Di tab Titik kontak, Anda dapat melihat daftar templat notifikasi Anda.

## Membuat template notifikasi
<a name="v10-alerting-creating-templates"></a>

**Untuk membuat template notifikasi**

1. Pilih **Peringatan, Titik** **kontak**.

1. Pilih tab **Template Pemberitahuan**, lalu **\$1 Tambahkan templat notifikasi**.

1. Pilih nama untuk template notifikasi, seperti`email.subject`.

1. Tulis konten template di bidang konten.

   Contoh:

   ```
   {{ if .Alerts.Firing -}}
      {{ len .Alerts.Firing }} firing alerts
      {{ end }}
      {{ if .Alerts.Resolved -}}
      {{ len .Alerts.Resolved }} resolved alerts
      {{ end }}
   ```

1. Simpan perubahan Anda.

   `{{ define "email.subject" }}`(di `email.subject` mana nama template Anda) dan `{{ end }}` secara otomatis ditambahkan ke awal dan akhir konten.

**Untuk membuat template notifikasi yang berisi lebih dari satu template**

1. Pilih **Peringatan, Titik** **kontak**.

1. Pilih tab **Template Pemberitahuan**, lalu **\$1 Tambahkan templat notifikasi**.

1. Masukkan nama untuk template notifikasi keseluruhan. Misalnya, `email`.

1. Tulis setiap templat di bidang Konten, termasuk `{{ define "name-of-template" }}` dan `{{ end }}` di awal dan akhir setiap templat. Anda dapat menggunakan nama deskriptif untuk setiap templat di templat notifikasi, misalnya, `email.subject` atau`email.message`. Dalam hal ini, jangan gunakan kembali nama template notifikasi yang Anda masukkan di atas.

   Bagian selanjutnya menunjukkan contoh rinci untuk template yang mungkin Anda buat.

1. Klik Simpan.

## Templat pemberitahuan pratinjau
<a name="v10-alerting-preview-templates"></a>

Pratinjau bagaimana template notifikasi Anda akan terlihat sebelum menggunakannya di titik kontak Anda, membantu Anda memahami hasil template yang Anda buat serta memberi Anda kesempatan untuk memperbaiki kesalahan sebelum menyimpan template.

**catatan**  
Pratinjau notifikasi hanya tersedia untuk Grafana Alertmanager.

**Untuk melihat pratinjau templat notifikasi**

1. Pilih **Peringatan, Titik** **kontak**.

1. Pilih tab **Template Pemberitahuan**, lalu **\$1 Tambahkan templat notifikasi**, atau edit templat yang ada.

1. Tambahkan atau perbarui konten template Anda.

   Data default disediakan dan Anda dapat menambahkan atau mengedit data peringatan ke dalamnya serta instance peringatan. Anda dapat menambahkan data peringatan langsung di jendela data Payload itu sendiri, atau klik **Pilih instance peringatan** atau **Tambahkan peringatan khusus**.

1. [Opsional] Untuk menambahkan data peringatan dari instance peringatan yang ada:

   1. Pilih **Pilih instans peringatan**.

   1. Arahkan kursor ke instance peringatan untuk melihat informasi selengkapnya tentang setiap instance peringatan/

   1. Pilih **Konfirmasi** untuk menambahkan instance peringatan ke payload.

1. [Opsional] Untuk menambahkan data peringatan menggunakan editor data Peringatan, pilih **Tambahkan data khusus**:

   1. Tambahkan anotasi, label khusus, atau atur dasbor atau panel.

   1. Alihkan Penembakan atau diselesaikan, tergantung pada apakah Anda ingin menambahkan peringatan yang diaktifkan atau diselesaikan ke notifikasi Anda.

   1. Pilih **Tambahkan data peringatan**.

   1. Pilih **Refresh preview** untuk melihat seperti apa konten template Anda nantinya dan data payload yang sesuai.

   Jika ada kesalahan dalam template Anda, mereka ditampilkan di Pratinjau dan Anda dapat memperbaikinya sebelum menyimpan.

1. Simpan perubahan Anda.

## Membuat template untuk subjek pesan
<a name="v10-alerting-create-template-subject"></a>

Buat templat untuk subjek email yang berisi jumlah peringatan yang ditembakkan dan diselesaikan, seperti dalam contoh ini:

```
1 firing alerts, 0 resolved alerts
```

**Untuk membuat template untuk subjek email**

1. Buat template yang disebut `email.subject` dengan konten berikut:

   ```
   {{ define "email.subject" }}
   {{ len .Alerts.Firing }} firing alerts, {{ len .Alerts.Resolved }} resolved alerts
   {{ end }}
   ```

1. Gunakan template saat membuat integrasi titik kontak Anda dengan memasukkannya ke bidang **Subjek** dengan `template` kata kunci.

   ```
   {{ template "email.subject" . }}
   ```

## Membuat template untuk pesan email
<a name="v10-alerting-create-template-message"></a>

Buat templat untuk pesan email yang berisi ringkasan semua peringatan yang diaktifkan dan diselesaikan, seperti dalam contoh ini:

```
There are 2 firing alerts, and 1 resolved alerts

Firing alerts:

- alertname=Test 1 grafana_folder=GrafanaCloud has value(s) B=1
- alertname=Test 2 grafana_folder=GrafanaCloud has value(s) B=2

Resolved alerts:

- alertname=Test 3 grafana_folder=GrafanaCloud has value(s) B=0
```

**Untuk membuat template untuk pesan email**

1. Buat template notifikasi yang disebut `email` dengan dua templat dalam konten: `email.message_alert` dan`email.message`.

   `email.message_alert`Template digunakan untuk mencetak label dan nilai untuk setiap peringatan yang diaktifkan dan diselesaikan sementara `email.message` template berisi struktur email.

   ```
   {{- define "email.message_alert" -}}
   {{- range .Labels.SortedPairs }}{{ .Name }}={{ .Value }} {{ end }} has value(s)
   {{- range $k, $v := .Values }} {{ $k }}={{ $v }}{{ end }}
   {{- end -}}
   
   {{ define "email.message" }}
   There are {{ len .Alerts.Firing }} firing alerts, and {{ len .Alerts.Resolved }} resolved alerts
   
   {{ if .Alerts.Firing -}}
   Firing alerts:
   {{- range .Alerts.Firing }}
   - {{ template "email.message_alert" . }}
   {{- end }}
   {{- end }}
   
   {{ if .Alerts.Resolved -}}
   Resolved alerts:
   {{- range .Alerts.Resolved }}
   - {{ template "email.message_alert" . }}
   {{- end }}
   {{- end }}
   
   {{ end }}
   ```

1. Gunakan template saat membuat integrasi titik kontak Anda dengan memasukkannya ke dalam bidang **Text Body** dengan `template` kata kunci.

   ```
   {{ template "email.message" . }}
   ```

## Membuat template untuk judul pesan Slack
<a name="v10-alerting-create-template-slack-title"></a>

Buat template untuk judul pesan Slack yang berisi jumlah peringatan yang diaktifkan dan diselesaikan, seperti pada contoh berikut:

```
1 firing alerts, 0 resolved alerts
```

**Untuk membuat template untuk judul pesan Slack**

1. Buat template yang disebut `slack.title` dengan konten berikut:

   ```
   {{ define "slack.title" }}
   {{ len .Alerts.Firing }} firing alerts, {{ len .Alerts.Resolved }} resolved alerts
   {{ end }}
   ```

1. Jalankan template dari bidang judul dalam integrasi titik kontak Anda.

   ```
   {{ template "slack.title" . }}
   ```

## Membuat template untuk konten pesan Slack
<a name="v10-alerting-create-template-slack-message"></a>

Buat template untuk konten pesan Slack yang berisi deskripsi semua peringatan yang diaktifkan dan diselesaikan, termasuk label, anotasi, dan URL Dasbor.

**catatan**  
Template ini hanya untuk peringatan terkelola Grafana. Untuk menggunakan template untuk lansiran terkelola sumber data, hapus referensi ke DashboardURL dan SilenceUrl. [Untuk informasi selengkapnya tentang mengonfigurasi notifikasi Prometheus, lihat dokumentasi Prometheus tentang notifikasi.](https://prometheus.io/docs/alerting/latest/notifications/)

```
1 firing alerts:

[firing] Test1
Labels:
- alertname: Test1
- grafana_folder: GrafanaCloud
Annotations:
- description: This is a test alert
Go to dashboard: https://example.com/d/dlhdLqF4z?orgId=1

1 resolved alerts:

[firing] Test2
Labels:
- alertname: Test2
- grafana_folder: GrafanaCloud
Annotations:
- description: This is another test alert
Go to dashboard: https://example.com/d/dlhdLqF4z?orgId=1
```

**Untuk membuat template untuk konten pesan Slack**

1. Buat template yang disebut `slack` dengan dua template dalam konten: `slack.print_alert` dan`slack.message`.

   `slack.print_alert`Template digunakan untuk mencetak label, anotasi, dan dasbordURL sementara `slack.message` template berisi struktur notifikasi.

   ```
   {{ define "slack.print_alert" -}}
   [{{.Status}}] {{ .Labels.alertname }}
   Labels:
   {{ range .Labels.SortedPairs -}}
   - {{ .Name }}: {{ .Value }}
   {{ end -}}
   {{ if .Annotations -}}
   Annotations:
   {{ range .Annotations.SortedPairs -}}
   - {{ .Name }}: {{ .Value }}
   {{ end -}}
   {{ end -}}
   {{ if .DashboardURL -}}
     Go to dashboard: {{ .DashboardURL }}
   {{- end }}
   {{- end }}
   
   {{ define "slack.message" -}}
   {{ if .Alerts.Firing -}}
   {{ len .Alerts.Firing }} firing alerts:
   {{ range .Alerts.Firing }}
   {{ template "slack.print_alert" . }}
   {{ end -}}
   {{ end }}
   {{ if .Alerts.Resolved -}}
   {{ len .Alerts.Resolved }} resolved alerts:
   {{ range .Alerts.Resolved }}
   {{ template "slack.print_alert" .}}
   {{ end -}}
   {{ end }}
   {{- end }}
   ```

1. Jalankan template dari bidang isi teks dalam integrasi titik kontak Anda:

   ```
   {{ template "slack.message" . }}
   ```

## Template email dan Slack dengan template bersama
<a name="v10-alerting-create-shared-templates"></a>

Alih-alih membuat template notifikasi terpisah untuk setiap titik kontak, seperti email dan Slack, Anda dapat berbagi template yang sama.

Misalnya, jika Anda ingin mengirim email dengan subjek ini dan pesan Slack dengan judul ini`1 firing alerts, 0 resolved alerts`, Anda dapat membuat templat bersama.

**Untuk membuat template bersama**

1. Buat template yang disebut `common.subject_title` dengan konten berikut:

   ```
   {{ define "common.subject_title" }}
   {{ len .Alerts.Firing }} firing alerts, {{ len .Alerts.Resolved }} resolved alerts
   {{ end }}
   ```

1. Untuk email, jalankan template dari bidang subjek dalam integrasi titik kontak email Anda:

   ```
   {{ template "common.subject_title" . }}
   ```

1. Untuk Slack, jalankan template dari bidang judul di integrasi titik kontak Slack Anda:

   ```
   {{ template "common.subject_title" . }}
   ```

## Menggunakan template notifikasi
<a name="v10-alerting-use-notification-templates"></a>

Gunakan templat di titik kontak untuk menyesuaikan notifikasi Anda.

**Untuk menggunakan template saat membuat titik kontak**

1. Dari menu **Peringatan**, pilih tab **Titik kontak** untuk melihat daftar titik kontak yang ada.

1. Pilih **Baru**. Sebagai alternatif, Anda dapat mengedit titik kontak yang ada dengan memilih ikon **Edit**.

1. Masukkan templat yang ingin Anda gunakan di bidang, seperti **Pesan** atau **Subjek**. Untuk memasukkan templat, gunakan formulir`{{ template "template_name" . }}`, ganti *template\$1name* dengan nama templat yang ingin Anda gunakan.

1. Pilih **Simpan titik kontak**.

# Referensi templat
<a name="v10-alerting-template-reference"></a>

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

Bagian ini memberikan informasi referensi untuk membuat template Anda.

**Peringatan (tipe)**

Jenis peringatan berisi data berikut.


| Nama | Jenis | Deskripsi | Contoh | 
| --- | --- | --- | --- | 
|  Status  |  string  |  `firing` atau `resolved`.  | \$1\$1 .Status \$1\$1 | 
|  Label  |  KeyValue  |  Satu set label yang dilampirkan pada peringatan.  | \$1\$1 .Labels \$1\$1 | 
|  Anotasi  |  KeyValue  |  Satu set anotasi yang dilampirkan pada peringatan.  | \$1\$1 .Annotations \$1\$1 | 
| Nilai | KeyValue | Nilai dari semua ekspresi, termasuk Kondisi Klasik | \$1\$1 .Values \$1\$1 | 
|  StartsAt  |  waktu.waktu  |  Waktu peringatan mulai menembak.  | \$1\$1 .StartsAt \$1\$1 | 
|  EndsAt  |  waktu.waktu  |  Hanya atur jika waktu akhir peringatan diketahui. Jika tidak, atur ke periode batas waktu yang dapat dikonfigurasi sejak peringatan terakhir diterima.  | \$1\$1 .EndsAt \$1\$1 | 
|  GeneratorURL  |  string  |  Tautan balik ke Grafana atau Alertmanager eksternal.  | \$1\$1 .GeneratorURL \$1\$1 | 
|  SilenceUrl  |  string  |  Tautan untuk membungkam peringatan (dengan label untuk peringatan ini telah diisi sebelumnya). Hanya untuk peringatan terkelola Grafana.  | \$1\$1 .SilenceURL\$1\$1 | 
|  DashboardURL  |  string  |  Tautkan ke dasbor grafana, jika aturan peringatan milik salah satunya. Hanya untuk peringatan terkelola Grafana.  | \$1\$1 .DashboardURL \$1\$1 | 
|  PanelURL  |  string  |  Tautkan ke panel dasbor grafana, jika aturan peringatan milik salah satunya. Hanya untuk peringatan terkelola Grafana.  | \$1\$1 .PanelURL \$1\$1 | 
|  Sidik jari  |  string  |  Sidik jari yang dapat digunakan untuk mengidentifikasi peringatan.  | \$1\$1 .Fingerprint \$1\$1 | 
|  ValueString  |  string  |  String yang berisi label dan nilai setiap ekspresi yang dikurangi dalam peringatan.  | \$1\$1 .ValueString \$1\$1 | 

 **ExtendedData**

 ExtendedData Objek berisi properti berikut.


| Nama | Jenis | Deskripsi | Contoh | 
| --- | --- | --- | --- | 
|  Penerima  |  `string`  |  Nama titik kontak yang mengirimkan notifikasi.  |  `{{ .Receiver }}`  | 
|  Status  |  `string`  |  Statusnya adalah `firing` jika setidaknya satu peringatan ditembakkan, jika tidak`resolved`.  |  `{{ .Status }}`  | 
|  Pemberitahuan  |  `[]Alert`  |  Daftar semua peringatan yang ditembakkan dan diselesaikan dalam pemberitahuan ini.  |  `There are {{ len .Alerts }} alerts`  | 
|  Peringatan penembakan  |  `[]Alert`  |  Daftar semua peringatan penembakan dalam pemberitahuan ini.  |  `There are {{ len .Alerts.Firing }} firing alerts`  | 
|  Peringatan terselesaikan  |  `[]Alert`  |  Daftar semua peringatan yang diselesaikan dalam pemberitahuan ini.  |  `There are {{ len .Alerts.Resolved }} resolved alerts`  | 
|  GroupLabels  |  `KeyValue`  |  Label yang mengelompokkan peringatan ini termasuk pemberitahuannya.  |  `{{ .GroupLabels }}`  | 
|  CommonLabels  |  `KeyValue`  |  Label yang umum untuk semua peringatan dalam notifikasi ini.  |  `{{ .CommonLabels }}`  | 
|  CommonAnnotations  |  `KeyValue`  |  Anotasi umum untuk semua peringatan dalam pemberitahuan ini.  |  `{{ .CommonAnnotations }}`  | 
|  URL eksternal  |  `string`  |  Tautan ke ruang kerja Grafana atau Alertmanager yang mengirimkan pemberitahuan ini.  |  `{{ .ExternalURL }}`  | 

**KeyValue jenis**

`KeyValue`Tipe adalah satu set pasangan key/value string yang mewakili label dan anotasi.

Selain akses langsung dari data yang disimpan sebagai a`KeyValue`, ada juga metode untuk menyortir, menghapus, dan mengubah data.


| Nama | Pendapat | Pengembalian | Catatan | Contoh | 
| --- | --- | --- | --- | --- | 
|  SortedPairs  |    |  Daftar yang diurutkan dari pasangan string kunci dan nilai  |    | `{{ .Annotations.SortedPairs }}` | 
|  Menghapus  |  [] string  |  KeyValue  |  Mengembalikan salinan Key/Value peta tanpa kunci yang diberikan.  | `{{ .Annotations.Remove "summary" }}` | 
|  Nama  |    |  [] string  |  Daftar nama  | `{{ .Names }}` | 
|  Nilai  |    |  [] string  |  Daftar nilai  | `{{ .Values }}` | 

**Waktu**

Waktu dari [https://pkg.go.dev/time#Time](https://pkg.go.dev/time#Time)paket Go. Anda dapat mencetak waktu dalam sejumlah format berbeda. Misalnya, untuk mencetak waktu peringatan diaktifkan dalam format`Monday, 1st January 2022 at 10:00AM`, Anda menulis template berikut:

```
{{ .StartsAt.Format "Monday, 2 January 2006 at 3:04PM" }}
```

Anda dapat menemukan referensi untuk format waktu Go [di sini](https://pkg.go.dev/time#pkg-constants).

# Kelola titik kontak
<a name="v10-alerting-manage-contactpoints"></a>

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

Tampilan daftar **titik Kontak** mencantumkan semua titik kontak dan templat notifikasi yang ada.

Pada tab **Titik kontak**, Anda dapat:
+ Cari nama dan jenis titik kontak dan integrasi.
+ Lihat semua titik kontak dan integrasi yang ada.
+ Lihat berapa banyak kebijakan notifikasi yang digunakan untuk setiap titik kontak, dan arahkan langsung ke kebijakan notifikasi yang ditautkan.
+ Lihat status pengiriman notifikasi.
+ Ekspor titik kontak individu atau semua titik kontak dalam format JSON, YAMAL, atau Terraform.
+ Hapus titik kontak yang tidak digunakan oleh kebijakan notifikasi.

Pada tab **Template notifikasi**, Anda dapat:
+ Lihat, edit, salin, atau hapus templat notifikasi yang ada.

# Membungkam pemberitahuan peringatan
<a name="v10-alerting-silences"></a>

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

Anda dapat menekan pemberitahuan peringatan dengan *diam*. Keheningan hanya menghentikan pemberitahuan agar tidak dibuat: Keheningan tidak mencegah aturan peringatan dievaluasi, dan mereka tidak menghentikan peringatan instance agar tidak ditampilkan di antarmuka pengguna. Saat Anda membungkam peringatan, Anda menentukan jendela waktu untuk ditekan.

**catatan**  
Untuk menekan pemberitahuan peringatan pada interval waktu reguler, misalnya, selama periode pemeliharaan rutin, gunakan [Bisukan waktu](v10-alerting-manage-muting.md) bukan diam.

**Untuk menambahkan keheningan**

1. **Dari konsol Grafana Anda, di menu Grafana, pilih Peringatan.**

1. Pilih **Silences.**

1. Pilih Alertmanager dari dropdown **Alertmanager**.

1. Pilih **Buat Keheningan**.

1. Pilih tanggal mulai dan berakhir di **Silence start and end** untuk menunjukkan kapan keheningan akan berlaku dan kapan harus berakhir.

1. Sebagai alternatif untuk mengatur waktu akhir, di **Durasi**, tentukan berapa lama keheningan diberlakukan. Ini secara otomatis memperbarui waktu akhir di bidang **Mulai dan Akhir Diam**.

1. Di bidang **Label** dan **Nilai**, masukkan satu atau beberapa *Label Pencocokan*. Matcher menentukan aturan mana yang berlaku untuk keheningan. Setiap peringatan yang cocok (dalam status aktif), akan ditampilkan di bidang Instance **lansiran yang terpengaruh**.

1. Secara opsional, tambahkan **Komentar** yang menjelaskan keheningan.

1. Pilih **Kirim**.

**Untuk mengedit keheningan**

1. **Dari konsol Grafana Anda, di menu Grafana, pilih Peringatan.**

1. Pilih **Silences** untuk melihat daftar keheningan yang ada.

1. Temukan keheningan yang ingin Anda edit, lalu pilih **Edit** (ikon pena).

1. Buat perubahan yang diinginkan, lalu pilih **Kirim** untuk menyimpan perubahan Anda.

Anda dapat mengedit keheningan yang ada dengan memilih ikon **Edit** (pena).

**Untuk membuat tautan URL ke formulir diam**

Saat menautkan ke formulir diam, berikan label pencocokan default dan komentar melalui `matcher` dan parameter `comment` kueri. `matcher`Parameter harus dalam format berikut di `[label][operator][value]` mana `operator` parameter dapat berupa salah satu dari yang berikut: `=` (sama, bukan regex), (tidak sama, bukan regex), `!=` (sama, regex), `=~` (tidak sama, regex). `!~` URL dapat berisi banyak parameter kueri dengan kunci`matcher`. Misalnya, untuk menautkan ke formulir diam dengan label `severity=critical` & `cluster!~europe-.*` komentar yang cocok`Silence critical EU alerts`, buat URL`https://mygrafana/alerting/silence/new?matcher=severity%3Dcritical&matcher=cluster!~europe-*&comment=Silence%20critical%20EU%20alert`.

Untuk menautkan ke halaman diam baru untuk Alertmanager eksternal, tambahkan parameter kueri `alertmanager`

**Untuk menghilangkan keheningan**

1. **Dari konsol Grafana Anda, di menu Grafana, pilih Peringatan.**

1. Pilih **Silences** untuk melihat daftar keheningan yang ada.

1. Pilih keheningan yang ingin Anda akhiri, dan pilih **Unsilence**. Ini mengakhiri penindasan peringatan.
**catatan**  
Unsilencing mengakhiri penindasan peringatan, seolah-olah waktu akhir ditetapkan untuk waktu saat ini. Keheningan yang telah berakhir (secara otomatis atau manual) dipertahankan dan terdaftar selama lima hari. Anda tidak dapat menghapus keheningan dari daftar secara manual.

# Lihat dan filter aturan peringatan
<a name="v10-alerting-manage-rules-viewfilter"></a>

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

Halaman **Peringatan mencantumkan** aturan peringatan. Secara default, aturan dikelompokkan berdasarkan jenis sumber data. Bagian **Grafana mencantumkan** aturan yang dikelola oleh Grafana. Aturan peringatan untuk sumber data yang kompatibel dengan Prometheus juga tercantum di sini. Anda dapat melihat aturan peringatan untuk sumber data yang kompatibel dengan Prometheus tetapi Anda tidak dapat mengeditnya.

Bagian Mimir/Cortex/Loki aturan mencantumkan semua aturan untuk sumber data Mimir, Cortex, atau Loki. Aturan peringatan cloud juga tercantum di bagian ini.

Saat mengelola volume peringatan yang besar, Anda dapat menggunakan kemampuan pencarian aturan peringatan yang diperluas untuk memfilter folder, grup evaluasi, dan aturan. Selain itu, Anda dapat memfilter aturan peringatan berdasarkan propertinya seperti label, status, jenis, dan kesehatan.

## Lihat aturan peringatan
<a name="v10-alerting-manage-rules-view"></a>

Menggunakan peringatan Grafana, Anda dapat melihat semua peringatan Anda dalam satu halaman.

**Untuk melihat detail peringatan**

1. **Dari konsol Grafana Anda, di menu Grafana, pilih **Peringatan, Aturan Peringatan**.** Secara default, tampilan daftar ditampilkan.

1. Di **View as**, Anda dapat beralih antara tampilan Dikelompokkan, Daftar, dan Status dengan memilih opsi yang Anda inginkan.

1. Perluas baris aturan untuk melihat label aturan, anotasi, sumber data, kueri aturan, dan daftar instance peringatan yang dihasilkan dari aturan.

Dari halaman ini, Anda juga dapat membuat salinan aturan peringatan untuk membantu Anda menggunakan kembali aturan yang ada.

## Aturan peringatan ekspor
<a name="v10-alerting-manage-rules-export"></a>

Anda dapat mengekspor aturan ke YAMAL atau JSON di ruang kerja Grafana.
+ Pilih ikon **grup aturan Ekspor** di samping setiap grup aturan peringatan untuk diekspor ke YAMG, JSON, atau Terraform.
+ Pilih **Ekspor aturan** untuk mengekspor semua aturan peringatan terkelola Grafana ke YAMG, JSON, atau Terraform.
+ Pilih **Lainnya**, **Ubah ekspor** di samping setiap aturan peringatan individu dalam grup untuk mengedit aturan peringatan yang disediakan dan mengekspor versi yang dimodifikasi.

## Lihat definisi kueri untuk peringatan yang disediakan
<a name="v10-alerting-manage-rules-querydef"></a>

Lihat definisi kueri hanya-baca untuk peringatan yang disediakan. Periksa dengan cepat apakah kueri aturan peringatan Anda benar, tanpa menyelam ke repositori “as-code” Anda untuk definisi aturan.

**Tampilan yang dikelompokkan**

Tampilan yang dikelompokkan menunjukkan aturan peringatan Grafana yang dikelompokkan berdasarkan folder dan aturan peringatan Loki atau Prometheus yang dikelompokkan berdasarkan \$1. `namespace` `group` Ini adalah tampilan daftar aturan default, yang ditujukan untuk mengelola aturan. Anda dapat memperluas setiap grup untuk melihat daftar aturan dalam grup ini. Perluas aturan lebih lanjut untuk melihat detailnya. Anda juga dapat memperluas tombol tindakan dan peringatan yang dihasilkan dari aturan untuk melihat detailnya.

**Tampilan negara**

Tampilan status menunjukkan aturan peringatan yang dikelompokkan berdasarkan negara bagian. Gunakan tampilan ini untuk mendapatkan gambaran umum tentang aturan mana yang berada dalam keadaan apa. Setiap aturan dapat diperluas untuk melihat detailnya. Tombol tindakan dan peringatan apa pun yang dihasilkan oleh aturan ini, dan setiap peringatan dapat diperluas lebih lanjut untuk melihat detailnya.

## Memfilter aturan peringatan
<a name="v10-alerting-manage-rules-filter"></a>

Anda dapat memfilter aturan peringatan yang muncul di halaman **Peringatan dengan** beberapa cara.

**Untuk memfilter aturan peringatan**

1. Dari **Pilih sumber data**, pilih sumber data.. Anda dapat melihat aturan peringatan yang menanyakan sumber data yang dipilih.

1. Di **Cari berdasarkan label**, masukkan kriteria pencarian menggunakan pemilih label. Misalnya, `environment=production;region=~US|EU,severity!=warning`.

1. Dari **Filter peringatan menurut negara**, pilih status peringatan yang ingin Anda lihat. Anda dapat melihat aturan peringatan yang cocok dengan status itu. Aturan yang cocok dengan negara bagian lain disembunyikan.

# Bisukan waktu
<a name="v10-alerting-manage-muting"></a>

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

Waktu bisu adalah interval waktu berulang ketika tidak ada pemberitahuan baru untuk kebijakan yang dibuat atau dikirim. Gunakan mereka untuk mencegah peringatan menembakkan periode tertentu dan berulang, misalnya, periode pemeliharaan rutin.

Mirip dengan diam, pengaturan waktu bisu tidak mencegah aturan peringatan dievaluasi, juga tidak menghentikan instance peringatan ditampilkan di antarmuka pengguna. Mereka hanya mencegah pemberitahuan dibuat.

Anda dapat mengonfigurasi pengaturan waktu bisu terkelola Grafana serta pengaturan waktu bisu untuk sumber data Alertmanager eksternal.

## Bisukan waktu vs Keheningan
<a name="v10-alerting-manage-muting-compare"></a>

Tabel berikut menyoroti perbedaan antara timing bisu dan keheningan.


| Bisukan waktu | Pembisuan | 
| --- | --- | 
| Menggunakan definisi interval waktu yang dapat terulang kembali. | Memiliki waktu mulai dan berakhir yang tetap. | 
| Dibuat dan kemudian ditambahkan ke kebijakan pemberitahuan. | Menggunakan label untuk mencocokkan dengan peringatan untuk menentukan apakah akan diam atau tidak. | 

## Menambahkan waktu bisu
<a name="v10-alerting-manage-muting-add"></a>

Anda dapat membuat pengaturan waktu bisu di ruang kerja Grafana Anda.

**Untuk menambahkan waktu bisu**

1. **Dari konsol Grafana Anda, di menu Grafana, pilih Peringatan.**

1. Pilih **Kebijakan pemberitahuan**, lalu pilih tab **Pengaturan Waktu Bisu**.

1. Dari dropdown **Alertmanager**, pilih Alertmanager yang ingin Anda edit.

1. Pilih tombol **\$1 Tambahkan waktu bisu**.

1. Isi formulir untuk membuat [interval waktu](#v10-alerting-manage-muting-interval) yang sesuai dengan waktu bisu Anda.

1. Simpan waktu bisu Anda.

## Menambahkan waktu bisu ke kebijakan notifikasi
<a name="v10-alerting-manage-muting-add-notif"></a>

Setelah Anda memiliki waktu bisu, Anda menggunakannya dengan menambahkannya ke kebijakan notifikasi yang ingin Anda bisukan secara berkala.

**Untuk menambahkan waktu bisu ke kebijakan notifikasi**

1. **Dari konsol Grafana Anda, di menu Grafana, pilih Peringatan.**

1. Pilih **Kebijakan pemberitahuan**, lalu pilih tab **Kebijakan Pemberitahuan**.

1. **Pilih kebijakan notifikasi yang ingin Anda tambahkan waktu bisu, dan pilih...** , **Sunting**.

1. Dari menu tarik-turun **Pengaturan waktu bisu**, pilih pengaturan waktu bisu yang ingin ditambahkan ke kebijakan.

1. Simpan perubahan Anda.

## Interval waktu
<a name="v10-alerting-manage-muting-interval"></a>

Interval waktu adalah durasi tertentu di mana peringatan ditekan. Durasi biasanya terdiri dari rentang waktu tertentu dan hari-hari dalam seminggu, bulan, atau tahun. 

Opsi interval waktu Support adalah:
+ **Rentang waktu** — Waktu termasuk waktu mulai dan eksklusif waktu akhir (di UTC, jika tidak ada lokasi yang dipilih, jika tidak ada waktu setempat.
+ **Lokasi** - Menetapkan lokasi untuk waktu—rentang waktu ditampilkan dalam waktu lokal untuk lokasi tersebut.
+ **Hari dalam seminggu** — Hari atau rentang hari dalam seminggu. Misalnya, `monday:thursday`.
+ **Hari dalam sebulan** — Tanggal dalam sebulan. Nilai dapat berkisar dari `1` -`31`. Nilai negatif menentukan hari dalam sebulan dalam urutan terbalik, jadi `-1` mewakili hari terakhir bulan itu.
+ **Bulan** — Bulan dalam setahun baik numerik nama bulan kalender lengkap. Misalnya, `1, may:august`.
+ **Tahun** — Tahun atau tahun untuk interval. Misalnya, `2023:2024`.

Masing-masing elemen ini dapat berupa daftar, dan setidaknya satu item dalam elemen harus dipenuhi untuk menjadi kecocokan. Bidang juga mendukung rentang, menggunakan`:`. Misalnya, `monday:thursday`.

Jika bidang dibiarkan kosong, setiap saat akan cocok dengan bidang. Untuk sekejap untuk mencocokkan interval waktu penuh, semua bidang harus cocok. Waktu bisu dapat berisi beberapa interval waktu.

Jika Anda ingin menentukan durasi yang tepat, tentukan semua opsi yang diperlukan untuk durasi tersebut. Misalnya, jika Anda ingin membuat interval waktu untuk Senin pertama setiap bulan, untuk bulan Maret, Juni, September, dan Desember, antara jam 12:00 dan 24:00 UTC, spesifikasi interval waktu Anda dapat berupa:
+ Rentang waktu:
  + Waktu mulai: `12:00`
  + Waktu akhir: `24:00`
+ Hari dalam seminggu: `monday`
+ Bulan: `3, 6, 9, 12`
+ Hari dalam sebulan: `1:7`

# Lihat keadaan dan kesehatan aturan peringatan
<a name="v10-alerting-manage-rulestate"></a>

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

Keadaan dan kesehatan aturan peringatan memberi Anda beberapa indikator status utama tentang peringatan Anda.

Ada tiga komponen:
+ [Status aturan peringatan](#v10-alerting-manage-rulestate-state)
+ [Status contoh peringatan](#v10-alerting-manage-rulestate-instance)
+ [Peringatan aturan kesehatan](#v10-alerting-manage-rulestate-health)

Meskipun terkait, setiap komponen menyampaikan informasi yang sedikit berbeda.

**Untuk melihat keadaan dan kesehatan aturan peringatan Anda**

1. **Dari konsol Grafana Anda, di menu Grafana, pilih Peringatan.**

1. Pilih **Aturan peringatan** untuk melihat daftar peringatan yang ada.

1. Pilih aturan peringatan untuk melihat keadaan dan kesehatannya.

## Status aturan peringatan
<a name="v10-alerting-manage-rulestate-state"></a>

Aturan peringatan dapat berada di salah satu negara bagian berikut:


| Status | Deskripsi | 
| --- | --- | 
| Normal | Tak satu pun dari deret waktu yang dikembalikan oleh mesin evaluasi dalam firing keadaan pending atau. | 
| Tertunda | Setidaknya satu seri waktu yang dikembalikan oleh mesin evaluasi adalahpending. | 
| Menembak | Setidaknya satu seri waktu yang dikembalikan oleh mesin evaluasi adalahfiring. | 

**catatan**  
Peringatan beralih pertama ke `pending` dan kemudian`firing`, sehingga dibutuhkan setidaknya dua siklus evaluasi sebelum peringatan diaktifkan.

## Status contoh peringatan
<a name="v10-alerting-manage-rulestate-instance"></a>

Instance peringatan dapat berada di salah satu status berikut:


| Status | Deskripsi | 
| --- | --- | 
| Normal | Keadaan peringatan yang bukan pending ataufiring. Semuanya bekerja seperti yang diharapkan. | 
| Tertunda | Status peringatan yang telah aktif kurang dari durasi ambang batas yang dikonfigurasi. | 
| Peringatan | Status peringatan yang telah aktif lebih lama dari durasi ambang batas yang dikonfigurasi. | 
| Tidak ada data | Tidak ada data yang diterima untuk jendela waktu yang dikonfigurasi. | 
| Peringatan | Terjadi kesalahan saat mencoba mengevaluasi aturan peringatan. | 

## Pertahankan status terakhir
<a name="v10-alerting-manage-rulestate-keepstate"></a>

Aturan peringatan dapat dikonfigurasi untuk mempertahankan status terakhir saat `Error` status `NoData` atau ditemui. Ini akan mencegah peringatan dari penembakan, dan dari penyelesaian dan penembakan kembali. Sama seperti evaluasi normal, aturan peringatan akan bertransisi dari `pending` ke `firing` setelah periode tertunda telah berlalu.

## Peringatan aturan kesehatan
<a name="v10-alerting-manage-rulestate-health"></a>

Aturan peringatan dapat memiliki salah satu status kesehatan berikut.


| Status | Deskripsi | 
| --- | --- | 
| Ok | Tidak ada kesalahan saat mengevaluasi aturan peringatan. | 
| Kesalahan | Terjadi kesalahan saat mengevaluasi aturan peringatan. | 
| NoData | Tidak adanya data dalam setidaknya satu deret waktu yang dikembalikan selama evaluasi aturan. | 
| \$1status\$1, KeepLast | Aturan akan menerima status lain, tetapi dikonfigurasi untuk mempertahankan status terakhir dari aturan peringatan. | 

## Peringatan khusus untuk NoData dan Kesalahan
<a name="v10-alerting-manage-rulestate-special"></a>

Saat evaluasi aturan peringatan menghasilkan status `NoData` atau`Error`, peringatan Grafana akan menghasilkan instance peringatan yang memiliki label tambahan berikut.


| Label | Deskripsi | 
| --- | --- | 
| nama peringatan | Entah DatasourceNoData atauDatasourceError, tergantung negara. | 
| datasource\$1uid | UID dari sumber data yang menyebabkan negara. | 

**catatan**  
Anda perlu mengatur tidak ada data atau penanganan kesalahan ke `NoData` atau `Error` dalam aturan peringatan, seperti yang dijelaskan dalam [Konfigurasikan aturan peringatan terkelola Grafana](v10-alerting-configure-grafanamanaged.md) topik, untuk menghasilkan label tambahan.

Anda dapat menangani peringatan ini dengan cara yang sama seperti peringatan biasa, termasuk menambahkan keheningan, perutean ke titik kontak, dan sebagainya.

# Lihat dan filter menurut grup peringatan
<a name="v10-alerting-manage-viewfiltergroups"></a>

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

Grup peringatan menampilkan peringatan yang dikelompokkan dari instance Alertmanager. Secara default, aturan peringatan dikelompokkan berdasarkan kunci label untuk kebijakan default dalam kebijakan notifikasi. Mengelompokkan aturan peringatan umum ke dalam satu grup peringatan mencegah aturan peringatan duplikat dipecat.

Anda dapat melihat grup peringatan dan juga memfilter aturan peringatan yang sesuai dengan kriteria tertentu.

**Untuk melihat grup peringatan**

1. **Dari konsol Grafana Anda, di menu Grafana, pilih Peringatan.**

1. Pilih **Grup** untuk melihat grup yang ada.

1. Dari tarik-turun **Alertmanager**, pilih Alertmanager eksternal sebagai sumber data Anda.

1. Dari **grup Kustom menurut** tarik-turun, pilih kombinasi label untuk melihat pengelompokan selain default. Ini berguna untuk men-debug dan memverifikasi pengelompokan kebijakan pemberitahuan Anda.

Jika peringatan tidak berisi label yang ditentukan baik dalam pengelompokan kebijakan root atau pengelompokan kustom, maka peringatan akan ditambahkan ke grup catch all dengan header. `No grouping`

Anda dapat memfilter peringatan berdasarkan label atau status peringatan.

**Untuk memfilter berdasarkan label**
+ Di **Penelusuran**, masukkan label yang ada untuk melihat peringatan yang cocok dengan label.

  Misalnya, `environment=production,region=~US|EU,severity!=warning`.

**Untuk memfilter menurut negara**
+ Di **Negara Bagian**, pilih dari Status Aktif, Ditekan, atau Tidak Diproses untuk melihat peringatan yang cocok dengan status yang Anda pilih. Semua peringatan lainnya disembunyikan.

# Lihat kesalahan pemberitahuan
<a name="v10-alerting-manage-viewnotificationerrors"></a>

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

Lihat kesalahan pemberitahuan dan pahami mengapa kesalahan tersebut gagal dikirim atau tidak diterima.

**catatan**  
Fitur ini hanya didukung untuk Grafana Alertmanager.

**Untuk melihat kesalahan pemberitahuan**

1. Dari menu sebelah kiri, pilih **Alerting** lalu **Contact points**.

   Jika ada titik kontak yang gagal, pesan di sudut kanan ruang kerja memberi tahu Anda bahwa ada kesalahan, dan berapa banyak.

1. Pilih titik kontak untuk melihat rincian kesalahan untuk titik kontak tersebut.

   Detail kesalahan ditampilkan jika Anda mengarahkan kursor ke ikon Kesalahan.

   Jika titik kontak memiliki lebih dari satu integrasi, Anda melihat semua kesalahan untuk setiap integrasi yang terdaftar.

1. Di kolom Health, periksa status notifikasi.

   Ini bisa berupa OK, Tidak ada upaya, atau Kesalahan.