Streaming

rpk redpanda admin brokers list

List the brokers in your cluster.

This command lists all brokers in the cluster, active and inactive, unless they have been decommissioned. Using the “--include-decommissioned” flag, it lists decommissioned brokers with associated UUIDs too.

The output table contains the following columns:

Value Description

ID

Node ID, an exclusive identifier for a broker

HOST

Internal RPC address for communication between brokers

PORT

Internal RPC port for communication between brokers

RACK

Assigned rack ID

CORES

Number of cores (shards) on a broker

MEMBERSHIP

Whether a broker is decommissioned or not

IS-ALIVE

Whether a broker is alive or offline

VERSION

Broker version

UUID (Optional)

Additional exclusive identifier for a broker
The UUID column is hidden when the cluster doesn’t expose the UUID in the Admin API, or the API call fails to retrieve UUIDs.

Use the --detailed flag to display an additional DISK SPACE section showing per-mount-path disk usage for each broker. The disk space table has the following columns:

Value Description

NODE-ID

Broker node ID

PATH

Mount path on the broker

FREE

Free disk space (human-readable)

TOTAL

Total disk space (human-readable)

USED%

Percentage of disk space used

When using --format json or --format yaml, disk space information is always included regardless of the --detailed flag.

Usage

rpk redpanda admin brokers list [flags]

Aliases

rpk redpanda admin brokers ls

Flags

Value Type Description

--detailed

bool

If true, include per-broker disk space information.

--format

string

Output format (json,yaml,text,wide,help).

-d, --include-decommissioned

bool

If true, include decommissioned brokers.

Global flags

Value Type Description

--config

string

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

-X, --config-opt

stringArray

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

--ignore-profile

bool

Ignore rpk.yaml and redpanda.yaml; use default settings.

--profile

string

rpk profile to use.

-v, --verbose

bool

Enable verbose logging.