KAFKA-13298: Improve documentation on EOS KStream requirements (#11355)

Reviewer: Matthias J. Sax <matthias@confluent.io>
This commit is contained in:
Andy Chambers 2021-10-06 03:07:13 +01:00 committed by GitHub
parent 1a3e23a579
commit 1573c707e6
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 9 additions and 1 deletions

View File

@ -736,7 +736,15 @@ streamsConfiguration.put(StreamsConfig.DEFAULT_TIMESTAMP_EXTRACTOR_CLASS_CONFIG,
and <code class="docutils literal"><span class="pre">transaction.state.log.min.isr</span></code>
to the number of brokers you want to use.
For more details see <a href="../core-concepts#streams_processing_guarantee">Processing Guarantees</a>.
</div></blockquote>
<dl class="docutils">
<dt>Recommendation:</dt>
<dd>While it is technically possible to use EOS with any replication factor, using a replication factor lower
than 3 effectively voids EOS. Thus it is strongly recommended to use a replication factor of 3 (together with
<code>min.in.sync.replicas=2</code>). This recommendation applies to all topics (i.e. <code>__transaction_state</code>,
<code>__consumer_offsets</code>, Kafka Streams internal topics, and user topics).</dd>
</dl>
</div></blockquote>
</div>
<div class="section" id="replication-factor">
<span id="replication-factor-parm"></span><h4><a class="toc-backref" href="#id13">replication.factor</a><a class="headerlink" href="#replication-factor" title="Permalink to this headline"></a></h4>