The 30-second quickstart

Load profiles

The smallest useful loadr test. A constant pool of virtual users hammers a single endpoint, every response is checked, and a threshold turns the run red or green — the shape every other test builds on.

Browse all 52 demos 12 categories
Run it
$ loadr run examples/01-quickstart.yaml
examples/01-quickstart.yaml
# The smallest useful loadr test: 10 virtual users hammering one endpoint
# for 30 seconds, with checks and a pass/fail threshold.
#
#   loadr run examples/01-quickstart.yaml
name: quickstart
description: 10 VUs against one endpoint for 30s

defaults:
  http:
    base_url: https://httpbin.org
    timeout: 10s

scenarios:
  hit_home:
    executor: constant-vus
    vus: 10
    duration: 30s
    flow:
      - request:
          name: get
          method: GET
          url: /get
          checks:
            - { type: status, equals: 200 }
            - { type: duration, name: fast enough, max: 800ms }

thresholds:
  http_req_duration: [ "p(95)<1000" ]
  http_req_failed: [ "rate<0.01" ]
  checks: [ "rate>0.95" ]

View raw: examples/01-quickstart.yaml

What it shows

  • ▸constant-vus — a fixed pool of virtual users
  • ▸Inline checks on status and duration
  • ▸thresholds set the process exit code for CI

Key metrics: http_req_duration · http_req_failed · checks.

Load profile · constant VUs

Download & run → Read the docs →