Belajar Borg Backup - Ekosistem: BorgWeb & Tools

#Pendahuluan

Borg adalah CLI yang hebat — tetapi dunia operasional jarang berhenti di CLI. Tim butuh GUI untuk operator non-teknis, integrasi dengan monitoring yang sudah ada, dan metrik untuk dashboard. Episode 19 memetakan ekosistem di sekitar Borg: dari BorgWeb yang ramah pengguna, borgmatic sebagai lapisan konfigurasi, hingga jembatan ke Nagios/Zabbix dan Prometheus.

#BorgWeb: GUI untuk Repository

#Apa itu BorgWeb

BorgWeb adalah antarmuka web (berbasis Python) untuk mengelola repository Borg. Ia memberi operator visual: melihat daftar archive, menjelajah isi, dan melakukan restore tanpa mengetik perintah.

pip install borgweb

BorgWeb berjalan sebagai service HTTP dan dikonfigurasi untuk mengakses repository tertentu (misal repo lokal di host yang sama, atau repo remote yang dibuka lewat mount). Kasus penggunaannya nyata: helpdesk yang perlu mengembalikan satu file tanpa akses shell.

#Kapan Memakai, Kapan Tidak

• Cocok: operasional harian, self-service restore untuk tim non-DevOps, dan inspeksi cepat.
• Tidak cocok: pengganti otomasi. BorgWeb tidak menjalankan jadwal backup; ia mengelola dan merestorasi. Otomasi tetap tanggung jawab borgmatic.

#borgmatic: Lapisan Konfigurasi

Borgmatic yang kita bangun di episode 9 adalah bagian terpenting ekosistem: ia mengubah kebijakan backup menjadi file YAML yang bisa di-version control, dan mengeksekusi create → prune → compact → check dalam urutan yang benar. Tidak ada alasan menjalankan backup manual ketika borgmatic bisa menjadikannya deklaratif.

#borg mount: Akses FUSE

borg mount (episode 5) adalah jembatan antara Borg dan tool lain. Archive yang di-mount tampak sebagai direktori biasa — bisa dibrowse NFS, dibackup tool lain, atau dipindai AV. Pola yang sering dipakai di produksi: mount archive terbaru, lalu verifikasi isinya dengan tool standar sebelum restore penuh.

#Integrasi Monitoring Klasik: Nagios/Zabbix

#Pola Wrapper

Nagios dan Zabbix tidak berbicara Borg — mereka butuh plugin yang mencetak exit code dan teks. Pola standarnya: wrapper script menjalankan operasi Borg, lalu mencetak output sesuai format plugin.

#!/usr/bin/env bash
set -euo pipefail
 
export BORG_REPO=/backup/borg
export BORG_PASSCOMMAND='cat /root/.borg-passphrase'
 
if borg list --last 1 > /dev/null 2>&1; then
    echo "OK - backup borg berjalan normal"
    exit 0
else
    echo "CRITICAL - repository borg bermasalah"
    exit 2
fi

Letakkan di /usr/lib/nagios/plugins/check_borg dan daftarkan sebagai command. Zabbix memakai pola serupa: user parameter atau external script yang mengembalikan nilai (jumlah archive, ukuran repo, waktu archive terakhir).

#Metrik yang Layak Dipantau

• Waktu archive terakhir (Staleness) — backup yang terlambat adalah alarm paling umum.
• Ukuran repository dan ruang disk.
• Hasil borg check terakhir.
• Exit code backup terakhir (dari borgmatic log).

#Prometheus: Textfile Collector

Prometheus node_exporter punya fitur textfile collector: file teks di direktori tertentu dibaca dan dipublish sebagai metrik. Ini cara termurah untuk mengekspor status borgmatic ke Prometheus.

#!/usr/bin/env bash
set -euo pipefail
 
OUT=/var/lib/node_exporter/textfile_collector/borg.prom
TMP="$OUT.$$"
 
if borgmatic --verbosity 0 --stats 2>/dev/null; then
    STATUS=1
else
    STATUS=0
fi
 
cat > "$TMP" <<EOF
# HELP borg_backup_success Apakah backup borgmatic terakhir sukses
# TYPE borg_backup_success gauge
borg_backup_success $STATUS
EOF
 
mv "$TMP" "$OUT"

Setelah exporter berjalan, metrik borg_backup_success muncul di endpoint node_exporter dan bisa ditarik Grafana/Alertmanager.

#Pitfall Umum

• BorgWeb di-host di server produksi tanpa autentikasi: GUI backup = kontrol penuh atas data. Jaga dengan reverse proxy + auth (BasicAuth/OIDC).
• Wrapper tanpa exit code: plugin monitoring butuh exit code yang benar (0/1/2). Mengabaikannya membuat alerting mati.
• Metrik tanpa staleness: borg_backup_success hanya berarti jika dievaluasi bersama time() - last_success. Sebuah host yang mati total "sukses" tanpa metrik terbaru.
• Menumpuk tool tanpa arah: borgmatic untuk otomasi, BorgWeb untuk operasional, Prometheus untuk observasi — masing-masing satu pekerjaan. Jangan mencampurnya.

#Penutup

• BorgWeb memberi GUI untuk mengelola dan merestorasi repository.
• borgmatic tetap menjadi pusat otomasi; BorgWeb bukan pengganti jadwal.
• borg mount (FUSE) menjembatani Borg dengan tool lain.
• Nagios/Zabbix diintegrasikan lewat wrapper dengan exit code yang benar.
• Prometheus textfile collector mengekspor status backup sebagai metrik.
• Jaga GUI dengan autentikasi, dan selalu ekspor metrik staleness.

Di episode 20 kita membangun kesadaran: monitoring & alerting — memantau metrik borgmatic, memicu alert saat backup gagal atau terlambat, dan mengirim notifikasi Email/Slack/Telegram lewat hooks borgmatic dan layanan seperti Healthchecks.