Plugins

Install only what you need

loadr ships a small core. Heavy protocol drivers are delivered as runtime plugins — they load at runtime, on demand, and are never baked into the binary. One loadr plugin install <name> pulls a driver from the signed index, then a request to its URL scheme just works.

Resolved from a signed index SHA-256 verified ABI-checked at load

Protocol adapters

10/10 available

Drive the system under test at its native protocol.

M

MongoDB

mongodb://

Insert, find, update, aggregate and command — one operation per request, on the official Mongo driver.

DatabaseView plugin →
P

PostgreSQL

postgres://

Parameterised SELECT / INSERT / UPDATE bound with $1, $2 … and pooled per VU via sqlx.

DatabaseView plugin →
M

MySQL

mysql://

One query per request over the MySQL wire protocol, safely bound and pooled per VU.

DatabaseView plugin →
R

Redis

redis://

Speak RESP over TCP — SET, GET, INCR, EXPIRE and the rest, one command per request.

CacheView plugin →
A

Apache Kafka

kafka://

Produce and fetch against a broker, one operation per request — pure-Rust, no librdkafka.

MessagingView plugin →
R

RabbitMQ

amqp://

Publish and consume over AMQP 0.9.1, declaring queues inline — the pure-Rust lapin client.

MessagingView plugin →
E

Elasticsearch

elasticsearch://

Index, get, search and bulk over the HTTP/JSON API — on loadr's own hyper stack.

SearchView plugin →
N

NATS

Publish and request/reply over the NATS line protocol, one op per request.

availableView plugin →
M

MQTT

Publish and subscribe over MQTT 3.1.1/5.0 with per-VU sessions.

availableView plugin →
C

Cassandra / ScyllaDB

One bound CQL statement per request over the native protocol.

availableView plugin →

Data sources & feeders

4/4 available

Feed the test — stream rows and datasets into VUs.

R

Redis data loader

Feed VUs values from a Redis list/stream over raw RESP — a distributed feeder.

availableView plugin →
S

SQL feeder

Feed rows from a Postgres/MySQL query into the run, shared across VUs.

availableView plugin →
S

S3 dataset

Stream a dataset object from S3 with a pure-Rust SigV4 signer.

availableView plugin →
S

Synthetic data

Generate deterministic synthetic feeder rows — names, emails, UUIDs, numbers.

availableView plugin →

Outputs & exporters

5/5 available

Send results somewhere — dashboards, stores, chat, reports.

D

Datadog

Ship metrics to the Datadog API over HTTPS, batched with retries.

availableView plugin →
S

Slack notifier

Post the run summary and threshold breaches to a Slack webhook.

availableView plugin →
W

Webhook

POST run snapshots/summary as JSON to any HTTP endpoint.

availableView plugin →
S

S3 archive

Archive the final report/metrics as an object to S3 (SigV4).

availableView plugin →
J

JUnit report

Write a JUnit XML report of checks and thresholds for CI.

availableView plugin →

Observability collectors

3/3 available

Pull system metrics to correlate against the load.

C

CloudWatch

PutMetricData to AWS CloudWatch, and pull metrics back to correlate.

availableView plugin →
O

OTLP metrics

Export/collect metrics via OTLP to an OpenTelemetry collector.

availableView plugin →
K

Kubernetes metrics

Collect pod/node metrics from the Kubernetes metrics API during a run.

availableView plugin →

Extractors

4/4 available

Pull values out of responses (WASM plugins).

J

JWT decode

Decode a JWT and extract claims into variables.

availableView plugin →
X

XPath

Extract values from XML/HTML responses with XPath.

availableView plugin →
C

CSS selector

Extract text/attributes from HTML with CSS selectors.

availableView plugin →
P

Protobuf decode

Decode a protobuf message body and extract fields.

availableView plugin →

Assertions & validators

3/3 available

Custom correctness checks (WASM plugins).

J

JSON Schema

Validate a response body against a JSON Schema.

availableView plugin →
O

OpenAPI contract

Assert responses conform to an OpenAPI operation's schema.

availableView plugin →
R

Response signature

Verify a response's HMAC/RSA signature header.

availableView plugin →

Auth & signers

4/4 available

Inject credentials — tokens, signatures, secrets.

O

OAuth2 minter

Mint, cache and refresh OAuth2 tokens; serve them to VUs.

availableView plugin →
A

AWS SigV4 signer

Return SigV4 Authorization headers for arbitrary AWS requests.

availableView plugin →
H

HMAC signer

Serve HMAC-SHA256 request signatures for signed-request auth.

availableView plugin →
V

Vault fetch

Fetch secrets from HashiCorp Vault (KV v2) into the run.

availableView plugin →

Fixtures & lifecycle

3/3 available

Set up and tear down state around a run.

D

DB seeder

Run seed SQL on start and clean up on stop — a DB fixture.

availableView plugin →
T

Testcontainers

Spin ephemeral service containers up for a run and down after.

availableView plugin →
D

Data cleanup

Run cleanup commands on stop() to reset state after a run.

availableView plugin →

How install works

Resolve, verify, load

loadr plugin install <name> resolves the name in a signed plugin index — a versioned JSON catalogue that maps a short name to the right per-platform artifact. loadr picks the artifact for your host target, checks its declared ABI against the one your build provides, downloads it, verifies its SHA-256 against the index, unpacks it and installs it under your plugins directory. The native loader re-checks the abi_stable layout at load time as a second line of defence.

Find & install from the index
# search the catalogue, then install for this host
$ loadr plugin search mongo
$ loadr plugin install mongo
resolved mongo 1.1.0 (x86_64-unknown-linux-gnu)
sha256 verified ✓   abi 1.0 ✓
installed → ~/.loadr/plugins/mongo
Pin, update, inspect
# pin a version or override the host target
$ loadr plugin install postgres --version 1.1.0
# re-install newer, ABI-compatible builds
$ loadr plugin update
# list / inspect what's installed
$ loadr plugin list
$ loadr plugin info mysql

Full reference: Installing plugins · Plugin overview

Write your own plugin

The same model is open to you. Ship a new protocol, output or helper as a native (abi_stable) or WASM plugin, declare its URL schemes, publish it to an index — and anyone can loadr plugin install it.

Write your own → Publish to an index