You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@kafka.apache.org by mj...@apache.org on 2021/02/17 01:14:14 UTC
[kafka] 02/02: MINOR: Clarify config names for EOS versions 1 and 2
(#9670)
This is an automated email from the ASF dual-hosted git repository.
mjsax pushed a commit to branch 2.8
in repository https://gitbox.apache.org/repos/asf/kafka.git
commit 123eff618f50721140ccd368ed7f966f581ada90
Author: Jim Galasyn <ji...@confluent.io>
AuthorDate: Tue Feb 16 17:11:24 2021 -0800
MINOR: Clarify config names for EOS versions 1 and 2 (#9670)
Reviewers: Boyang Chen <bo...@confluent.io>, Matthias J. Sax <ma...@confluent.io>
---
docs/streams/core-concepts.html | 2 +-
docs/streams/developer-guide/config-streams.html | 6 +++---
docs/streams/upgrade-guide.html | 11 ++++++-----
3 files changed, 10 insertions(+), 9 deletions(-)
diff --git a/docs/streams/core-concepts.html b/docs/streams/core-concepts.html
index ddb37ea..7391c02 100644
--- a/docs/streams/core-concepts.html
+++ b/docs/streams/core-concepts.html
@@ -300,7 +300,7 @@
To enable exactly-once semantics when running Kafka Streams applications,
set the <code>processing.guarantee</code> config value (default value is <b>at_least_once</b>)
- to <b>exactly_once</b> (requires brokers version 0.11.0 or newer) or <b>exactly_once_beta</b> (requires brokers version 2.5 or newer).
+ to <b>exactly_once</b> for EOS version 1 (requires brokers version 0.11.0 or newer) or <b>exactly_once_beta</b> for EOS version 2 (requires brokers version 2.5 or newer).
For more information, see the <a href="/{{version}}/documentation/streams/developer-guide/config-streams.html">Kafka Streams Configs</a> section.
</p>
diff --git a/docs/streams/developer-guide/config-streams.html b/docs/streams/developer-guide/config-streams.html
index 07b47c0..fe35026 100644
--- a/docs/streams/developer-guide/config-streams.html
+++ b/docs/streams/developer-guide/config-streams.html
@@ -294,7 +294,7 @@
<tr class="row-even"><td>processing.guarantee</td>
<td>Medium</td>
<td colspan="2">The processing mode. Can be either <code class="docutils literal"><span class="pre">"at_least_once"</span></code> (default),
- <code class="docutils literal"><span class="pre">"exactly_once"</span></code>, or <code class="docutils literal"><span class="pre">"exactly_once_beta"</span></code></td>.
+ <code class="docutils literal"><span class="pre">"exactly_once"</span></code> (for EOS version 1), or <code class="docutils literal"><span class="pre">"exactly_once_beta"</span></code> (for EOS version 2)</td>.
<td>See <a class="reference internal" href="#streams-developer-guide-processing-guarantedd"><span class="std std-ref">Processing Guarantee</span></a></td>
</tr>
<tr class="row-odd"><td>poll.ms</td>
@@ -668,8 +668,8 @@
<blockquote>
<div>The processing guarantee that should be used.
Possible values are <code class="docutils literal"><span class="pre">"at_least_once"</span></code> (default),
- <code class="docutils literal"><span class="pre">"exactly_once"</span></code>,
- and <code class="docutils literal"><span class="pre">"exactly_once_beta"</span></code>.
+ <code class="docutils literal"><span class="pre">"exactly_once"</span></code> (for EOS version 1),
+ and <code class="docutils literal"><span class="pre">"exactly_once_beta"</span></code> (for EOS version 2).
Using <code class="docutils literal"><span class="pre">"exactly_once"</span></code> requires broker
version 0.11.0 or newer, while using <code class="docutils literal"><span class="pre">"exactly_once_beta"</span></code>
requires broker version 2.5 or newer.
diff --git a/docs/streams/upgrade-guide.html b/docs/streams/upgrade-guide.html
index 7bb2971..2a6a760 100644
--- a/docs/streams/upgrade-guide.html
+++ b/docs/streams/upgrade-guide.html
@@ -53,8 +53,9 @@
</ul>
<p>
- Starting in Kafka Streams 2.6.x, a new processing mode <code>"exactly_once_beta"</code> (configurable via parameter
- <code>processing.guarantee</code>) is available.
+ Starting in Kafka Streams 2.6.x, a new processing mode is available, named EOS version 2, which is configurable by setting
+ <code>processing.guarantee</code> to <code>"exactly_once_beta"</code>.
+ <b>NOTE:</b> The <code>"exactly_once_beta"</code> processing mode is ready for production (<i>i.e.</i>, it's not "beta" software).
To use this new feature, your brokers must be on version 2.5.x or newer.
A switch from <code>"exactly_once"</code> to <code>"exactly_once_beta"</code> (or the other way around) is
only possible if the application is on version 2.6.x.
@@ -162,7 +163,7 @@
<h3><a id="streams_api_changes_260" href="#streams_api_changes_260">Streams API changes in 2.6.0</a></h3>
<p>
- We added a new processing mode that improves application scalability using exactly-once guarantees
+ We added a new processing mode, EOS version 2, that improves application scalability using exactly-once guarantees
(via <a href="https://cwiki.apache.org/confluence/display/KAFKA/KIP-447%3A+Producer+scalability+for+exactly+once+semantics">KIP-447</a>).
You can enable this new feature by setting the configuration parameter <code>processing.guarantee</code> to the
new value <code>"exactly_once_beta"</code>.
@@ -894,9 +895,9 @@
<p> Metrics using exactly-once semantics: </p>
<p>
- If <code>"exactly_once"</code> processing is enabled via the <code>processing.guarantee</code> parameter,
+ If <code>"exactly_once"</code> processing (EOS version 1) is enabled via the <code>processing.guarantee</code> parameter,
internally Streams switches from a producer-per-thread to a producer-per-task runtime model.
- Using <code>"exactly_once_beta"</code> does use a producer-per-thread, so <code>client.id</code> doesn't change,
+ Using <code>"exactly_once_beta"</code> (EOS version 2) does use a producer-per-thread, so <code>client.id</code> doesn't change,
compared with <code>"at_least_once"</code> for this case).
In order to distinguish the different producers, the producer's <code>client.id</code> additionally encodes the task-ID for this case.
Because the producer's <code>client.id</code> is used to report JMX metrics, it might be required to update tools that receive those metrics.