rpk cluster self-test start

Starts one or more benchmark tests on one or more nodes of the cluster.

Available tests to run:

  • Disk tests

    • Throughput test: 512 KB messages, sequential read/write

      • Uses a larger request message sizes and deeper I/O queue depth to write/read more bytes in a shorter amount of time, at the cost of IOPS/latency.

    • Latency test: 4 KB messages, sequential read/write

      • Uses smaller request message sizes and lower levels of parallelism to achieve higher IOPS and lower latency.

  • Network tests

    • Throughput test: 8192-bit messages

      • Unique pairs of Redpanda nodes each act as a client and a server.

      • The test pushes as much data over the wire, within the test parameters.

This command immediately returns on success, and the tests run asynchronously. The user polls for results with the rpk cluster self-test status command.


rpk cluster self-test start [flags]


Value Type Description



uint The in milliseconds of individual disk test runs (default 30000).

-h, --help


Help for start.



uint The in milliseconds of individual network test runs (default 30000).



Acknowledge warning prompt skipping read from stdin.



Runs only the disk benchmarks.



Runs only network benchmarks.



ints IDs of nodes that the tests will run on. If not set, tests will run for all node IDs.



Redpanda or rpk config file; default search paths are /var/lib/redpanda/.config/rpk/rpk.yaml, $PWD/redpanda.yaml, and /etc/redpanda/redpanda.yaml.

-X, --config-opt


Override rpk configuration settings. See rpk -X or execute rpk -X help for inline detail or rpk -X list for terser detail.



Profile to use. See rpk profile for more details.

-v, --verbose


Enable verbose logging.