# rpk cluster partitions balancer-status

> For the complete documentation index, see [llms.txt](https://docs.redpanda.com/llms.txt). Component-specific: [streaming-full.txt](https://docs.redpanda.com/streaming-full.txt)

---
title: rpk cluster partitions balancer-status
latest-redpanda-tag: v26.1.14
latest-console-tag: v3.9.0
latest-operator-version: v26.2.1
# EOL = End-of-Life (support lifecycle status)
page-is-nearing-eol: "false"
page-is-past-eol: "false"
page-eol-date: March 31, 2027
latest-connect-version: 4.104.0
docname: rpk/rpk-cluster/rpk-cluster-partitions-balancer-status
page-component-name: streaming
page-version: "26.1"
page-component-version: "26.1"
page-component-title: Streaming
page-relative-src-path: rpk/rpk-cluster/rpk-cluster-partitions-balancer-status.adoc
page-edit-url: https://github.com/redpanda-data/docs/edit/v/26.1/modules/reference/pages/rpk/rpk-cluster/rpk-cluster-partitions-balancer-status.adoc
description: "Queries cluster for partition balancer status: If continuous partition balancing is enabled, Redpanda will continuously reassign partitions from both unavailable nodes and from nodes using more disk space than the configured limit. Use this command to monitor the partition balancer status and the partition distribution across brokers in the cluster."
page-git-created-date: "2023-05-17"
page-git-modified-date: "2026-07-17"
support-status: supported
---

<!-- Source: https://docs.redpanda.com/streaming/26.1/reference/rpk/rpk-cluster/rpk-cluster-partitions-balancer-status.md -->

Queries cluster for partition balancer status:

If continuous partition balancing is enabled, Redpanda will continuously reassign partitions from both unavailable nodes and from nodes using more disk space than the configured limit.

Use this command to monitor the partition balancer status and the partition distribution across brokers in the cluster.

## [](#usage)Usage

```bash
rpk cluster partitions balancer-status [flags]
```

### [](#fields)Fields

| Value | Description |
| --- | --- |
| Status | Either off, ready, starting, in progress, or stalled. |
| Seconds Since Last Tick | The last time the partition balancer ran. |
| Current Reassignments Count | Current number of partition reassignments in progress. |
| Unavailable Nodes | The nodes that have been unavailable after a time set by the "partition_autobalancing_node_availability_timeout_sec" cluster property. |
| Over Disk Limit Nodes | The nodes that surpassed the threshold of used disk percentage specified in the "partition_autobalancing_max_disk_usage_percent" cluster property. |

### [](#balancer-status)Balancer Status

| Value | Description |
| --- | --- |
| off | The balancer is disabled. |
| ready | The balancer is active but there is nothing to do. |
| starting | The balancer is starting but has not run yet. |
| in_progress | The balancer is active and is in the process of scheduling partition movements. |
| stalled | Violations have been detected and the balancer cannot correct them. |

### [](#stalled-balancer)Stalled Balancer

A stalled balancer can occur for a few reasons and requires a bit of manual investigation. A few areas to investigate:

-   Are there are enough healthy nodes to which to move partitions? For example, in a three node cluster, no movements are possible for partitions with three replicas. You will see a stall every time there is a violation.

-   Does the cluster have sufficient space? If all nodes in the cluster are utilizing more than 80% of their disk space, rebalancing cannot proceed.

-   Do all partitions have quorum? If the majority of a partition’s replicas are down, the partition cannot be moved.

-   Are any nodes in maintenance mode? Partitions are not moved if any node is in maintenance mode.


## [](#global-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. |