Benchmark — Performance Benchmark Testing Tool

A comprehensive performance benchmarking skill for running CPU, memory, disk, and network tests. Supports comparison between runs, historical tracking, profiling, and stress testing. All results are stored in JSONL format.

Prerequisites

• bash (v4+)
• python3 (v3.6+)
• Standard system utilities (dd, time, etc.)

Environment Variables

Data Storage

• Results: ~/.benchmark/data.jsonl
• Config: ~/.benchmark/config.json
• Reports: ~/.benchmark/reports/

Commands

run

Execute a benchmark test of the specified type.

BENCH_TYPE="cpu" BENCH_TAG="baseline" scripts/script.sh run

compare

Compare two benchmark runs side by side.

BENCH_ID="bench_a" BENCH_ID2="bench_b" scripts/script.sh compare

history

Show benchmark run history with optional filtering.

BENCH_TYPE="cpu" BENCH_TAG="baseline" scripts/script.sh history

report

Generate a detailed performance report.

BENCH_ID="bench_abc123" scripts/script.sh report

profile

Run a detailed profiling session with breakdown.

BENCH_TYPE="cpu" BENCH_DURATION="30" scripts/script.sh profile

stress

Run a sustained stress test.

BENCH_TYPE="cpu" BENCH_DURATION="60" BENCH_THREADS="4" scripts/script.sh stress

config

View or update benchmark configuration.

BENCH_KEY="default_duration" BENCH_VALUE="30" scripts/script.sh config

export

Export benchmark data in various formats.

BENCH_FORMAT="csv" scripts/script.sh export

list

List all benchmark runs.

scripts/script.sh list

status

Show benchmarking system status and summary.

scripts/script.sh status

help

Display usage information.

scripts/script.sh help

version

Display current version.

scripts/script.sh version

Output Format

All commands output structured JSON to stdout:

{
  "status": "success",
  "command": "run",
  "data": {
    "id": "bench_20240101_120000_abc123",
    "type": "cpu",
    "score": 15234.5,
    "duration_ms": 10000,
    "metrics": {}
  }
}

Error Handling

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