Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

One of Kafka's officially-described use cases is a distributed commit log (http://kafka.apache.org/documentation.html#uses_commitlog). In this case, for a distributed service that needed a commit log, there would be a topic with a single partition to guarantee log order. This service would use the commit log to re-sync failed nodes. Kafka is generally an excellent fit for such a system, but it does not expose an adequate mechanism for log cleanup in such a case. With a distributed commit log, data can only be deleted when the client application determines that it is no longer needed; this creates completely arbitrary ranges of time and size for messages, which the existing cleanup mechanisms can't handle smoothly.

A new addition to the existing deletion policy based on the absolute timestamp of a message would work perfectly for this case.  The client application will periodically update the minimum timestamp of messages to retain, and Kafka will delete all messages earlier than that timestamp using the existing log cleaner thread mechanismdeletion mechanism, alongside the existing size-based and duration-based checks.

This is based off of the work being done in KIP-32 - Add timestamps to Kafka message.

...

  • Expose a new topic configuration, log.retention.min.mintimestamptimestamp

 

Proposed Changes

  • Add a new topic configuration, log.retention.min.timestamp
  • Modify the log deletion mechanism (in LogManager.scala) to also delete segments before the configured timestamp if the timestamp is setTimestamp-based log deletion should only occur when message.timestamp.type=LogAppendTime

 

Compatibility, Deprecation, and Migration Plan

...