CronJob
A comprehensive sysops toolkit for scanning, monitoring, reporting, and maintaining scheduled job operations. CronJob provides 18+ commands for tracking job events, performing health checks, managing backups, benchmarking performance, and exporting operational data in multiple formats.
Commands
| Command | Description |
|---|---|
cronjob scan <input> |
Record a scan entry — run without args to view recent scan entries |
cronjob monitor <input> |
Record a monitoring observation — run without args to view recent entries |
cronjob report <input> |
Log a report entry — run without args to view recent reports |
cronjob alert <input> |
Record an alert — run without args to view recent alerts |
cronjob top <input> |
Log a top-level event — run without args to view recent entries |
cronjob usage <input> |
Track usage data — run without args to view recent usage entries |
cronjob check <input> |
Record a check result — run without args to view recent checks |
cronjob fix <input> |
Log a fix action — run without args to view recent fixes |
cronjob cleanup <input> |
Record a cleanup operation — run without args to view recent cleanups |
cronjob backup <input> |
Log a backup event — run without args to view recent backups |
cronjob restore <input> |
Record a restore operation — run without args to view recent restores |
cronjob log <input> |
Add a general log entry — run without args to view recent log entries |
cronjob benchmark <input> |
Record a benchmark result — run without args to view recent benchmarks |
cronjob compare <input> |
Log a comparison — run without args to view recent comparisons |
cronjob stats |
Display summary statistics across all log categories |
cronjob export <fmt> |
Export all data to a file (formats: json, csv, txt) |
cronjob search <term> |
Search across all log files for a keyword |
cronjob recent |
Show the 20 most recent activity entries from the history log |
cronjob status |
Health check — shows version, data directory, entry count, disk usage |
cronjob help |
Display available commands and usage information |
cronjob version |
Print current version (v2.0.0) |
Each data command (scan, monitor, report, etc.) works in two modes:
- With arguments: Records the input with a timestamp into its dedicated log file
- Without arguments: Displays the 20 most recent entries from that category
Data Storage
All data is stored locally in plain-text log files:
- Location:
~/.local/share/cronjob/ - Format: Each entry is saved as
YYYY-MM-DD HH:MM|<value>in per-category.logfiles - History: All operations are additionally logged to
history.logwith timestamps - Export: The
exportcommand can generate JSON, CSV, or TXT files from all log data - No cloud sync — everything stays on your machine
Requirements
- Bash 4.0+ (uses
set -euo pipefail) - Standard Unix utilities:
date,wc,du,head,tail,grep,basename,cat - No external dependencies, no API keys, no network access required
- Works on Linux and macOS
When to Use
- Cron job monitoring — Track the execution status of scheduled jobs, log failures, and set up alerts for review
- Job audit trail — Record scan, check, and report entries to maintain a complete history of job operations
- Backup & restore logging — Log backup and restore events with timestamps so you always know what happened and when
- Performance benchmarking — Record benchmark results for scheduled tasks and compare them over time to spot regressions
- Operational data export — Export all collected logs in JSON, CSV, or TXT format for dashboards, compliance, or further analysis
Examples
# Record a scan of cron job health
cronjob scan "all 12 scheduled jobs ran successfully today"
# Log a monitoring observation
cronjob monitor "backup-job took 45min, 3x longer than usual"
# Record an alert for a failed job
cronjob alert "daily-report cron failed at 03:00 — exit code 1"
# Log a fix action taken
cronjob fix "increased timeout for backup-job from 30m to 90m"
# View summary statistics across all categories
cronjob stats
# Export all data to CSV for spreadsheet analysis
cronjob export csv
# Search for entries related to a specific job
cronjob search "backup-job"
# Quick health check
cronjob status
# View the 20 most recent activity entries
cronjob recent
Configuration
Set CRONJOB_DIR to change the data directory. Default: ~/.local/share/cronjob/
Powered by BytesAgain | bytesagain.com | hello@bytesagain.com