An under-replicated partition is a Kafka partition whose available in-sync replicas do not currently satisfy its configured replication requirements. It signals reduced replication health and possible data-durability risk. section 11.1.2 section 11.2.2
Treat the condition as an operational signal with architectural consequences:
- Monitor the number of under-replicated partitions alongside offline partitions to detect replication imbalance and durability risk. section 11.2.2
- Handle broker removal through planned reassignment and leadership migration; shutting down first can leave partitions under-replicated. section 11.1.2
- Restore a failed broker’s replicas to the in-sync replica set by allowing them to catch up before declaring the cluster healthy. section 9.1.3
Broker failure and failover
When a broker fails, the controller selects new leaders from the in-sync replica set. If no in-sync replica is available, the partition becomes under-replicated. With unclean leader election disabled, it may remain offline to preserve consistency; with it enabled, an out-of-sync replica may become leader to prioritize availability. Clients may see transient replica-not-available errors until refreshed metadata directs them to the new leaders. section 9.1.3

