This is an automated email from the ASF dual-hosted git repository. guozhang pushed a commit to branch trunk in repository https://gitbox.apache.org/repos/asf/kafka.git
The following commit(s) were added to refs/heads/trunk by this push: new cc4a7f0 MINOR: cleanup policy doc update (#6692) cc4a7f0 is described below commit cc4a7f01e872e6d0664360d5148af09c876ca72b Author: Joyce Fee <jo...@confluent.io> AuthorDate: Wed May 8 20:38:28 2019 -0500 MINOR: cleanup policy doc update (#6692) Reviewers: Guozhang Wang <wangg...@gmail.com> --- docs/design.html | 14 +++++++++----- 1 file changed, 9 insertions(+), 5 deletions(-) diff --git a/docs/design.html b/docs/design.html index ab8c002..8c9b2eb 100644 --- a/docs/design.html +++ b/docs/design.html @@ -523,16 +523,20 @@ <h4><a id="design_compactionconfig" href="#design_compactionconfig">Configuring The Log Cleaner</a></h4> The log cleaner is enabled by default. This will start the pool of cleaner threads. - To enable log cleaning on a particular topic you can add the log-specific property - <pre class="brush: text;"> log.cleanup.policy=compact</pre> - This can be done either at topic creation time or using the alter topic command. - <p> + To enable log cleaning on a particular topic, add the log-specific property + <pre class="brush: text;"> log.cleanup.policy=compact</pre> + + The <code>log.cleanup.policy</code> property is a broker configuration setting defined + in the broker's <code>server.properties</code> file; it affects all of the topics + in the cluster that do not have a configuration override in place as documented + <a href="/documentation.html#brokerconfigs">here</a>. + The log cleaner can be configured to retain a minimum amount of the uncompacted "head" of the log. This is enabled by setting the compaction time lag. <pre class="brush: text;"> log.cleaner.min.compaction.lag.ms</pre> This can be used to prevent messages newer than a minimum message age from being subject to compaction. If not set, all log segments are eligible for compaction except for the last segment, i.e. the one currently being written to. The active segment will not be compacted even if all of its messages are older than the minimum compaction time lag. - </p> + <p> Further cleaner configurations are described <a href="/documentation.html#brokerconfigs">here</a>.