Skip to content

MINOR: Document transaction.timeout.ms behavior under EOS in Streams config guide#22067

Open
lucasbru wants to merge 2 commits intoapache:trunkfrom
lucasbru:minor-streams-doc-transaction-timeout-ms
Open

MINOR: Document transaction.timeout.ms behavior under EOS in Streams config guide#22067
lucasbru wants to merge 2 commits intoapache:trunkfrom
lucasbru:minor-streams-doc-transaction-timeout-ms

Conversation

@lucasbru
Copy link
Copy Markdown
Member

@lucasbru lucasbru commented Apr 15, 2026

The Streams configuration guide already lists transaction.timeout.ms and
its default, but it is easy to overlook when enabling exactly-once
processing. This adds a short note directly under the
processing.guarantee section to make it more obvious that users should
consider the transaction timeout when tuning EOS applications, including
the broker-side constraint (transaction.max.timeout.ms) and the
trade-offs of increasing the value.

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Adds missing documentation to the Kafka Streams configuration guide about the default transaction.timeout.ms behavior when exactly-once processing is enabled, including how to override it and key trade-offs.

Changes:

  • Document that Streams sets transaction.timeout.ms to 10s by default under EOS.
  • Explain how to increase the timeout and the broker-side cap (transaction.max.timeout.ms).
  • Note operational trade-offs of larger timeouts (zombie fencing delay, read_committed stalling).

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread docs/streams/developer-guide/config-streams.md Outdated
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs small Small PRs

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants