ksp benchmark
ksp benchmark
Run intensive high-throughput, concurrency, and latency benchmarks against a local or remote KSP server.
Networking & Diagnostics
RFC § 9 — Performance & Framing EfficiencyPurpose
Run intensive high-throughput, concurrency, and latency benchmarks against a local or remote KSP server.
Syntax
Command-line specificationbash / powershell
ksp benchmark <SERVER_URI> [OPTIONS]
Arguments
| Argument | Description |
|---|---|
| <SERVER_URI> | Target server endpoint to benchmark (e.g., `127.0.0.1:9876`). |
Options & Flags
| Option Flag | Description |
|---|---|
| --streams <NUM> | Number of concurrent multiplexed streams to open simultaneously (default: `64`). |
| --payload <BYTES> | Size of each individual stream chunk payload in bytes (default: `16384`). |
| --duration <SECONDS> | Total test duration in seconds (default: `10`). |
| --cipher <NAME> | Benchmark specific cipher: `aes-256-gcm` vs `chacha20-poly1305`. |
Example Usage
Example command
ksp benchmark 127.0.0.1:9876 --streams 128 --duration 10
Expected Output
════════════════════════════════════════════════════════════ ══ KSP High-Performance Benchmark Suite ══ ════════════════════════════════════════════════════════════ [+] Target: 127.0.0.1:9876 (AES-256-GCM) [+] Concurrency: 128 multiplexed streams [+] Chunk Size: 16,384 bytes [+] Test Duration: 10.00 seconds ⚡ Running throughput stress test... [████████████████████████████████████████] 100% --- Benchmark Summary --- Total Transferred: 4.82 GB in 10.00 seconds Throughput: 482.15 MB/s (3,857 Mbps) Handshake Speed: 12,400 handshakes/sec Stream Overhead: < 0.18% framing tax P99 Latency: 1.12 ms
Implementation Notes
Demonstrates KSP's zero-copy stream multiplexing performance compared to HTTP/2 and standard TLS 1.3.