Status

Current state: Under Discussion

...

Please keep the discussion on the mailing list rather than commenting on the wiki (wiki discussions get unwieldy fast).

Motivation

A topic partition can be in one of four states (assuming replication factor of 3):

...

My group is currently one of these cases and we created a script to periodically run the describe-topics command and extract any CRITICAL topic partitions from the output to alert us. The new option in this KIP would allow us to bypass the parsing.

Public Interfaces

This change would only modify kafka-topics.sh script to include an additional option that follows the existing output of the under-replicated-partitions and offline-partitions options.

Proposed Changes

When a user has specified the --critical-partitions option, TopicCommand will only print out topic partitions with ISR count equal to 1 if the replication factor of the topic is greater than 1.

...

The output will be in the same exact format as the --under-replicated-partitions and --unavailable-partitions options.

Compatibility, Deprecation, and Migration Plan

As this change adds a new option instead of modifying existing ones, there will not be any compatibility issues or a migration.

Rejected Alternatives

single-replica-partitions option

...