rpk iotune

rpk iotune measures the I/O performance of the hardware used by a Redpanda instance. It writes its parameters to an I/O configuration file that Redpanda reads on startup to optimize its I/O performance. Its benchmarks measure read/write IOPS and bandwidth.

By default rpk iotune writes its output parameters to /etc/redpanda/io-config.yaml.


rpk iotune [flags]


Value Type Description



List of directories to evaluate.



Duration of tests.The value passed is a sequence of decimal numbers, each with optional fraction and a unit suffix, such as 300ms, 1.5s or 2h45m. Valid time units are ns, us (or µs), ms, s, m, h (default 10m0s).

-h, --help


Help for iotune.



Disable confirmation prompt if the iotune file already exists.



The file path where the IO config will be written (default "/etc/redpanda/io-config.yaml").



The maximum time after — to wait for iotune to complete (e.g. 300ms, 1.5s, 2h45m) (default 1h0m0s).



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

-X, --config-opt


Override rpk configuration settings; '-X help' for detail or '-X list' for terser detail.



rpk profile to use.

-v, --verbose


Enable verbose logging.

Example output

Running rpk iotune produces an output file that by default is saved in /etc/redpanda/io-config.yaml.

The contents of an example io-config.yaml:

- mountpoint: /var/lib/redpanda/data
  read_iops: 40952
  read_bandwidth: 5638210048
  write_iops: 6685
  write_bandwidth: 1491679488