Commit Graph

62 Commits

Author SHA1 Message Date
Lucas Brutschy 7ab7773617
MINOR: Update 3.8 documentation for Kafka Streams (#16265)
All public interface changes should be briefly mentioned in the
upgrade guide.

Reviewers: Matthias J. Sax <matthias@confluent.io>, Anna Sophie Blee-Goldman <sophie@responsive.dev>, Nick Telford <nick.telford@gmail.com>
2024-06-26 13:55:18 +02:00
Jim Galasyn 6448a59653
KAFKA-16911: Update docs for KIP-862 (#16246)
Reviewers: Matthias J. Sax <matthias@confluent.io>
2024-06-07 10:52:47 -07:00
Lucia Cerchie 31528f581d
KAFKA-15307: update/note deprecated configs (#14360)
Configs default.windowed.value.serde.inner and default.windowed.key.serde.inner
were replace with windowed.inner.class.serde. This PR updates the docs accordingly,
plus a few more side cleanups.

Reviewers: Matthias J. Sax <matthias@confluent.io>
2024-05-09 19:46:00 -07:00
Matthias J. Sax 612a1fe1bb
MINOR: Kafka Streams docs fixes (#15517)
- add missing section to TOC
- add default value for client.id

Reviewers: Lucas Brutschy <lbrutschy@confluent.io>, Bruno Cadonna <bruno@confluent.io>
2024-03-13 21:54:06 -07:00
Ayoub Omari 65596d0a23
KAFKA-14404: fix overlap of streams-config sections & describe additional parameters (#15162)
There is an overlap between two sections in the current version of streams-config.html as described in KAFKA-14404.
The goal of this fix is to remove the overlap as well as describing some other parameters and their default values

Reviewers: Anna Sophie Blee-Goldman <ableegoldman@apache.org>, Matthias Sax <mjsax@apache.org>
2024-01-24 14:04:43 -08:00
Almog Gavra ecf5550aa8
KAFKA-15215: docs for KIP-954 (#14949)
Upgrade guide and config docs for KIP-954, adding the new dsl.store.suppliers config for default store configuration

Reviewers: Anna Sophie Blee-Goldman <ableegoldman@apache.org>, Matthias Sax <mjsax@apache.org>
2024-01-02 10:44:24 -08:00
Hao Li 4d7a7740f1
MINOR: docs for rack aware assignment (#14999)
Part of KIP-925.

Reviewers: Matthias J. Sax <matthias@confluent.io>
2023-12-19 01:12:02 -08:00
Lucia Cerchie 01c7c7a399
KAFKA-15307: Removes non-existent configs (#14341)
`partition.grouper` was removed in 3.0 release.

Reviewers: Matthias J. Sax <matthias@confluent.io>
2023-09-07 12:58:13 -07:00
Hao Li 4268e502ec
KAFKA-15022: [10/N] docs for rack aware assignor (#14181)
Reviewers: Matthias J. Sax <matthias@confluent.io>
2023-08-11 11:40:33 -07:00
Matthias J. Sax 7a2e11cae7
MINOR: update Kafka Streams state.dir doc (#14155)
Default state directory was changes in 2.8.0 release (cf KAFKA-10604)

Reviewers: Guozhang Wang <wangguoz@gmail.com>
2023-08-06 10:20:08 -07:00
Iblis Lin e4af074b4c
MINOR: doc: fix typo in config-streams (#13450)
Reviewers: Chia-Ping Tsai <chia7712@gmail.com>
2023-03-26 00:00:53 +08:00
littlehorse-eng a6d8988179
MINOR: Clarify docs for Streams config max.warmup.replicas. (#13082)
Documentation only—Minor clarification on how max.warmup.replicas works; specifically, that one "warmup replica" corresponds to a Task that is restoring its state. Also clarifies how max.warmup.replicas interacts with probing.rebalance.interval.ms.

Reviewers: Lucas Brutschy <lbrutschy@confluent.io>, Matthias J. Sax <matthias@confluent.io>, Guozhang Wang <wangguoz@gmail.com>
2023-03-03 11:00:51 -08:00
Vicky Papavasileiou cda5da9b65
KAFKA-14209: Change Topology optimization to accept list of rules 1/3 (#12641)
This PR is part of a series implementing the self-join rewriting. As part of it, we decided to clean up the TOPOLOGY_OPTIMIZATION_CONFIG and make it a list of optimization rules. Acceptable values are: NO_OPTIMIZATION, OPTIMIZE which applies all optimization rules or a comma separated list of specific optimizations.

Reviewers: Guozhang Wang <guozhang@apache.org>, John Roesler <vvcephei@apache.org>
2022-09-22 11:20:37 -05:00
Levani Kokhreidze 35ae4f248b
KAFKA-6718: Add documentation for KIP-708 (#11923)
Adds documentation for KIP-708: Rack awareness for Kafka Streams

Co-authored-by: Bruno Cadonna <cadonna@apache.org>

Reviewers: Luke Chen <showuon@gmail.com>, Bruno Cadonna <cadonna@apache.org>
2022-03-29 14:08:51 +02:00
Matthias J. Sax 30d1989db1
MINOR: update Kafka Streams standby task config (#11404)
Reviewers: A. Sophie Blee-Goldman <sophie@confluent.io>, Antony Stubbs <antony@confluent.io>, James Galasyn <jim.galasyn@confluent.io>
2021-11-16 17:34:49 -08:00
Andy Chambers 1573c707e6
KAFKA-13298: Improve documentation on EOS KStream requirements (#11355)
Reviewer: Matthias J. Sax <matthias@confluent.io>
2021-10-05 19:07:13 -07:00
Matthias J. Sax 0888953e0e
MINOR: remove note on future multi-cluster support of Kafka Streams (#11363)
Reviewer: Bill Bejeck <bill@confluent.io>
2021-09-28 23:09:24 -07:00
John Roesler bfdef11b97
KAFKA-12360: Document new time semantics (#11003)
Update the docs for task idling, since the semantics have
changed in 3.0.

Reviewers: Jim Galasyn <jim.galasyn@confluent.io>, Luke Chen <showuon@gmail.com>, Boyang Chen <boyang@apache.org>
2021-07-12 16:16:29 -05:00
leah d6918e427e
KAFKA-9559 add docs for changing default serde to null (#10988)
#10813 changed the default serde from ByteArraySerde as discussed in KIP-741. This adds proper documentation so users know to set a serde through the configs or explicitly pass one in.

Reviewers: Walker Carlson <wcarlson@confluent.io>, Anna Sophie Blee-Goldman <ableegoldman@apache.org>
2021-07-08 11:33:22 -07:00
Josep Prat aa25176e77
MINOR: Kafka Streams code samples formating unification (#10651)
Code samples are now unified and correctly formatted.
Samples under Streams use consistently the prism library.

Reviewers: Bruno Cadonna <cadonna@apache.org>
2021-05-21 17:27:42 +02:00
Matthias J. Sax 6a5992a814
KAFKA-8531: Change default replication factor config (#10532)
Implements KIP-733

Reviewers: A. Sophie Blee-Goldman <sophie@confluent.io>
2021-05-05 16:16:06 -07:00
A. Sophie Blee-Goldman 3805f3706f
KAFKA-12574: KIP-732, Deprecate eos-alpha and replace eos-beta with eos-v2 (#10573)
Deprecates the following 

1. StreamsConfig.EXACTLY_ONCE
2. StreamsConfig.EXACTLY_ONCE_BETA
3. Producer#sendOffsetsToTransaction(Map offsets, String consumerGroupId)

And introduces a new StreamsConfig.EXACTLY_ONCE_V2 config. Additionally, this PR replaces usages of the term "eos-beta" throughout the code with the term "eos-v2"

Reviewers: Matthias J. Sax <mjsax@confluent.io>
2021-04-28 13:22:15 -07:00
cyc 8d356b034b
KAFKA-12492: Fix the formatting of example RocksDBConfigSetter (#10486)
Fix the formatting of example RocksDBConfigSetter due to the un-arranged spaces within <pre> tag.

Reviewers: Anna Sophie Blee-Goldman <ableegoldman@apache.org>
2021-04-08 20:55:52 -07:00
Luke Chen 69baa03404
MINOR: fix the wrong/missing anchor in docs caused link error (#10413)
Reviewers: Matthias J. Sax <matthias@confluent.io>
2021-03-28 11:39:53 -07:00
Jim Galasyn 9728b4ff92
KAFKA-12160: Remove max.poll.interval.ms from config docs (#10182)
Reviewers: Matthias J. Sax <matthias@confluent.io>
2021-02-22 17:06:25 -08:00
Jim Galasyn da58ce4065
MINOR: Clarify config names for EOS versions 1 and 2 (#9670)
Reviewers: Boyang Chen <boyang@confluent.io>, Matthias J. Sax <matthias@confluent.io>
2021-02-16 17:11:24 -08:00
leah f5a2fbac6d
KAFKA-10366 & KAFKA-9649: Implement KIP-659 to allow TimeWindowedDeserializer and TimeWindowedSerde to handle window size (#9253)
See KIP details and discussions here: https://cwiki.apache.org/confluence/display/KAFKA/KIP-659%3A+Improve+TimeWindowedDeserializer+and+TimeWindowedSerde+to+handle+window+size

Deprecates methods that allow users to skip setting a window size when one is needed. Adds a window size streams config to allow the timeWindowedDeserializer to calculate window end time.

Reviewers: Walker Carlson <wcarlson@confluent.io>, John Roesler <vvcephei@apache.org>, Guozhang Wang <wangguoz@gmail.com>
2021-02-01 16:20:35 -08:00
Matthias J. Sax 2e0c686ec1
MINOR: improve KafkaStreams replication factor documentation (#9829)
Reviewers: Jason Gustafson <jason@confluent.io>, Jim Galasyn <jim.galasyn@confluent.io>
2021-01-06 11:31:05 -08:00
Bill Bejeck e847f057e3
KAFKA-10679: [Streams] migrate kafka-site updated docs to kafka/docs (#9554)
During the AK website upgrade, changes made to kafka-site weren't migrated back to kafka-docs.

This PR is an attempt at porting the streams changes to kafka/docs

For the most part, the bulk of the changes in the PR are cosmetic.

For testing:

I reviewed the PR diffs
Rendered the changes locally

Reviewers: John Roesler <john@confluent.io>
2020-11-04 08:30:10 -05:00
A. Sophie Blee-Goldman 3ef6c045e2
MINOR: Streams docs fixes (#9308)
Reviewers: Guozhang Wang <wangguoz@gmail.com>
2020-09-19 17:25:47 -07:00
Matthias J. Sax b351493543
KAFKA-9274: Remove `retries` for global task (#9047)
- part of KIP-572
 - removed the usage of `retries` in `GlobalStateManger`
 - instead of retries the new `task.timeout.ms` config is used

Reviewers: John Roesler <john@confluent.io>, Boyang Chen <boyang@confluent.io>, Guozhang Wang <guozhang@confluent.io>
2020-08-05 14:14:18 -07:00
A. Sophie Blee-Goldman 9b30276e58
KAFKA-9161: add docs for KIP-441 and KIP-613 and other configs that need fixing (#9027)
Add docs for KIP-441 and KIP-613.
Fixed some miscellaneous unrelated issues in the docs:
* Adds some missing configs to the Streams config docs: max.task.idle.ms,topology.optimization, default.windowed.key.serde.inner.class, and default.windowed.value.serde.inner.class
* Defines the previously-undefined default windowed serde class configs, including choosing a default (null) and giving them a doc string, so the yshould nwo show up in the auto-generated general Kafka config docs
* Adds a note to warn users about the rocksDB bug that prevents setting a strict capacity limit and counting write buffer memory against the block cache

Reviewers: Bruno Cadonna <bruno@confluent.io>, John Roesler <vvcephei@apache.org>
2020-07-20 16:27:28 -05:00
Jim Galasyn bfc9c9909d
MINOR: Remove retries entry from Streams config table (#8733)
Reviewer: Matthias J. Sax <matthias@confluent.io>
2020-05-27 12:24:15 -07:00
Matthias J. Sax 318063a16a
KAFKA-9466: Update Kafka Streams docs for KIP-447 (#8621)
Reviewers: Boyang Chen <boyang@confluent.io>, Jim Galasyn <jim.galasyn@confluent.io>, Guozhang Wang <guozhang@confluent.io>
2020-05-11 19:11:58 -07:00
Jim Galasyn 0f48446690
DOCS-3625: Add section to config topic: parameters controlled by Kafka Streams (#8268)
Reviewer: Matthias J. Sax <matthias@confluent.io>
2020-03-25 16:21:27 -07:00
A. Sophie Blee-Goldman e812784e74 fix rows (#7837)
Minor followup to #7825, should be cherry-picked to 2.4

Reviewers: Bill Bejeck <bbejeck@gmail.com>
2019-12-23 12:05:57 -05:00
A. Sophie Blee-Goldman 9567921fd4 MINOR: add UPGRADE_FROM to config docs (#7825)
Reviewers: Guozhang Wang <wangguoz@gmail.com>
2019-12-12 18:43:37 -08:00
ravowlga123 deafc56fed KAFKA-8953: Rename UsePreviousTimeOnInvalidTimestamp to UsePartitionTimeOnInvalidTimestamp (#7633)
Implements KIP-530

Reviewer: Matthias J. Sax <matthias@confluent.io>
2019-12-08 19:23:19 -08:00
vinoth chandar 15d69b7856 KAFKA-8913: Document topic based configs & ISR settings for Streams apps (#7346)
Reviewer: Matthias J. Sax <matthias@confluent.io>
2019-09-17 17:36:59 -07:00
vinoth chandar 4962c8193e KAFKA-8839 : Improve streams debug logging (#7258)
* log lock acquistion failures on the state store
* Document required uniqueness of state.dir path
* Move bunch of log calls around task state changes to DEBUG
* More readable log messages during partition assignment

Reviewers: Matthias J. Sax <mjsax@apache.org>, A. Sophie Blee-Goldman <sophie@confluent.io>, Guozhang Wang <wangguoz@gmail.com>
2019-09-17 09:46:40 -07:00
cwildman 9829c72699 MINOR: Remove stale streams producer retry default docs. (#6844)
As part of #5425 the streams default override for producer retries was removed. The documentation was not updated to reflect that change.

Reviewers: Matthias J. Sax <mjsax@apache.org>, Sophie Blee-Goldman <sophie@confluent.io>,  Bill Bejeck <bbejeck@gmail.com>
2019-07-19 12:58:27 -04:00
A. Sophie Blee-Goldman 102490ea0c MINOR: improve RocksDBConfigSetter docs (#7009)
Users often use the RocksDBConfigSetter to modify parameters such as cache or block size, which must be set through the BlockBasedTableConfig object. Rather than creating a new object in the config setter, however, users should most likely retrieve a reference to the existing one so as to not lose the other defaults (eg the BloomFilter)

There have been notes from the community that it is not obvious this should be done, nor is it immediately clear how to do so. This PR updates the RocksDBConfigSetter docs to hopefully improve things.

I also piggybacked a few minor cleanups in the docs

Reviewers: Kamal Chandraprakash, Jim Galasyn <jim.galasyn@confluent.io>,  Bruno Cadonna <bruno@confluent.io>, Bill Bejeck <bbejeck@gmail.com>
2019-07-08 19:11:17 -04:00
A. Sophie Blee-Goldman 105264b5cd MINOR: Updated configuration docs with RocksDBConfigSetter#close (#6784)
The old docs here used a now deprecated method to set the block cache size. In switching over to the new one we would now need to construct a Cache object and therefore also need to close it, so this is a good opportunity to demonstrate the RocksDBConfigSetter#close method that will need to be implemented by users.

Reviewers: Guozhang Wang <wangguoz@gmail.com>
2019-05-24 10:35:16 -07:00
Victoria Bialas 70ee72491f MINOR: updated names for deprecated streams constants (#6466)
* updated names for deprecated streams constants
* add DEFAULT_TIMESTAMP_EXTRACTOR_CLASS_CONFIG in place of deprecated

Reviewers: Jim Galasyn <jim.galasyn@confluent.io>, Matthias J. Sax <matthias@confluent.io>
2019-03-19 16:33:41 -07:00
cwildman abbd992a4a MINOR: state.cleanup.delay.ms default is 600,000 ms (10 minutes). (#6345)
Reviewers: Bill Bejeck <bill@confluent.io>, Matthias J. Sax <matthias@confluent.io>
2019-02-28 09:22:54 -08:00
John Roesler 8ae985705f KAFKA-7768: Use absolute paths for javadoc (#6100)
Reviewers: Guozhang Wang <wangguoz@gmail.com>
2019-01-07 13:30:49 -08:00
slim 6a20e3cd4c KAFKA-7768: Add version to java html urls (#6094)
Reviewers: Guozhang Wang <wangguoz@gmail.com>
2019-01-07 09:21:33 -08:00
Lee Dongjin e7b6d65713 KAFKA-6620: Fix documentation about 'exactly_once'
Reviewers: Matthias J. Sax <matthias@confluent.io>, Guozhang Wang <wangguoz@gmail.com>
2018-09-28 14:41:50 -07:00
Matthias J. Sax c1ca53b369 MINOR: fix Streams docs state.dir (#5465)
Reviewers: Guozhang Wang <wangguoz@gmail.com>
2018-08-06 13:39:50 -07:00
Jim Galasyn 581adb5013 MINOR: Add note about num.standby.replicas (#5271)
Reviewers: Guozhang Wang <wangguoz@gmail.com>
2018-06-26 08:24:44 -07:00