Alert Sentry di ponsel Anda: push notification untuk error, tanpa kode

Sentry menangkap exception tepat saat terjadi. Lalu ia mengirim email kepada Anda, atau memposting ke channel Slack yang juga menerima pesan deploy, pengingat standup, dan ratusan hal lain. Jika error terjadi pukul 2 pagi atau saat Anda sedang tidak di depan laptop, Anda baru tahu ketika ada pengguna yang melaporkannya.
Alert Sentry bisa lebih baik dari itu, tetapi Sentry tidak punya aplikasi push sendiri untuk alert. Yang tersedia adalah webhook yang aktif ketika sebuah alert rule cocok. Arahkan webhook itu ke Pocket Alert, dan setiap alert akan menjadi push notification di ponsel Anda, lengkap dengan judul error, sumber masalah, dan tombol yang membuka issue-nya. Tanpa server, tanpa kode.
Yang Anda butuhkan
- Organisasi Sentry tempat Anda diizinkan membuat integration dan alert.
- Akun Pocket Alert dengan aplikasi terpasang di ponsel iPhone atau Android Anda. Paket gratis sudah mencakup satu webhook, dan itu cukup untuk pengaturan ini.
- Kunci API dari API Keys jika Anda ingin tombol "Open in Sentry" (dijelaskan di bawah).
Cara Sentry mengirim alert ke webhook
Sentry punya dua cara untuk mengirim POST alert ke sebuah URL, dan keduanya menghasilkan JSON yang berbeda:
- Internal integration (direkomendasikan oleh Sentry). Anda membuat integration privat dengan URL webhook, lalu mengaktifkan toggle Alert Action-nya. Integration ini kemudian muncul sebagai aksi di alert Anda. Alert issue tiba dengan header
Sentry-Hook-Resource: event_alertdan error berada di bawahdata.event; alert dari Metric Monitors tiba sebagaimetric_alertdengan judul siap pakai didata.description_title. - Webhooks (Legacy). Plugin per project di bawah pengaturan project. Cara ini masih berfungsi, tetapi halaman pengaturannya sendiri menyebutkan bahwa Sentry sangat menyarankan internal integration. Payload-nya datar:
project_name,culprit,level,url,triggering_rules, daneventmentah.
Panduan ini menggunakan internal integration dan menyediakan template untuk webhook legacy di bagian akhir.
Langkah 1: Buat webhook Pocket Alert
Pocket Alert memberi nama setiap push webhook dengan format Webhook <name>, jadi beri nama Sentry dan judul di layar kunci Anda akan terbaca "Webhook Sentry". Isi pesannya berasal dari template yang mengambil field dari JSON Sentry menggunakan placeholder %path%.
Cara tercepat adalah satu panggilan API, karena template tombol aksi hanya bisa diatur lewat API. Perintah ini membuat webhook dengan template pesan, level default, dan tombol "Open in Sentry", lalu menampilkan URL penerima:
jq -n \
--arg msg $'%data.event.title%%data.description_title%\n%data.event.culprit%%data.description_text%\nRule: %data.triggered_rule%' \
--arg act '[{"type":"view","label":"Open in Sentry","value":"%data.event.web_url%%data.web_url%"}]' \
'{name: "Sentry", message: $msg, default_level: 1, actions: $act}' |
curl -sS https://api.pocketalert.app/v1/webhooks \
-H "Token: YOUR_API_KEY" \
-H 'Content-Type: application/json' \
--data-binary @- |
jq -r '"Receive URL: https://p4a.me/wh/" + .url'
Template ini sengaja terlihat aneh. Satu integration Sentry memiliki satu URL webhook, dan alert issue maupun alert metrik sama-sama dikirim ke sana. Placeholder yang path-nya tidak ada di payload akan menjadi string kosong, sehingga %data.event.title%%data.description_title% menampilkan judul error untuk alert issue dan judul alert untuk alert metrik. Trik yang sama membuat tombol mendapat tautan yang benar di kedua kasus. Untuk alert issue, Rule: menampilkan nama alert; pada alert metrik, baris itu tetap kosong.
Jika Anda lebih suka klik, buat webhook di konsol pada Webhooks: beri nama Sentry, Default priority High, lalu tempelkan template pesan:
%data.event.title%%data.description_title%
%data.event.culprit%%data.description_text%
Rule: %data.triggered_rule%
Anda akan mendapatkan push yang sama, hanya tanpa tombol. Salin URL penerima yang ditampilkan konsol (https://p4a.me/wh/...).
Langkah 2: Buat internal integration di Sentry
- Di Sentry buka Settings > Developer Settings, buat integration baru, lalu pilih Internal Integration.
- Beri nama seperti "Pocket Alert".
- Tempelkan URL penerima ke Webhook URL.
- Aktifkan Alert Action. Toggle inilah yang memasukkan integration ke alert builder.
- Simpan. Internal integration otomatis terpasang di organisasi Anda; tidak ada langkah OAuth.
Biarkan langganan webhook lain (issue, error, comment) tidak dicentang. Pocket Alert mengubah setiap permintaan yang diterimanya menjadi push, dan resource tersebut akan tiba sebagai push dengan baris yang sebagian besar kosong.
Langkah 3: Kirim alert ke webhook tersebut
Alert builder Sentry saat ini berada di Monitors > Alerts > Create Alert:
- Source: project yang Anda pedulikan, atau monitor tertentu.
- Environment: pilih
production, agar noise dari staging tidak masuk ke ponsel Anda. - When: "A new issue is created" adalah pilihan klasik. "An issue escalates" dan "A resolved issue regresses" juga layak ditambahkan.
- Then: Send a notification via an integration, lalu pilih integration "Pocket Alert".
- Throttling: atur sekitar 30 menit, agar issue yang sedang ramai tidak mengirim push untuk setiap event.
Sebelum menyimpan, klik Send Test Notification pada blok If/Then. Push berjudul "Webhook Sentry" seharusnya sampai ke ponsel Anda dalam satu atau dua detik.
Yang sampai ke ponsel Anda
Untuk alert issue, payload Sentry membawa error di bawah data.event. Berikut field yang digunakan template, dari payload event_alert yang didokumentasikan Sentry:
| Field | Contoh | Digunakan untuk |
|---|---|---|
data.event.title | ReferenceError: heck is not defined | Baris pertama push |
data.event.culprit | lokasi error dilempar | Baris kedua |
data.triggered_rule | Very Important Alert! | Alert mana yang terpicu |
data.event.web_url | https://sentry.io/organizations/…/issues/…/events/…/ | Tombol "Open in Sentry" |
data.event.level | error | Opsional, lihat di bawah |
Alert metrik tidak memiliki data.event. action-nya adalah critical, warning, atau resolved, dan data.description_title sudah menyertakan statusnya, misalnya "Resolved: Too many errors", dengan data.description_text di bawahnya ("1000 events in the last 10 minutes"). Tombolnya menggunakan data.web_url.
Ingin level Sentry ditampilkan dalam teks? Tambahkan Level: %data.event.level% ke template. Itu hanya teks; bagian berikutnya menjelaskan mengapa itu tidak mengubah seberapa keras push tersebut berbunyi.
Level: apa yang benar-benar menentukan seberapa keras push-nya
Pocket Alert memiliki lima level: silent, low, default, high, dan critical. Untuk webhook, level dipilih dengan urutan berikut: field level di tingkat atas pada JSON yang masuk, lalu level default webhook, lalu level default aplikasi.
Sentry tidak otomatis cocok dengan urutan itu, dan template tidak bisa menerjemahkan nilai:
- Payload internal integration tidak memiliki
leveldi tingkat atas. Level Sentry berada didata.event.level, sehingga Pocket Alert menggunakan level default webhook. Itulah sebabnya webhook di atas dibuat dengandefault_level: 1(high), yang tampil di iPhone sebagai notifikasi sensitif-waktu yang tetap lolos Fokus. - Webhook legacy memang mengirim
leveldi tingkat atas, tetapi dengan nilai Sentry:fatal,error,warning,info,debug. Tidak ada yang merupakan level Pocket Alert, sehingga nilai itu diabaikan dan level default berlaku. Alert tetap terkirim.
Jika error fatal di production harus membangunkan Anda sementara yang lain tetap di level high, pisahkan di sisi Sentry. Pada paket berbayar, buat webhook Pocket Alert kedua bernama "Sentry critical" dengan default_level: 2, dan internal integration kedua yang mengarah ke sana. Kemudian gunakan dua blok If/Then di alert yang sama:
- Blok 1: If none dari: Event level equals
fatal. Then notify integration "Pocket Alert". - Blok 2: If all dari: Event level equals
fatal. Then notify "Pocket Alert critical".
Alert critical lolos dari Jangan Ganggu di iOS dan Android (lihat priority levels). Ini fitur berbayar: pada paket gratis, critical dikirim sebagai high.
Webhook legacy, jika Anda sudah memakainya
Project yang mengaktifkan Webhooks (Legacy) di bawah Project Settings > Legacy Integrations dapat mengarahkannya ke jenis webhook Pocket Alert yang sama. Payload-nya berbeda, jadi gunakan template ini:
%project_name%: %event.title%
%culprit%
Rule: %triggering_rules.0%
Dan template tombol ini untuk panggilan API di atas:
[{ "type": "view", "label": "Open in Sentry", "value": "%url%" }]
Gunakan %event.title% alih-alih %message% di tingkat atas. Pada payload legacy, message adalah pesan log event, yang kosong untuk exception biasa. Plugin legacy hanya mengirim saat sebuah alert memiliki aksi yang memberi tahu integration legacy project, dan halaman pengaturannya memiliki tombol Send Test Event.
Batasan yang perlu diketahui
- Satu judul untuk semuanya. Pocket Alert memberi judul push webhook
Webhook <name>; error-nya masuk ke isi. Jika Anda ingin error menjadi judul push, letakkan fungsi kecil di antara Sentry dan messages API. - Tidak ada pemeriksaan signature. Internal integration menandatangani permintaan dengan
Sentry-Hook-Signature, dan Pocket Alert tidak memverifikasinya. URL penerima yang acak adalah rahasianya, jadi jangan publikasikan. Jika bocor, hapus webhook dan buat yang baru. - Hanya JSON. Kedua mekanisme Sentry mengirim JSON, jadi ini sudah sesuai di sini, tetapi pengirim dengan form-encoded akan ditolak.
- Batas harian. Paket gratis mengirim 50 pesan per hari. Dengan throttling aktif dan alert khusus production, jumlah itu sudah cukup; alert untuk "every event captured" akan menghabiskannya dengan cepat.
Jika tidak ada yang masuk
- Buka riwayat webhook. Setiap permintaan ke webhook Pocket Alert Anda dicatat dengan header, body, pesan yang sudah dirender, dan status. Jika permintaannya ada, masalahnya ada di template; jika tidak ada, Sentry tidak pernah mengirimnya.
- Periksa toggle Alert Action. Tanpa itu, integration tidak muncul di bawah Send a notification via an integration.
- Periksa riwayat alert. Halaman detail alert di Sentry mencantumkan proses terbaru. Filter seperti environment atau level event sering mengecualikan event yang Anda harapkan.
- Baris kosong pada push berarti sebuah path tidak cocok dengan payload. Bandingkan dengan body di riwayat webhook; nama field bersifat case-sensitive.
- Tidak ada tombol berarti path URL menjadi kosong, dan tombol yang tidak valid akan dibuang sementara pesannya tetap terkirim.
FAQ
Apakah saya perlu menulis kode?
Tidak. Sentry mengirim webhook dan Pocket Alert mengubahnya menjadi push. Satu-satunya perintah dalam panduan ini adalah panggilan API opsional untuk menambahkan tombol "Open in Sentry".
Bisakah saya memisahkan production dan staging?
Bisa. Filter alert berdasarkan environment, atau buat satu alert untuk setiap environment yang mengarah ke integration dan webhook yang berbeda, masing-masing dikirim ke aplikasi Pocket Alert tersendiri sehingga Anda bisa membisukan staging secara terpisah.
Apakah ini bisa dipakai dengan Sentry self-hosted?
Internal integration dan alert action adalah bagian dari Sentry itu sendiri, jadi instalasi self-hosted yang cukup baru untuk memilikinya bisa mengirim ke Pocket Alert dengan cara yang sama, selama ia bisa menjangkau p4a.me melalui internet.
Bagaimana dengan Rollbar, Bugsnag, dan tracker lainnya?
Pendekatan yang sama berlaku untuk tracker mana pun yang mengirim JSON ke sebuah URL; hanya path template yang berubah. Lihat alert error tracking untuk gambaran lebih luas, serta webhook tool dan sintaks template untuk cara kerja template.
Apakah ini gratis?
Paket Gratis Pocket Alert mencakup satu webhook, satu perangkat, dan 50 pesan per hari, yang cukup untuk alert error production pada aplikasi kecil.
Buat akun gratis, tempelkan URL ke Sentry, dan error production berikutnya akan sampai ke Anda lebih dulu.