[
https://issues.apache.org/jira/browse/KAFKA-3234?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15323554#comment-15323554
]
James Cheng commented on KAFKA-3234:
------------------------------------
Hi, what's the status on this JIRA?
I didn't realize that this JIRA existed, and so filed
https://issues.apache.org/jira/browse/KAFKA-3809 to add auto-generated
documentation for topic-level configs. If this one will be moving forward, I
can close mine as a dup.
> Minor documentation edits: clarify minISR; some topic-level configs are
> missing
> -------------------------------------------------------------------------------
>
> Key: KAFKA-3234
> URL: https://issues.apache.org/jira/browse/KAFKA-3234
> Project: Kafka
> Issue Type: Improvement
> Components: website
> Reporter: Joel Koshy
> Assignee: Joel Koshy
> Fix For: 0.10.0.1
>
>
> Based on an offline conversation with [~junrao] and [~gwenshap]
> The current documentation is somewhat confusing on minISR in that it says
> that it offers a trade-off between consistency and availability. From the
> user's view-point, consistency (at least in the usual sense of the term) is
> achieved by disabling unclean leader election - since no replica that was out
> of ISR can be elected as the leader. So a consumer will never see a message
> that was not acknowledged to a producer that set acks to "all". Or to put it
> another way, setting minISR alone will not prevent exposing uncommitted
> messages - disabling unclean leader election is the stronger requirement. You
> can achieve the same effect though by setting minISR equal to the number of
> replicas.
> There is also some stale documentation that needs to be removed:
> {quote}
> In our current release we choose the second strategy and favor choosing a
> potentially inconsistent replica when all replicas in the ISR are dead. In
> the future, we would like to make this configurable to better support use
> cases where downtime is preferable to inconsistency.
> {quote}
> Finally, it was reported on the mailing list (from Elias Levy) that
> compression.type should be added under the topic configs. Same goes for
> unclean leader election. Would be good to have these auto-generated.
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)
