Streaming

rpk cluster partitions list

List partitions in the cluster. This command lists the cluster-level metadata of all partitions, including current replica assignments on brokers and CPU cores for given topics.

Enabled/Disabled

Disabling a partition in Redpanda involves prohibiting any data consumption or production to and from it. All internal processes associated with the partition are stopped, and it remains unloaded during system startup. This measure aims to maintain cluster health by preventing issues caused by specific corrupted partitions that may lead to Redpanda crashes. Although the data remains stored on disk, Redpanda ceases interaction with the disabled partitions to ensure system stability. You may disable/enable partitions using rpk cluster partitions enable/disable.

Usage

rpk cluster partitions list <topics...> [flags]

Aliases

rpk cluster partitions ls
rpk cluster partitions describe

Examples

This section provides examples of how to use rpk cluster partitions list.

List all partitions in the cluster.

rpk cluster partitions list --all

List all partitions in the cluster, filtering for topic foo and bar.

rpk cluster partitions list foo bar

List partitions with replicas that are assigned to brokers 1 and 2..

rpk cluster partitions list foo --node-ids 1,2

List only the disabled partitions.

rpk cluster partitions list -a --disabled-only

List all in JSON format.

rpk cluster partitions list -a --format json

Flags

Value Type Description

-a, --all

bool

List all partitions in the cluster.

--disabled-only

bool

List disabled partitions only.

--format

string

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

-n, --node-ids

intSlice

List of comma-separated broker IDs that you wish to filter the results with.

-p, --partition

intSlice

List of comma-separated partitions IDs that you wish to filter the results with.

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.