Load testing with meter

Meter command builder

A JMeter-style console load tester: fires HTTP load at a target, shows a live terminal dashboard, and writes a self-contained report.html when it finishes.

Install this module

$ conflux install meter

v0.2.0

Examples

Common invocations to copy as-is, or use as a starting point for the builder below.

$ conflux meter <url> --users 50 --requests 5000

load

Fixed concurrency for a duration or request budget.

conflux meter <url> --users 100 --duration 1m --rate 800

capacity

Ramps users up in steps to find the breaking point.

conflux meter <url> --scenario capacity \
  --start-users 20 --step 20 --slo-latency 500ms

spike

Holds a baseline, bursts to a higher load, then recovers.

conflux meter <url> --scenario spike \
  --users 20 --spike-users 200 --spike-duration 15s

soak

Sustained load over a long duration to catch drift and leaks.

conflux meter <url> --scenario soak --users 50 --duration 30m

$ conflux meter --file req.http --var host=example.com --scenario spike

$ conflux meter <url> --auth --users 50

$ conflux meter <url> --web

Command generator

Fill in the form and get a ready-to-run conflux meter command — only options that differ from the defaults are included.

Target

What to hit: a URL or a .http request file, plus method, headers and body.

url

Target URL (or use --file below)

--file

Path to a .http/.rest request file — wins over the URL

--method, -X

--body

Request body; @path reads from a file

--header, -H

Repeatable request headers

--var

Variables for {{var}} substitution in the request file

Load

Concurrency, request budget, duration and pacing.

--users, -u

Virtual users (concurrency)

--requests, -n

Total request budget (0 = unlimited)

--duration, -d

Test duration (empty = until budget)

--ramp-up

Linearly start users over this period

--rate

Global requests/second cap (0 = unlimited)

--timeout

Per-request timeout

Transport

TLS, HTTP/2 and Conflux authentication.

--insecure

Skip TLS certificate verification

--http2

Attempt HTTP/2

--auth

Send your Conflux access token as Authorization: Bearer

Scenario

Pick a test shape; scenario-specific options appear below.

--scenario

Fixed concurrency for a duration or request budget.

Output

Dashboards and report files.

--web

Also serve the browser dashboard

--dashboard

Web dashboard listen address

--open

Open the dashboard in a browser

--plain

Disable the live terminal dashboard (CI/pipes)

--out

HTML report output path

--json

Raw snapshot JSON output path

Generated command

$ conflux meter <url>

Provide a target URL or a request file — one of the two is required.