check_backuppc(8)

💖 check_backuppc(8) — the Nagios plugin that keeps an eye on your BackupPC 💖

okay bestie, so this is check_backuppc, and it lives in the System Manager's Manual. she's a Nagios plugin, she watches BackupPC, and she's literally the friend who texts you "hey… your backups okay??" 🫶

✨ NAME ✨

check_backuppc — a Nagios plugin to monitor BackupPC 👑

🌸 SYNOPSIS 🌸

check_backuppc [options]

🦋 DESCRIPTION 🦋

check_backuppc is a nagios plugin that reports on the status of BackupPC. no cap, that's the whole job. 💅

by default, she monitors both archive hosts and backup hosts for errors. both. at once. multitasking icon behavior.

💜 OPTIONS 💜

• -a, --archive-only — only check the status of archive hosts. archives only, nothing else, periodt.
• -b, --backup-only — only check the status of non-archive hosts. so like, the regular backup girlies only.
• -s, --status-only — only check the status of the backups, and omit connection failures that are less than $Conf{FullPeriod} old. like, if the connection issue is still a baby, we're not reporting it.
• -H, --hostname hostname — only check the specified host. she uses the hostnames that BackupPC is configured to use, and you can specify this multiple times. 🎀
• -x, --exclude hostname — do not check the specified host. also uses the hostnames BackupPC is configured to use, and also can be specified multiple times.
• -w, --warning age — the days old at which a failure is considered a warning. default is 1.
• -c, --critical age — the days old at which a failure is considered critical. default is 8.
• -r, --reduce count — the maximum number of failed hosts for which to reduce reported severity. default is 0.
• -h, --help — show summary of options. the "bestie explain urself" flag. 🙈

🧚 NOTES 🧚

this plugin must be run on the same host and as the same user as BackupPC. not negotiable, it's giving "same energy only" 💀

also, an archive host only takes on a reported type of archive after its first archive run. so don't come for her before she's even had her debut. ⭐

🌈 EXAMPLES 🌈

/usr/local/lib/nagios/plugins/check_backuppc -r1 -w3 -c8 -b -x otter

check the status of all backup hosts except "otter". warn if a failed backup is older than three days old, return critical if a failure is older than eight days old unless there is only a single failure. in that case, warn if the single failed backup is older than eight days.

like… she's being nice about the one (1) sad backup. one bad backup is not a crisis, it's a warning, bestie. 🍓

👑 AUTHOR 👑

Seneca Cunningham <tetragon@users.sourceforge.net>

💖 SEE ALSO 💖

sudo(8). backuppc(8).

and that's the whole page, fr fr — this was check_backuppc(8) from the System Manager's Manual, and the footer just says check_backuppc(8) right back at you, so consider yourself blessed by the manual-page gods. go check those backups. slay. 💅✨