Skip to main content
Version: 23.1

rpk cluster metadata

Request broker metadata.

The Kafka protocol's metadata contains information about brokers, topics, and the cluster as a whole.

This command only runs if specific sections of metadata are requested. There are currently three sections: the cluster, the list of brokers, and the topics. If no section is specified, this defaults to printing all sections.

If the topic section is requested, all topics are requested by default unless some are manually specified as arguments. Expanded per-partition information can be printed with the -d flag, and internal topics can be printed with the -i flag.

In the broker section, the controller node is suffixed with \*.


rpk cluster metadata [flags]


metadata, status, info


-h, --help-Help for metadata.
-b, --print-brokers-Print brokers section.
-c, --print-cluster-Print cluster section.
-d, --print-detailed-topics-Print per-partition information for topics (implies -t).
-i, --print-internal-topics-Print internal topics (if all topics requested, implies -t).
-t, --print-topics-Print topics section (implied if any topics are specified).
--brokersstringsComma-separated list of broker <ip>:<port> pairs (for example,--brokers `,,`). Alternatively, you may set the REDPANDA_BROKERSenvironment variable with the comma-separated list of broker addresses.
--configstringRedpanda config file, if not set the file will be searched for in the default locations.
--passwordstringSASL password to be used for authentication.
--sasl-mechanismstringThe authentication mechanism to use. Supported values: SCRAM-SHA-256, SCRAM-SHA-512.
--tls-certstringThe certificate to be used for TLS authentication with the broker.
--tls-enabled-Enable TLS for the Kafka API (not necessary if specifying custom certs).
--tls-keystringThe certificate key to be used for TLS authentication with the broker.
--tls-truststorestringThe truststore to be used for TLS communication with the broker.
--userstringSASL user to be used for authentication.
-v, --verbose-Enable verbose logging (default false).

What do you like about this doc?

Optional: Share your email address if we can contact you about your feedback.

Let us know what we do well: