[
https://issues.apache.org/jira/browse/CASSANDRA-19335?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]
Leo Toff updated CASSANDRA-19335:
---------------------------------
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:
# https://issues.apache.org/jira/browse/CASSANDRA-19015
# https://issues.apache.org/jira/browse/CASSANDRA-19104
was:
*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.
*Related work*
Previous work in the series:
# https://issues.apache.org/jira/browse/CASSANDRA-19015
# https://issues.apache.org/jira/browse/CASSANDRA-19104
> Default nodetool tablestats to Human-Readable Output
> ----------------------------------------------------
>
> Key: CASSANDRA-19335
> URL: https://issues.apache.org/jira/browse/CASSANDRA-19335
> Project: Cassandra
> Issue Type: Bug
> Reporter: Leo Toff
> Assignee: Leo Toff
> Priority: Low
> Fix For: 5.1
>
>
> *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:
> # https://issues.apache.org/jira/browse/CASSANDRA-19015
> # https://issues.apache.org/jira/browse/CASSANDRA-19104
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
