Streaming

rpk redpanda admin brokers decommission-status

This command is not supported on macOS, Windows.

Show the progress of a broker decommissioning.

When a node is in the process of 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.

$ rpk redpanda admin brokers decommission-status 4
DECOMMISSION PROGRESS
=====================
PARTITION                        MOVING-TO  COMPLETION-%  PARTITION-SIZE
kafka/test/0                     3          9             1699470920
kafka/test/4                     3          0             1614258779
kafka/test2/3                    3          3             2722706514
kafka/test2/4                    3          4             2945518089
kafka_internal/id_allocator/0    3          0             3562

Using --detailed / -d, it additionally prints granular reports.

$ rpk redpanda admin brokers decommission-status 4 -d
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 for some reason, the command reports the problematic partition in the 'REALLOCATION FAILURE DETAILS' or 'ALLOCATION FAILURES' section, and decommission fails. Typical scenarios for failure include:

  • Insufficient broker storage space to allocate a partition

  • Brokers that cannot 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

Usage

rpk redpanda admin brokers decommission-status [BROKER ID] [flags]

Flags

Value Type Description

-d, --detailed

-

Print how much data moved and remaining in bytes.

-H, --human-readable

-

Print the partition size in a human-readable form.

-h, --help

-

Help for decommission-status.

--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.