Uploaded image for project: 'Cassandra'
  1. Cassandra
  2. CASSANDRA-19335

Default nodetool tablestats to Human-Readable Output

    XMLWordPrintableJSON

Details

    • Improvement
    • Status: Changes Suggested
    • Low
    • Resolution: Unresolved
    • 5.x
    • Tool/nodetool
    • None
    • Operability
    • Low Hanging Fruit
    • All
    • None
    • Hide

      CI

      Show
      CI

    Description

      Current Behavior

      The current implementation of nodetool tablestats in Apache Cassandra outputs statistics in a format that is not immediately human-readable. This output primarily includes raw byte counts, which require additional calculation or conversion to be easily understood by users. This can be inefficient and time-consuming, especially for users who frequently monitor these statistics for performance tuning or maintenance purposes.

      Proposed Change

      We propose that nodetool tablestats should, by default, provide its output in a human-readable format. This change would involve converting byte counts into more understandable units (KiB, MiB, GiB). The tool could still retain the option to display raw data for those who need it, perhaps through a flag such as --no-human-readable or --raw.

      Considerations

      The change should maintain backward compatibility, ensuring that scripts or tools relying on the current output format can continue to function correctly.
      We should provide adequate documentation and examples of both the new default output and how to access the raw data format, if needed.

      Alignment

      Discussion in the dev mailing list: https://lists.apache.org/thread/mlp715kxho5b6f1ql9omlzmmnh4qfby9 

      Related work

      Previous work in the series:

      1. https://issues.apache.org/jira/browse/CASSANDRA-19015 
      2. https://issues.apache.org/jira/browse/CASSANDRA-19104

      Attachments

        Issue Links

          Activity

            People

              zaaath Leo Toff
              zaaath Leo Toff
              Leo Toff
              Brandon Williams
              Votes:
              0 Vote for this issue
              Watchers:
              2 Start watching this issue

              Dates

                Created:
                Updated:

                Time Tracking

                  Estimated:
                  Original Estimate - Not Specified
                  Not Specified
                  Remaining:
                  Remaining Estimate - 0h
                  0h
                  Logged:
                  Time Spent - 50m
                  50m