OS Manuals

/usr/lib/kafka/bin/kafka-consumer-perf-test.sh

Community edition of Confluent Kafka.

From confluent-kafka 8.4.0.215-r1 (os), captured 2026-11-10 by running kafka-consumer-perf-test.sh --help (exit 1). permalink

This tool is used to verify the consumer performance.
Option                                   Description
------                                   -----------
--bootstrap-server <String: server to    REQUIRED: The server(s) to connect to.
  connect to>
--command-config <String: config file>   Config properties file.
--command-property <String: prop1=val1>  Kafka consumer related configuration
                                           properties like client.id. These
                                           configs take precedence over those
                                           passed via --command-config or --
                                           consumer.config.
--consumer.config <String: config file>  (DEPRECATED) Consumer config
                                           properties file. This option will be
                                           removed in a future version. Use --
                                           command-config instead.
--date-format <String: date format>      The date format to use for formatting
                                           the time field. See java.text.
                                           SimpleDateFormat for options.
                                           (default: yyyy-MM-dd HH:mm:ss:SSS)
--fetch-size <Integer: size>             The maximum amount of data to fetch
                                           from a single partition per request.
                                           (default: 1048576)
--from-latest                            If the consumer does not already have
                                           an established offset to consume
                                           from, start with the latest record
                                           present in the log rather than the
                                           earliest record.
--group <String: gid>                    The group id to consume on. (default:
                                           perf-consumer-84567)
--help                                   Print usage information.
--hide-header                            If set, skips printing the header for
                                           the stats.
--include <String: Java regex (String)>  Regular expression specifying list of
                                           topics to include for consumption.
--messages <Long: count>                 (DEPRECATED) The number of records to
                                           consume. This option will be removed
                                           in a future version. Use --num-
                                           records instead.
--num-records <Long: count>              REQUIRED: The number of records to
                                           consume.
--print-metrics                          Print out the metrics.
--reporting-interval <Long:              Interval in milliseconds at which to
  interval_ms>                             print progress info. (default: 5000)
--show-detailed-stats                    If set, stats are reported for each
                                           reporting interval as configured by
                                           reporting-interval.
--socket-buffer-size <Integer: size>     The size of the tcp RECV size.
                                           (default: 2097152)
--timeout [Long: milliseconds]           The maximum allowed time in
                                           milliseconds between returned
                                           records. (default: 10000)
--topic <String: topic>                  The topic to consume from.
--version                                Display Kafka version.
Options (20)
OptionDescriptionSource
--bootstrap-server String:REQUIRED: The server(s) to connect to.help
--command-config String:Config properties file.help
--command-property String:Kafka consumer related configuration properties like client.id.help
--consumer.config String:(DEPRECATED) Consumer config properties file.help
--date-format String:The date format to use for formatting the time field.help
--fetch-size Integer:The maximum amount of data to fetch from a single partition per request.help
--from-latestIf the consumer does not already have an established offset to consume from, start with the latest record present in the log rather than the earliest record.help
--group String:The group id to consume on.help
--helpPrint usage information.help
--hide-headerIf set, skips printing the header for the stats.help
--include String:Regular expression specifying list of topics to include for consumption.help
--messages Long:(DEPRECATED) The number of records to consume.help
--num-records Long:REQUIRED: The number of records to consume.help
--print-metricsPrint out the metrics.help
--reporting-interval Long:Interval in milliseconds at which to interval_ms> print progress info.help
--show-detailed-statsIf set, stats are reported for each reporting interval as configured by reporting-interval.help
--socket-buffer-size Integer:The size of the tcp RECV size.help
--timeout Long:The maximum allowed time in milliseconds between returned records.help
--topic String:The topic to consume from.help
--versionDisplay Kafka version.help

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.