24.1 beta 23.3 23.2 23.1

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
=====================
NAMESPACE-TOPIC              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
=====================
NAMESPACE-TOPIC  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 for some reason a partition cannot be moved, the command reports the problematic partition in the 'ALLOCATION FAILURES' section and the decommission fails. A typical failure scenario would be when no node has enough space to allocate a partition, or cannot satisfy rack constraints.

ALLOCATION FAILURES
==================
kafka/foo/2
kafka/test/0

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.