Integrasi Upptime - Peringatan Pemantauan Uptime

Anda bisa meneruskan peristiwa gangguan dan pemulihan dari Upptime langsung ke Echobell, sehingga tim Anda menerima peringatan push peka waktu atau panggilan telepon tanpa perlu membangun alur terpisah. Panduan ini berfokus pada sisi Echobell dan memakai variabel notifikasi bawaan Upptime. Untuk opsi khusus Upptime, lihat dokumentasi notifikasi resminya.

Kenapa memakai Echobell untuk peringatan Upptime

Eskalasi lewat panggilan telepon untuk gangguan kritis, sementara pemeriksaan rutin tetap berupa push standar atau peka waktu
Templat dan variabel agar setiap peringatan menampilkan situs yang terdampak, status, kode respons, dan tautan issue GitHub
Tanpa infrastruktur tambahan—cukup satu URL webhook yang aman untuk tiap saluran Echobell

Prasyarat

Repositori Upptime yang sudah ada dengan GitHub Actions aktif
Izin untuk menambahkan secret repositori GitHub
Saluran Echobell yang punya URL webhook (di aplikasi, buka salurannya → salin URL webhook-nya)

Siapkan saluran Echobell

Buat atau buka sebuah saluran di Echobell lalu pilih gaya notifikasi yang Anda inginkan (standar, peka waktu, atau panggilan).
Salin URL webhook saluran tersebut; bentuknya seperti https://hook.echobell.one/t/<channel-token>.
(Opsional) Setel templat yang memakai variabel seperti {{site}}, {{status}}, {{code}}, {{url}}, dan {{issue}} agar peringatan Anda tetap terstruktur.

Tambahkan secret Upptime untuk Echobell

Di repositori Upptime Anda, buka Settings → Secrets and variables → Actions lalu tambahkan:

NOTIFICATION_CUSTOM_WEBHOOK=true
NOTIFICATION_CUSTOM_WEBHOOK_URL=https://hook.echobell.one/t/<channel-token>?site=$SITE_NAME&status=$STATUS&url=$SITE_URL&issue=$ISSUE_URL&code=$RESPONSE_CODE&emoji=$EMOJI
(Opsional) NOTIFICATIONS_DOWN_MESSAGE=$EMOJI $SITE_NAME is $STATUS ($RESPONSE_CODE) – $ISSUE_URL
(Opsional) NOTIFICATIONS_UP_MESSAGE=$EMOJI $SITE_NAME is back up – $SITE_URL

Catatan:

Parameter kueri membawa data terstruktur ke Echobell. Upptime menambahkan variabelnya, dan Echobell menyimpannya sebagai variabel templat (site, status, url, issue, code, emoji).
Pastikan URL tetap ter-encode (ganti spasi dengan %20 jika Anda menyesuaikan teksnya) agar permintaannya tidak rusak.
Penyedia atau strategi notifikasi lain tetap dikelola di Upptime—tambahkan hanya yang Anda perlukan untuk Echobell dan biarkan sisanya di antarmuka GitHub secrets.

Petakan variabel di Echobell

Gunakan templat yang ringkas agar peringatan tetap mudah dibaca:

Title: {{emoji}} Upptime: {{site}} is {{status}}
Body: Response {{code}} · {{url}}
External link: {{issue}}

Anda bisa mengubah gaya notifikasi saluran menjadi "Peka Waktu" atau "Panggilan" untuk situs berprioritas tinggi, sementara sisanya tetap sebagai push standar.

Uji integrasinya

Arahkan sementara salah satu URL yang dipantau ke endpoint yang tidak ada, atau hentikan sebuah layanan untuk memicu kegagalan.
Pastikan peringatannya sampai di Echobell dengan kolom templat Anda terisi.
Pulihkan layanannya lalu verifikasi pesan pemulihannya.

Pemecahan Masalah

Pastikan NOTIFICATION_CUSTOM_WEBHOOK dan NOTIFICATION_CUSTOM_WEBHOOK_URL dieja persis seperti pada daftar secret.
Jika Anda mengganti token saluran Echobell, perbarui juga secret-nya.
Untuk kegagalan di sisi Upptime atau penyedia tambahan, periksa dokumentasi resminya dan log GitHub Actions Anda.