Skip to content

MINOR: Clarify consumer behaviour on partition pause & re-assignments #22538

Open
lianetm wants to merge 3 commits into
apache:trunkfrom
lianetm:lm-paused-doc
Open

MINOR: Clarify consumer behaviour on partition pause & re-assignments #22538
lianetm wants to merge 3 commits into
apache:trunkfrom
lianetm:lm-paused-doc

Conversation

@lianetm

@lianetm lianetm commented Jun 10, 2026

Copy link
Copy Markdown
Member

Clarify docs for pause flag behaviour when a re-assignment happens
(either manual or via rebalance). It was confusing, stating that the
flag was not preserved (it is preserved for partitions that remain
assigned + lost for partitions that move to another consumer)

Add tests to cover the behaviour for both consumers

Reviewers: TengYao Chi frankvicky@apache.org, David Jacot
david.jacot@gmail.com

@frankvicky frankvicky left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM assuming CI passsed

@dajac dajac left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@lianetm Thanks for the patch. I left one comment about the doc part.

Comment on lines +1528 to +1531
* The eager rebalance protocol revokes all partitions on every rebalance,
* so under that protocol no pause/resume state is preserved; the cooperative rebalance protocol and
* the consumer group protocol (KIP-848) only revoke partitions that are no longer assigned, so the pause/resume
* state of partitions that remain assigned to this consumer is preserved.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

small nit: We should use the classic vs consumer language here to align with the config. I would also give example of an assignor for each sub-mode of the classic one. I don't think people really understand eager vs cooperative.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

makes sense, updated

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants