SysCheck

SysCheck

A thorough sysops toolkit for recording, tracking, and analyzing system operations from the command line. Log scans, monitor events, generate reports, set alerts, track benchmarks, and export your data — all stored locally with full history.

Commands

Each command works in two modes:

• With arguments: Records the input as a timestamped entry in the corresponding .log file
• Without arguments: Displays the 20 most recent entries from that category

Data Storage

• Default location: ~/.local/share/syscheck/
• Per-command logs: Each command type has its own log file (e.g., scan.log, monitor.log, alert.log)
• History log: history.log — timestamped record of every command executed
• Export files: Generated in export.json, export.csv, or export.txt inside the data directory
• All data is local. No cloud, no network, no third-party services.

Requirements

• Bash 4+ (uses set -euo pipefail)
• Standard Unix utilities: date, wc, du, head, tail, grep, cat, basename
• No external dependencies or API keys required

When to Use

1. Daily system operations logging — Record scans, checks, and fixes as you work through sysadmin tasks, building a timestamped audit trail
2. Incident tracking — Use alert and fix to log issues as they arise and how they were resolved, creating a lightweight incident history
3. Performance benchmarking — Log benchmark results over time with benchmark and use compare to track changes between runs
4. Backup and restore auditing — Record every backup and restore operation to maintain a verifiable history of data protection activities
5. Team handoff documentation — Export thorough reports in JSON or CSV for sharing with team members or integrating into dashboards

Examples

# Record a system scan result
syscheck scan "Full disk scan completed, 3 issues found on /dev/sda1"

# Log a monitoring event
syscheck monitor "CPU load average exceeded 4.0 for 15 minutes"

# Set an alert for a threshold breach
syscheck alert "Memory usage at 92% on production server"

# Record a fix that was applied
syscheck fix "Cleared /tmp directory, freed 12GB disk space"

# Log a backup operation
syscheck backup "Daily backup of /var/data completed, 2.3GB tarball"

# Run a benchmark and log results
syscheck benchmark "Disk I/O: 450MB/s read, 320MB/s write on NVMe"

# View recent activity across all commands
syscheck recent

# Search for all entries mentioning disk
syscheck search disk

# Show aggregate statistics
syscheck stats

# Export everything to JSON for external analysis
syscheck export json

# Export as CSV for spreadsheet import
syscheck export csv

# Quick health check
syscheck status

How It Works

SysCheck uses a simple file-per-category logging system. When you run a command with input, it appends a timestamped line to the corresponding .log file (e.g., syscheck scan "message" writes to scan.log). Without input, it tails the last 20 entries from that file.

The stats command aggregates counts across all log files. The export command merges all logs into a single file in your chosen format (JSON, CSV, or plain text). The search command performs case-insensitive grep across every log file.

All operations are also recorded in history.log for full audit trail.

Powered by BytesAgain | bytesagain.com | hello@bytesagain.com