Time Logger

Time Logger v2.0.0 — a sysops toolkit for logging, monitoring, and managing system operations from the command line. All data is stored locally in flat log files with timestamps, making it easy to review history, export records, and search across entries.

Commands

Run scripts/script.sh <command> [args] to use.

Core Operations

Each command without arguments shows the 20 most recent entries for that category.

Utility Commands

Data Storage

All data is persisted locally under ~/.local/share/time-logger/:

• <command>.log — One log file per command (e.g. scan.log, monitor.log, backup.log)
• history.log — Global activity log with timestamps for every operation
• export.<fmt> — Generated export files (json/csv/txt)

Each entry is stored as YYYY-MM-DD HH:MM|<input> (pipe-delimited). No external services, no API keys, no network calls — everything stays on your machine.

Requirements

• Bash 4.0+ with set -euo pipefail
• Standard Unix utilities: date, wc, du, grep, tail, cat, sed, basename
• No external dependencies or packages required
• No API keys or accounts needed

When to Use

1. Tracking system operations — Log scans, monitors, and health checks to build a searchable history of your sysops activities
2. Recording incident response — Use alert, fix, and restore to document the lifecycle of an incident from detection through resolution
3. Auditing maintenance tasks — Track cleanup, backup, and restore operations so you can prove compliance and trace back when actions occurred
4. Benchmarking and comparing — Use benchmark and compare to record performance baselines and before/after results across system changes
5. Generating ops reports — Use report to log periodic summaries, then export json to pull structured data for dashboards or handoffs

Examples

# Log a system scan
time-logger scan "Full port scan on 192.168.1.0/24 — 12 hosts found"

# Record a monitoring event
time-logger monitor "nginx upstream response time spiked to 2.3s"

# Log an alert
time-logger alert "Disk usage on /var exceeded 90% threshold"

# Record a fix applied
time-logger fix "Rotated nginx logs and freed 4.2GB on /var"

# Search for all entries mentioning 'nginx'
time-logger search nginx

# Export everything to JSON
time-logger export json

# View summary statistics
time-logger stats

# Check recent activity
time-logger recent

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