Current state: Accepted
Discussion thread: here
Please keep the discussion on the mailing list rather than commenting on the wiki (wiki discussions get unwieldy fast).
When running kafka-metadata-quorum script to get the quorum replication status, the LastFetchTimestamp and LastCaughtUpTimestamp output is not human-readable.
It would be convenient to add an optional flag to enable a human-readable format showing the operation delay in ms (i.e. 366 ms ago).
This delay is computed as (now - timestamp), where they are both represented as Unix time (UTC based).
A new optional flag called --human-readable will be added to the kafka-metadata-quorum tool.
The current default --replication output is as follows and will remain unchanged.
Instead, when passing the new flag, we will have the following output (note how argparse4j support abbreviations).
Compatibility, Deprecation, and Migration Plan
The default behavior will remain unchanged to avoid breaking any tool relying on the current timestamp output.
A new test method will be added to MetadataQuorumCommandTest to verify default and new behaviors with regard to the timestamp output.
Using a date/time formatting (i.e. May 10, 15:54:55 UTC) won't add much information in most cases and you will have to deal with locale.