rpk redpanda admin brokers list

This command is not supported on macOS, Windows.

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:

Column 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

Additional exclusive identifier for a broker (Optional).
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.

Usage

rpk redpanda admin brokers list [flags]
bash

Aliases

list, ls
bash

Flags

Value Type Description

-d, --include-decommissioned

-

Include decommissioned brokers.

-h, --help

-

Help for list.

--config

string

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

-X, --config-opt

stringArray

Override rpk configuration settings. See rpk -X or execute rpk -X help for inline detail or rpk -X list for terser detail.

--profile

string

Profile to use. See rpk profile for more details.

-v, --verbose

-

Enable verbose logging.