[ 
https://issues.apache.org/jira/browse/HDDS-13130?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
 ]

ASF GitHub Bot updated HDDS-13130:
----------------------------------
    Labels: pull-request-available  (was: )

> Rename "diskUsage" Feature in Recon UI and Documentation to Avoid Misleading 
> Users
> ----------------------------------------------------------------------------------
>
>                 Key: HDDS-13130
>                 URL: https://issues.apache.org/jira/browse/HDDS-13130
>             Project: Apache Ozone
>          Issue Type: Improvement
>          Components: Ozone Recon
>            Reporter: Arafat Khan
>            Assignee: Abhishek Pal
>            Priority: Major
>              Labels: pull-request-available
>
> The current "{*}diskUsage{*}" endpoint and feature in Recon are misleadingly 
> named. Contrary to what the name suggests, this endpoint does *not* provide 
> the actual disk usage statistics (as one would expect from a typical Linux 
> {{du}} command). Instead, it iterates over the metadata in the OM database 
> and builds a tree-like structure that provides a high-level overview of 
> various OM DB namespace statistics, such as:
>  * Quota space
>  * Data size of directories
>  * File and directory listing capabilities
>  * File size distribution under directories and buckets
> This feature does *not* interact with the underlying filesystem to retrieve 
> actual hard storage usage statistics for files and directories. Instead, it 
> offers a "bird’s eye view" based on metadata only.
> *Reason for Change:*
> The name "diskUsage" can easily confuse users into believing it represents 
> actual disk usage, similar to what they would get from running {{du}} or 
> similar commands on a filesystem. To prevent this confusion and improve user 
> experience and clarity, we want to rename this feature in the Recon UI, Recon 
> documentation, and API documentation to better reflect its true functionality.
> *Tasks:*
>  * Propose and finalize a new name that better represents this feature (e.g., 
> "Namespace Usage Overview", "Metadata Usage Explorer", etc.)
>  * Update all instances of "diskUsage" in the Recon UI.
>  * Update all references in the Recon and API documentation.
>  * Update API endpoint names and descriptions as needed.



--
This message was sent by Atlassian Jira
(v8.20.10#820010)

---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscr...@ozone.apache.org
For additional commands, e-mail: issues-h...@ozone.apache.org

Reply via email to