Surge
Lightning-fast, concurrent HTTP load testing tool in Go with CI quality gates
Go CLIHTTP BenchmarkingCI/CD GateTail Latency
The Problem
Why This Was Built
Existing load testing tools are either bloated enterprise suites or bare-bones curl loops that lack actionable tail-latency percentiles, automated health verdicts, and easily scriptable CI pipeline assertions.
The Solution
The Architectural Answer
A single static Go binary providing accurate percentile calculations, ramp-up schedules, think-time modeling, and structured JSON output for strict pipeline thresholds.
Capabilities
Key Features & Architecture
Calculates p50, p90, p95, and p99 tail latencies to detect cold starts and lock stalls
Built-in workload presets: baseline, realistic, capacity, and spike testing
--fail-threshold parameter to fail CI builds when error rate exceeds threshold
Automated health verdicts: Excellent, Good, Fair, Poor based on error and latency boundaries
Detailed classification of network failure modes (DNS, TLS handshake, connection resets)
Zero-dependency static Go binary runnable in Docker or GitHub Actions
Engineering
Technical Specifications
- Primary Languages
- Go
- Frameworks & Tooling
- net/httppflag
- Architecture & Execution Model
- Goroutine worker pools, zero-allocation latency buckets, lock-free histogram metrics
- Licensing Model
- AGPL-3.0 (copyleft)
- Release & Lineage
- Active release cycle since 2026 · Maintained by @JadMadi
Knowledge
Frequently Asked Questions
How do I install Surge?
Run `go install github.com/jadmadi/surge@latest` to install the binary to your GOPATH.