rpk cluster partitions balance

Triggers on-demand partition balancing.

This command allows you to trigger on-demand partition balancing.

With Redpanda Community Edition, the partition count on each broker can easily become uneven, which leads to data skewing. To distribute partitions across brokers, you can run this command to trigger on-demand partition balancing.

With Redpanda Enterprise Edition, Continuous Data Balancing monitors broker and rack availability, as well as disk usage, to avoid topic hotspots. However, there are edge cases where users should manually trigger partition balancing (such as a node becoming unavailable for a prolonged time and rejoining the cluster thereafter). In such cases, you should run this command to trigger partition balancing manually.

After you run this command, monitor the balancer progress using:

rpk cluster partitions balancer-status

To see more detailed movement status, monitor the progress using:

rpk cluster partitions move-status

Usage

rpk cluster partitions balance [flags]

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.