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

# 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" . }}
   ```