Child pages
  • KIP-253: Support in-order message delivery with partition expansion
Skip to end of metadata
Go to start of metadata


Current stateUnder Discussion

Discussion thread




Kafka is designed to allow messages with the same key from the same producer to be consumed in the same order as they are produced. This feature is useful for applications which maintain local states per key. However, as of current design of Kafka, this in-order delivery is not guaranteed if we expand partition of the topic. This KIP proposes a design to support in-order message delivery even if we expand partition of the topic.


Public Interfaces


Update the znodes /brokers/topics/[topic]/partitions/[partition] to use the following json format


1) Update LeaderAndIsrRequest to re-use topic field for all its partitions and add field partition_number for each topic.

2) Update ProduceRequest to include partition_number per topic.


3) Update HeartbeatRequest to include fields need_position and position for relevant partitions.


4) Update HeartbeatResponse to include fields need_position and position for relevant partitions.


5) Add LeaderEpochForPartitionRequest and LeaderEpochForPartitionResponse. See 1) and 5) in Proposed Changes section for how this request and resopnse are used.


Proposed Changes

1) Changes in the controller for handling partition expansion

Here we describe how topic znode change triggers partition expansion logic in the controller

- User uses to update the topic znode with the new assignment. This triggers the topic znode listener in controller.

- For those partitions of this topic which already have the partition znode, controller increments their leaderEpoch by 1 in the partition znode. Controller sends LeaderAndIsrRequest and wait for LeaderAndIsrResponse. The LeaderAndIsrRequest should include the new leaderEpoch for each partition and the new partition count for the topic.

- For each partition of this topic which does not have the partition znode, controller creates the partition znode, such that the znode data includes the map (priorPartition -> oldLeaderEpoch), where prior partition are partitions of this topic whose partition index is smaller than the given partition.

- Controller continue the existing logic of partition expansion.

Note that this procedure is fault tolerant. If controller fails in any of these step, the new controller can continue creating partition znode following the same procedure.

2) Changes in how broker handle ProduceRequest

- When broker receives LeaderAndIsrRequest, in addition to the existing procedure (e.g. updating the leaderEpochCache for the new leaderEpoch), the broker should record the latest partition count for each topic.

- When broker receives ProduceRequest, for each partition in the request, broker checks whether its partition count is the same as the partition count from the most recent LeaderAndIsrRequest. If yes, broker handles the produce request in the current way. If no, broker rejects this partition with InvalidPartitionCountException. This error extends InvalidMetadaException and should trigger produce to update its metadata and retry.

3) Changes in how produce constructs ProduceRequest

- Producer should include the partition count for each topic in the ProduceRequest.

4) Changes in how consumer handles HeartbeatRequest and HeartbeatResponse

- HeartbeatRequest includes the current position for each partition requested by the coordinator from the previous HeartbeatResponse. It also includes the list of partitions for which it wants to know the position (of the consumer that is consuming this partitoin).

- Group coordinator remembers the positions for those partitions which are interesting to some consumers of the given group.

- HeartbeatResponse includes the position for the requested partitons based on the most recent HeartbeatRequest from consumers of the group. It also includes the list of partitions which are interesting to some consumers of the given group.

5) Changes in how consumer consumes partition

- Consumer receives SyncGroupResponse, which contains its assigned partitions

- Consumer gets the startPosition, i.e.the committedOffset, for its assigned partitions.

- For each partition whose startPosition is 0, consumer sends LeaderEpochsForPartitionRequest to the coordinator to get the map (priorPartition -> oldLeaderEpoch), which can be read by broker from the corresponding partition znode. Then the consumer sends OffsetsForLeaderEpochRequest to convert the (priorPartition -> oldLeaderEpoch) to (priorPartition -> offsetThreshold), where offsetThreshold should be the last offset of messages published under oldLeaderEpoch for the given priorPartition.

- For each partiton whose startPosition is 0, consumer includes its list of priorPartition in the HeartbeatRequest and gets the corresponding position of these partitions of the consumer group in the HeartbeatResponse. Consumer only starts to consume this partition if for all its priorPartition, the position >= offsetThreshold of the priorParition.

Compatibility, Deprecation, and Migration Plan

The KIP changes the inter-broker protocol. Therefore the migration requires two rolling bounce. In the first rolling bounce we will deploy the new code but broker will still communicate using the existing protocol. In the second rolling bounce we will change the config so that broker will start to communicate with each other using the new protocol.

Rejected Alternatives


Future work




  • No labels