Daftar Isi
Notifikasi email dan chat gampang terlewat saat insiden berlangsung. Untuk peringatan kritis, Echobell bisa mengubah notifikasi webhook Grafana menjadi panggilan telepon sungguhan, lengkap dengan dukungan eskalasi dan percobaan ulang. Panduan ini membahas penyiapannya secara lengkap.
Dokumentasi terkait:
- Apa itu Echobell → /docs/what-is-echobell
- Jenis notifikasi dan percobaan ulang → /docs/notification
- Ringkasan webhook → /docs/webhook
- Referensi integrasi Grafana → /docs/developer/grafana
Prasyarat
- Akun Echobell dengan saluran aktif dan URL webhook (lihat /docs/webhook)
- Akses admin ke instance Grafana Anda
- Setidaknya satu aturan peringatan yang sudah dikonfigurasi
Penyiapan
Langkah 1 — Buat contact point Webhook di Grafana
- Buka Alerting → Contact points
- Klik New contact point lalu pilih Webhook
- Beri nama yang mudah dikenali, misalnya "Echobell Phone Calls"
Langkah 2 — Tambahkan URL webhook Echobell Anda
Setel URL ke webhook saluran Anda:
https://hook.echobell.one/t/<channel-token>
Salin dari pengaturan saluran di Echobell (detailnya di /docs/webhook). Perlakukan sebagai rahasia dan ganti bila bocor.
Langkah 3 — Uji integrasinya
Klik Test di Grafana untuk mengirim peringatan contoh. Anda seharusnya menerima panggilan telepon Echobell dalam hitungan detik.
Langkah 4 — Pasang ke notification policy
- Buka Alerting → Notification policies
- Buat atau ubah policy yang menyasar peringatan kritis Anda
- Tambahkan contact point "Echobell Phone Calls"
Grafana kini akan mengarahkan peringatan yang cocok ke Echobell.
Praktik terbaik
- Sisakan panggilan telepon untuk peringatan berprioritas tinggi; pakai chat atau email untuk tingkat keparahan yang lebih rendah
- Atur percobaan ulang dan batas waktu di Echobell untuk menekan kelelahan peringatan (/docs/notification)
- Siapkan eskalasi ke rekan tim jika panggilan pertama tidak diangkat
- Gunakan jam tenang agar peringatan tidak mendesak tidak membangunkan Anda
- Bagikan saluran ke tim on-call Anda dan jaga daftar anggotanya tetap mutakhir
Opsi lanjutan
- Bagikan saluran ke rekan tim untuk cakupan yang lebih luas
- Sesuaikan isi suara per jenis peringatan memakai templat
- Atur jumlah percobaan ulang dan jalur eskalasi
- Tetapkan kontak cadangan demi ketahanan
Referensi lengkap: /docs/developer/grafana
Pemecahan masalah
- Tidak ada panggilan masuk: pastikan notification policy mengarah ke contact point Echobell Anda
- Webhook mengembalikan 4xx: periksa URL webhook secara persis dan pastikan salurannya aktif
- Terlalu banyak panggilan: persempit cakupan policy atau turunkan ambang tingkat keparahan peringatan
- Terlalu sedikit panggilan: naikkan tingkat keparahan atau tambahkan filter label agar peringatan kritis cocok dengan policy
Terkait
- Peringatan webhook untuk sistem khusus → /blog/get-notified-with-webhook-mcp
- Notifikasi kegagalan GitHub Actions → /blog/github-actions-notifications
- Dokumentasi developer Grafana → /docs/developer/grafana