Perf

The perf subcommand is a producer and (soon) consumer performance test. The command is under development, the format of the output may change to make it easier to process the output with other tooling.

Usage: tansu perf [OPTIONS] <TOPIC> <COMMAND>

Commands:
  produce  Produce messages
  consume  
  help     Print this message or the help of the given subcommand(s)

Arguments:
  <TOPIC>  The topic to generate messages into

Options:
      --broker <BROKER>  The URL of the broker [env: ADVERTISED_LISTENER_URL=tcp://localhost:9092] [default: tcp://localhost:9092]
  -h, --help             Print help

The perf subcommand will automatically load environment variables from a file named .env in the current directory or any of its parents.

Example

You can generate a producer load on the test topic using:

tansu perf test produce \
  --throughput=1MiB/s \
  --producers=1 \
  --duration=10s \
  --batch-size=1 \
  --record-size=1k

Where:

• throughput is a human units measure of the total throughput.
• producers are the number of concurrent producers used to generate the throughput.
• duration is the human units measure of the duration of the performance test.
• batch-size is the number of records in each produce request. Can be used to simulate clients the batch records together or those that single shot.
• record-size is the size of each record in the batch in human units.