test-scale

What it is

test-scale is a distributed load testing platform for repeatable performance regression testing. You submit a small YAML plan, workers autoscaled from the target throughput, histogram-correct metrics stream in, and you compare the run against a baseline. It is not a scripting engine — v0.1 supports one HTTP request per plan with constant, ramp, step, or spike traffic patterns.

Architecture

CLI and embedded web UI talk to a Gin control plane. Postgres stores plans and runs; NATS queues jobs; an autoscaler scales a worker pool (Docker Compose locally, KEDA on Kubernetes); workers hit the target and push metrics to an OpenTelemetry aggregator merged into Prometheus and Grafana dashboards.

CLI / Web UI → Control Plane (Gin + orchestrator)
              → Postgres (plans, runs)
              → NATS (job queue)
              → Autoscaler → Worker pool → Target under test
              → Aggregator (OTel) → Prometheus → Grafana

Install

brew install MohamedBenTaher/tap/test-scale

curl -sSL https://raw.githubusercontent.com/MohamedBenTaher/test-scale/main/setup.sh | bash

helm install test-scale \
  oci://ghcr.io/mohamedbentaher/charts/test-scale \
  --version 0.1.0 \
  --namespace test-scale --create-namespace

Quick start

git clone https://github.com/MohamedBenTaher/test-scale.git
cd test-scale
make quickstart

Builds images, starts the stack, waits for health, and runs examples/smoke.yaml against the bundled mock target.