Notifikasi Proxmox ke ponsel Anda: backup, fencing, replikasi, dan error disk

Kebanyakan host Proxmox mengirim notifikasi ke root@pam, yaitu alamat email yang diketik di installer bertahun-tahun lalu, dikirim lewat Postfix yang tidak pernah diberi relay. Backup malam hari gagal, email masuk ke antrean lokal, dan Anda baru tahu tiga minggu kemudian saat perlu memulihkan VM.
Pengaturan umum lainnya memang berfungsi, tetapi diabaikan. Setiap job backup mengirim email panjang setiap malam, semuanya bertuliskan "successful", dan yang bertuliskan "failed" terlihat persis seperti tiga puluh email lainnya di folder.
Sejak Proxmox VE 8.3 dan Proxmox Backup Server 3.3, sistem notifikasi memiliki target webhook generik. Target ini dapat memanggil API HTTP apa pun dengan body yang Anda tulis sendiri, jadi bisa mengirim push langsung ke ponsel, dengan prioritas berbeda untuk kegagalan dan keberhasilan. Tanpa skrip di host dan tanpa relay yang perlu dirawat.
Yang Anda butuhkan
- Proxmox VE 8.3 atau yang lebih baru (versi 9.x mana pun berfungsi), atau Proxmox Backup Server 3.3 atau yang lebih baru. Versi lama dibahas di bagian bawah.
- Aplikasi Pocket Alert di iPhone atau Android dan kunci API dari Kunci API.
- Akses ke Datacenter → Notifications sebagai
root@pamatau pengguna denganMapping.Modifypada/mapping/notifications.
Apa yang bisa diberitahukan Proxmox
Proxmox VE mengeluarkan event berikut, masing-masing dengan type, tingkat keparahan, dan beberapa field metadata:
| Event | type | Keparahan |
|---|---|---|
| Backup berhasil | vzdump | info |
| Backup gagal | vzdump | error |
| Job replikasi storage gagal | replication | error |
| Node cluster di-fence | fencing | error |
| Pembaruan sistem tersedia | package-updates | info |
| Email untuk root (smartd, ZFS ZED, dan lainnya) | system-mail | unknown |
Baris terakhir lebih penting daripada kelihatannya. smartd memeriksa disk Anda setiap 30 menit dan mengirim email ke root saat satu disk mulai bermasalah, sementara daemon event ZFS mengirim email ke root tentang pool yang terdegradasi dan error scrub (ZED_EMAIL_ADDR="root" adalah default). Proxmox mengubah email tersebut menjadi event system-mail, sehingga webhook yang sama yang melaporkan backup juga melaporkan disk yang sekarat.
Siapkan target webhook
Di antarmuka web, buka Datacenter → Notifications, lalu di bawah Notification Targets klik Add → Webhook. Isi seperti berikut:
- Endpoint Name:
pocketalert - Method/URL:
POSTdanhttps://api.pocketalert.app/v1/messages - Headers:
Content-Type=application/json, danToken={{ secrets.token }} - Secrets:
token= kunci API Pocket Alert Anda
Dan Body-nya:
{
"title": {{ json title }},
"message": {{ json message }},
"level": "{{#if (or (eq severity "error") (eq severity "unknown"))}}high{{else}}low{{/if}}"
}
Ada beberapa hal yang terjadi di sini:
{{ json title }}menampilkan nilai sebagai string JSON lengkap, termasuk tanda kutipnya. Laporan backup berupa tabel multi-baris, dan menempelkan{{ message }}di antara tanda kutip akan merusak JSON pada baris baru pertama. Proxmox juga punya{{ escape message }}, yang melakukan hal yang sama tanpa tanda kutip di sekelilingnya.- Kuncinya adalah secret. Secret disimpan di
/etc/pve/priv/notifications.cfg, hanya bisa dibaca root, dan API tidak pernah mengembalikan nilainya. Proxmox juga menyembunyikannya dari pesan error. - Level mengikuti keparahan. Proxmox merender body dengan Handlebars, yang memiliki
if,eq, danor. Backup gagal, replikasi gagal, fencing, dan email disk tiba sebagaihigh, yang menembus Fokus di iPhone. Backup berhasil dan pemberitahuan pembaruan tiba sebagailow: notifikasi tersebut ada di feed jika Anda menginginkannya, dan tidak bergetar.
Simpan target lalu klik Test. Notifikasi uji seharusnya tiba dalam beberapa detik.
Target ini tidak melakukan apa pun sampai sebuah matcher mengarahkan event ke sana. Di bawah Notification Matchers, klik Add, beri nama pocketalert-all, lalu di tab Targets to notify centang pocketalert. Matcher tanpa aturan mencocokkan setiap event.
Hal yang sama dari shell
Jika Anda lebih suka CLI, atau mengelola beberapa cluster, pvesh melakukan hal yang sama. Nilai header, body, dan secret diteruskan dalam format base64:
PA_KEY='your-api-key'
BODY='{
"title": {{ json title }},
"message": {{ json message }},
"level": "{{#if (or (eq severity "error") (eq severity "unknown"))}}high{{else}}low{{/if}}"
}'
b64() { printf '%s' "$1" | base64 -w0; }
pvesh create /cluster/notifications/endpoints/webhook \
--name pocketalert --method post \
--url https://api.pocketalert.app/v1/messages \
--header "name=Content-Type,value=$(b64 application/json)" \
--header "name=Token,value=$(b64 '{{ secrets.token }}')" \
--secret "name=token,value=$(b64 "$PA_KEY")" \
--body "$(b64 "$BODY")"
pvesh create /cluster/notifications/matchers --name pocketalert-all --target pocketalert
pvesh create /cluster/notifications/targets/pocketalert/test
Hasilnya tersimpan di /etc/pve/notifications.cfg, yang dibagikan di seluruh cluster, sehingga satu pengaturan mencakup setiap node (body base64 disingkat di sini):
webhook: pocketalert
method post
url https://api.pocketalert.app/v1/messages
header name=Content-Type,value=YXBwbGljYXRpb24vanNvbg==
header name=Token,value=e3sgc2VjcmV0cy50b2tlbiB9fQ==
body ewogICJ0aXRsZSI6IHt7IGpzb24gdGl0bGUgfX0s...
matcher: pocketalert-all
target pocketalert
Kuncinya sendiri berada di /etc/pve/priv/notifications.cfg sebagai secret name=token,value=<base64>.
Tingkat kedua: node yang di-fence harus membangunkan Anda
Backup yang gagal bisa menunggu sampai pagi. Node yang di-fence berarti HA baru saja mematikan sebuah host, dan itu layak mendapat push critical yang tembus Jangan Ganggu. Matcher bisa melakukan ini tanpa menyentuh template body.
Buat target webhook kedua, pocketalert-critical, yang identik dengan yang pertama kecuali satu baris pada body:
"level": "critical"
Lalu ganti matcher catch-all dengan dua matcher yang memisahkan berdasarkan tipe event:
matcher: pocketalert-all
match-field exact:type=fencing
invert-match true
target pocketalert
matcher: pocketalert-fencing
match-field exact:type=fencing
target pocketalert-critical
invert-match membalik matcher pertama, sehingga fencing hanya dikirim ke target critical dan Anda tidak mendapat dua push untuk satu event. Pengiriman critical yang tembus Jangan Ganggu adalah fitur paket berbayar; di paket Gratis ia tiba sebagai high. Lihat level prioritas untuk apa yang dilakukan tiap level di iOS dan Android.
Hal lain yang bisa dilakukan matcher:
- Hanya kegagalan. Tambahkan
match-severity error,unknownkepocketalert-alldan backup yang berhasil berhenti mengirim apa pun. Kami tetap menyimpannya sebagailow: notifikasi "backup successful" yang senyap setiap malam adalah cara termudah untuk menyadari kapan notifikasi itu berhenti datang. - Satu job.
match-field exact:job-id=backup-abc123membatasi matcher ke satu job terjadwal. Backup yang dimulai dengan Run now tidak memilikijob-id, sehingga tidak akan cocok. - Jam tenang.
match-calendar mon..fri 9-17membatasi matcher ke jam kerja, daninvert-matchmemberi Anda sisanya.
Tombol yang membuka antarmuka web
Push Pocket Alert bisa membawa hingga tiga tombol aksi. Tambahkan satu ke body dan backup yang gagal membuka antarmuka Proxmox dengan satu ketukan:
"actions": [
{"type": "view", "label": "Open Proxmox", "value": "https://pve1.lan:8006"}
]
Ponsel membuka URL itu sendiri, sehingga alamat lokal berfungsi kapan pun Anda berada di jaringan rumah atau VPN.
Proxmox Backup Server
PBS 3.3 dan yang lebih baru memiliki sistem notifikasi yang sama di bawah Configuration → Notifications, dengan target webhook yang sama, body yang sama, dan helper Handlebars yang sama. Konfigurasinya tersimpan di notifications.cfg dan notifications-priv.cfg di bawah /etc/proxmox-backup/.
Event-nya berbeda dan lebih berguna untuk backup server: garbage collection (gc), prune, sync, verification, tape-backup dan tape-load, ditambah kegagalan pembaruan sertifikat acme dan package-updates. acme hanya melaporkan kegagalan dan tape-load berupa notice; sisanya datang dalam versi info dan error, sehingga if yang sama di body berfungsi tanpa perubahan. Event datastore (gc, prune, sync, verification, tape-backup) juga membawa field datastore, sehingga match-field regex:datastore=^offsite-.*$ dapat mengirim datastore offsite ke target yang berbeda.
Dua hal PBS yang perlu diperiksa. Datastore yang dibuat sebelum sistem notifikasi memiliki notification-mode yang mungkin masih legacy-sendmail; ubah ke sistem notifikasi di opsi datastore. Dan PBS hanya mengirim notifikasi package-updates pada host dengan langganan aktif.
Batasan yang jujur
- Host harus online untuk melapor. Webhook dikirim oleh host Proxmox itu sendiri, jadi jika kehilangan uplink atau dimatikan, tidak ada yang keluar. Untuk "seluruh perangkat mati", Anda memerlukan pengecekan dari luar, misalnya uptime monitor di mesin lain.
- Laporan backup yang panjang dipotong dalam push. Backup dua puluh guest menghasilkan tabel yang panjang. Push menampilkan sekitar 3 KB pertama; teks lengkapnya ada di riwayat pesan di aplikasi.
system-mailadalah semua yang dikirim ke root. Itu mencakup smartd dan ZFS, tetapi juga output cron dan apa pun lain yang mengirim email ke root di sistem Anda. Jika terlalu berisik, berikan event tersebut matcher sendiri denganmatch-field exact:type=system-maildan target yang lebih senyap.- Tidak ada kompatibilitas Gotify. Proxmox juga punya target Gotify bawaan, dan panduan lama memakainya untuk push ke ponsel. Pocket Alert tidak mengimplementasikan API Gotify, sehingga target itu tidak bisa mengarah ke kami. Gunakan target webhook di atas, atau lihat perbandingan Pocket Alert dengan Gotify.
Pada Proxmox VE 8.2 ke bawah
Meningkatkan versi adalah solusi terbaik, karena target webhook memerlukan 8.3. Jika belum bisa meningkatkan, sebuah hook skrip vzdump mencakup kasus paling penting, yaitu backup. Pasang Pocket Alert CLI di node sebagai root, jalankan pocketalert auth, lalu simpan ini sebagai /usr/local/bin/vzdump-pocketalert:
#!/bin/sh
case "$1" in
backup-abort) pocketalert send -t "Backup failed: $3 on $(hostname)" -m "Mode: $2" -l high ;;
job-end) pocketalert send -t "Backup job finished on $(hostname)" -m "Check the task log for details" -l low ;;
esac
exit 0
Jadikan file itu executable dan tambahkan script: /usr/local/bin/vzdump-pocketalert ke /etc/vzdump.conf. vzdump memanggilnya di setiap fase; untuk backup-abort, argumen kedua dan ketiga adalah mode backup dan ID VM.
Jika tidak ada yang masuk
- Jalankan Test terlebih dahulu. Jika push uji tiba tetapi event sungguhan tidak, targetnya sudah benar dan masalahnya ada di routing: periksa apakah sebuah matcher menyebut target tersebut dan apakah aturannya cocok.
- Lihat mode notifikasi job backup. Job yang memiliki alamat email di pengaturan notifikasinya dan mode default
automemakai legacy sendmail dan melewati sistem notifikasi sepenuhnya. Hapus alamatnya atau atur mode ke sistem notifikasi; di/etc/pve/jobs.cfgbentuknyanotification-mode notification-system. - Baca journal.
journalctl --since "1 hour ago" | grep -i notifmenampilkan permintaan yang gagal.401berarti kuncinya salah,400biasanya berarti body bukan JSON yang valid: pastikan Anda memakai{{ json message }}dan bukan{{ message }}polos. - Periksa feed di aplikasi. Push
lowtidak berbunyi, sehingga backup yang berhasil bisa terlihat seperti tidak pernah tiba. Notifikasinya ada di riwayat pesan.
FAQ
Apakah saya memerlukan langganan Proxmox?
Tidak. Sistem notifikasi dan target webhook adalah bagian dari repositori gratis. Satu-satunya komponen yang bergantung langganan adalah notifikasi package-updates pada PBS.
Apakah ini berfungsi untuk satu node tanpa cluster?
Ya. Satu node membaca /etc/pve/notifications.cfg yang sama. Dalam cluster file itu dibagikan, jadi Anda cukup menyiapkannya sekali.
Bisakah saya mendapatkan ini juga lewat email?
Bisa. Pertahankan target mail-to-root bawaan di matchernya dan tambahkan pocketalert di sebelahnya. Sebuah matcher bisa memberi notifikasi ke beberapa target, dan setiap target menerima notifikasi paling banyak satu kali.
Berapa banyak push yang akan dipakai?
Satu per event. Job backup malam hari adalah satu notifikasi untuk seluruh job, bukan satu per guest, jadi homelab biasa mengirim beberapa notifikasi sehari. Paket Gratis mencakup 50 pesan per hari untuk satu perangkat.
Bagaimana dengan TrueNAS, event daya UPS, atau Uptime Kuma?
Idenya sama, pengirimnya berbeda. Halaman peringatan homelab membahas bagian-bagian umum dari rak server rumahan, dan peringatan backup membahas alat backup selain Proxmox.
Buat akun gratis, tempelkan body ke target webhook, dan biarkan backup gagal berikutnya menemukan Anda, bukan kotak masuk Anda.