DiskMon

A sysops toolkit for scanning, monitoring, reporting, alerting, tracking top usage, checking health, fixing issues, cleaning up, backing up, restoring, logging, benchmarking, and comparing disk-related operations — all from the command line with full history tracking.

Commands

Each data command (scan, monitor, report, etc.) works in two modes:

• - With arguments: Logs the input with a timestamp and saves to the corresponding .log file
• Without arguments: Displays the 20 most recent entries from that command's log

Data Storage

All data is stored locally in ~/.local/share/diskmon/. Each command writes to its own log file (e.g., scan.log, monitor.log, alert.log). A unified history.log tracks all activity across commands with timestamps.

• - Log format: INLINECODE27
• History format: INLINECODE28
• No external database or network access required

Requirements

• - Bash 4+ (uses set -euo pipefail)
• Standard POSIX utilities: date, wc, du, head, tail, grep, basename, INLINECODE37
• No root privileges needed
• No API keys or external dependencies

When to Use

1. 1. Tracking disk space trends over time — Use diskmon monitor and diskmon usage to log periodic disk space readings across servers, building a historical record you can search and export
2. Setting up alert documentation — Use diskmon alert to record threshold breaches and disk-full warnings, creating a searchable incident history
3. Documenting cleanup and maintenance — Use diskmon cleanup and diskmon fix to keep timestamped logs of what was cleaned, freed, or repaired on which systems
4. Benchmarking storage performance — Use diskmon benchmark and diskmon compare to log I/O test results and compare performance across different disks or configurations
5. Generating audit-ready exports — Use diskmon export json to produce a structured file of all logged monitoring activity for capacity planning, compliance reviews, or team handoff

Examples

Log a scan and review history

CODEBLOCK0

Monitor, alert, and report workflow

CODEBLOCK1

Cleanup and fix tracking

CODEBLOCK2

Export and statistics

CODEBLOCK3

Backup, restore, and benchmark

CODEBLOCK4

How It Works

DiskMon uses a simple case-dispatch architecture in a single Bash script. Each command maps to a log file under ~/.local/share/diskmon/. When called with arguments, the input is appended with a timestamp. When called without arguments, the last 20 lines of that log are displayed. The stats command aggregates entry counts across all logs, export serializes everything into JSON, CSV, or plain text, and search greps across all log files for a given term.

Support

• - Website: bytesagain.com
• Feedback: bytesagain.com/feedback
• Email: hello@bytesagain.com