Jobwatch

(C) 2022, Michael Höß, MIT-Licensed

What is jobwatch

If you just want to execute a simple shell-script via cron every couple of hour, often only a few lines of code are required.

But if you want to ensure the script really run, in the required interval, completed without error, you have to add a lot of plumping code.

jobwatch helps to migitate this problem. It wraps the execution of your script, and does all the rest for you, by providing output, which can be fed to CheckMK by the Agent-Plugin-mechanism.

jobwatch

• checks for required exit-codes, and maps them to OK, WARN, CRIT, UNKN (0-3)
• searches through the console-output of your script via regex to classify certain keywords as OK, WARN or CRIT (0, 1, 2)
• sends previous regex matches to logwatch
• prevents running your job in multiple instances (previous job took longer than expected)
• let you define the required run-intervals

Simply add a .job-file into /etc/jobwatch.d where you defines all of this, call you script via jobwatch -j job in the crontab and you are done.

TBD:

• document deployment
• document job-file (see included sample)
• redirect script-output to a logfile via Config
• job-timeout
• more metrics (last-success-ful run )