---
title: "Peringatan"
description: "Aturan ambang batas pada metrik panggilan Anda — dikirim ke email, Slack, atau webhook Anda saat sesuatu menyimpang."
---

Aturan peringatan memantau metrik panggilan organisasi Anda dan memberi tahu Anda ketika
ambang terlampaui — tingkat keberhasilan di bawah 80% selama hari terakhir,
lebih dari 500 panggilan dalam satu jam, regresi suite pengujian. Kelola aturan tersebut
di **Pengaturan → Organisasi → Peringatan**
(`/dashboard/organization?tab=alerts`). Mengelola aturan peringatan memerlukan
peran **admin** atau **owner**.

## Buat aturan

Klik **Buat aturan** dan isi:

| Bidang | Opsi |
| --- | --- |
| **Metrik** | Tingkat keberhasilan · Tingkat kegagalan · Skor rata-rata · Volume panggilan · Regresi suite |
| **Kondisi** | kurang dari · paling banyak · lebih dari · setidaknya |
| **Ambang** | Angka untuk dibandingkan |
| **Jendela (jam)** | Seberapa jauh ke belakang metrik dihitung — 1 hingga 720 jam |
| **Penerima email** | Dipisahkan dengan koma, hingga 10 alamat |
| **URL webhook masuk Slack** | Opsional — mengirim pesan peringatan ke sebuah channel |
| **Cooldown (menit)** | Waktu hening minimum antar pemicuan (default 60) |
| **Kirim ke webhook developer** | Kirim juga event `alert.triggered` ke endpoint webhook Anda |
| **Aktifkan aturan peringatan** | Aturan dapat disimpan dalam keadaan dinonaktifkan dan diaktifkan nanti |

Contoh: *"Tingkat keberhasilan **kurang dari** 80 selama 24 jam terakhir"*
dipicu ketika panggilan yang dinilai dalam jendela 24 jam sebelumnya turun di bawah
tingkat keberhasilan 80%.

<Note>
**Tingkat kegagalan menghitung lebih dari panggilan "Tidak berhasil".** Metrik
peringatan memperlakukan setiap panggilan yang tidak mencapai hasil berhasil — termasuk panggilan
tanpa percakapan sama sekali (langsung menutup panggilan, koneksi gagal) — sebagai
kegagalan. Kotak **Tidak berhasil** di dashboard hanya menghitung panggilan yang dinilai
`unsuccessful`. Oleh karena itu, peringatan tingkat kegagalan dapat dipicu bahkan ketika
kotak dashboard menunjukkan angka rendah; hal tersebut diharapkan, bukan ketidaksesuaian.
</Note>

## Cara pemicuan bekerja

Aturan dievaluasi terhadap jendela sebelumnya yang Anda konfigurasi. Ketika
kondisi terpenuhi, aturan dipicu **sekali** lalu tetap hening selama
periode cooldown-nya, meskipun metrik tetap melanggar ambang — sehingga satu jam
bermasalah menghasilkan satu notifikasi, bukan satu notifikasi untuk setiap evaluasi. Setiap pemicuan mencatat
nilai metrik, ambang, dan waktu.

## Channel pengiriman

Satu aturan dapat mengirim notifikasi ke ketiga channel sekaligus:

- **Email** — pesan kepada setiap penerima yang terdaftar yang mencantumkan aturan,
  metrik, nilai, ambang, dan jendela.
- **Slack** — pesan yang sama dikirim melalui URL webhook masuk Slack Anda.
- **Webhook developer** — event `alert.triggered` dikirimkan ke
  [endpoint webhook](/id/webhooks/overview) organisasi Anda, untuk menghubungkan
  peringatan ke PagerDuty, alat on-call, atau sistem Anda sendiri.

Kegagalan pada satu channel tidak pernah memblokir channel lainnya.

## Kelola aturan

Tab Peringatan mencantumkan setiap aturan beserta status aktif/nonaktifnya dan
waktu terakhir aturan tersebut dipicu. Aktifkan dan nonaktifkan aturan langsung di tempat, **Edit** untuk
mengubah bidang apa pun, atau hapus aturan yang tidak lagi Anda perlukan. Aktivitas peringatan
terbaru ditampilkan di sampingnya sehingga Anda dapat mengonfirmasi bahwa aturan benar-benar dipicu
sesuai harapan Anda.

## Langkah berikutnya

<CardGroup cols={2}>
  <Card title="Observabilitas" icon="chart-line" href="/id/guides/observability">
    Dashboard di balik metrik yang sama.
  </Card>
  <Card title="Webhook" icon="webhook" href="/id/webhooks/overview">
    Terima alert.triggered (dan setiap event lainnya) di sistem Anda sendiri.
  </Card>
</CardGroup>