[ https://issues.apache.org/jira/browse/KAFKA-1634?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=14167696#comment-14167696 ]
Joel Koshy commented on KAFKA-1634: ----------------------------------- Actually, one more potential source of confusion is that we use OffsetAndMetadata for both offset commits requests and offset fetch responses. i.e., an OffsetFetchResponse will contain: offset, metadata and this timestamp field. The timestamp field should really be ignored. It is annoying to document such things - i.e., tell users to just ignore the field. Ideally, I think we should do the following: * Remove the timestamp from the OffsetAndMetadata class * Move it to the top-level of the OffsetCommitRequest and rename it to retentionMs * The broker will compute the absolute time (based off time of receipt) that the offset should be expired * The above absolute time will continue to be stored in the offsets topic and the cleanup thread can remove those offsets when they are past their TTL. * OffsetFetchResponse will just return OffsetAndMetadata (no timestamp) We (linkedin and possibly others) already deployed this to some of our consumers but if we can bump up the protocol version when doing the above and translate requests that come in with the older version I think it should be okay. > Update protocol wiki to reflect the new offset management feature > ----------------------------------------------------------------- > > Key: KAFKA-1634 > URL: https://issues.apache.org/jira/browse/KAFKA-1634 > Project: Kafka > Issue Type: Bug > Reporter: Neha Narkhede > Assignee: Joel Koshy > Priority: Blocker > Fix For: 0.8.2 > > > From the mailing list - > following up on this -- I think the online API docs for OffsetCommitRequest > still incorrectly refer to client-side timestamps: > https://cwiki.apache.org/confluence/display/KAFKA/A+Guide+To+The+Kafka+Protocol#AGuideToTheKafkaProtocol-OffsetCommitRequest > Wasn't that removed and now always handled server-side now? Would one of > the devs mind updating the API spec wiki? -- This message was sent by Atlassian JIRA (v6.3.4#6332)