Streaming

rpk cluster brokers decommission-status

Show the progress of a node decommissioning.

When a node is being decommissioned, this command reports the decommissioning progress as follows, where PARTITION-SIZE is in bytes. Using -H, it prints the partition size in a human-readable format.

Usage

rpk cluster brokers decommission-status [BROKER ID] [flags]

Example output

For example, to show the progress of decommissioning broker 4, run:

rpk cluster brokers decommission-status 4
DECOMMISSION PROGRESS
=====================
PARTITION      MOVING-TO  COMPLETION-%  PARTITION-SIZE  BYTES-MOVED  BYTES-REMAINING
kafka/test/0   3          13            1731773243      228114727    1503658516
kafka/test/4   3          1             1645952961      18752660     1627200301
kafka/test2/3  3          5             2752632301      140975805    2611656496
kafka/test2/4  3          6             2975443783      181581219    2793862564

If a partition cannot be moved, the command reports the problematic partition in the REALLOCATION FAILURE DETAILS or ALLOCATION FAILURES section and the decommission fails. Typical failure scenarios include no brokers with enough space to allocate a partition, or none that can satisfy rack constraints.

REALLOCATION FAILURE DETAILS
============================
PARTITION    REASON
kafka/foo/1  Missing partition size information, all replicas may be offline
kafka/foo/7  Missing partition size information, all replicas may be offline

Flags

Value Type Description

-d, --detailed

bool

Print how much data moved and remaining in bytes.

--format

string

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

-H, --human-readable

bool

Print the partition size in a human-readable form.

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.