check_backup (for any backup system)

Project Notes

From the script: check_backup v1.0 Nagios plugin by John E.P. Hynes, HyTronix [03/22/2015] [email protected] Arguments can be in any order: d[days] h[hours] m[minutes] s[seconds] x[multiplier] f[filename] u[ssh user/host] and i[path to ssh key]. All except filename are optional. (Well, except that time defaulting to "0" will always fail...) and if you specify u[ssh user/host], you must also specify i[path to ssh key]. Example: ./check_backup h3 m45 x2 f/tmp/timefile u[ssh user/host], if provided, means to retrieve the contents of [filename] from a remote host via ssh. It must be in the search path. This string should contain user@host, so the complete declaration would be: ujohn@mybox (for user "john" at host "mybox") i[path to ssh key] tells ssh to log in using the ssh key provided. It would also allow you to just use a local key for which there was no local user. Make the remote user privilege-less for security. (So long as they can read [filename]...) I suppose ssh agent setup would work too; if you know about this you don't need me to tell you how to do it. ssh example: ./check_backup h3 m45 x2 f/tmp/timefile ujohn@mybox i~/.ssh/id_rsa Returns (from above example): OK if timestamp in /tmp/timefile is no older than 3 hours and 45 minutes ago, and the exit code in /tmp/timefile is 0. WARNING if time exceeded, CRITICAL if exceeded by multiplier - in this case, CRITICAL at 7 hours 30 minutes overdue. Always CRITICAL if exit code is not 0. If x[multiplier] is omitted, goes right to CRITICAL on time exceeded. Your backup scripts must produce this file. As implied, it's format is: ------8<------ CUT [timestamp] [exit code] ------8<------ CUT [timestamp] is seconds since the epoch, [exit code] is the backup process exit code (make this 0 if successful). For example, your script could, when complete, do a: echo -n `date +%s | tr -d 'n'> /tmp/test`; echo -n " " >> /tmp/test; echo "0" >> /tmp/test ...or somesuch. I'm sure you get the idea. Other than supporting getting timefile data via ssh, this script has no dependencies other than bash itself. Questions, comments, and suggestions appreciated.