Hi Kamal, Chia-Ping, and Satish, Thanks for the review and suggestions.
Moved `IncludeRemoteInfo` out of `DescribableLogDirTopics`. chia_03: `PartitionSize != RemoteLogSize + OnlyLocalLogSize`. The PartitionSize is all local log segments size. It includes part of remote log segments which haven’t meet local retention. chia_04: I prefer to use `onlyLocalSize`, because it gets value from UnifiedLog#onlyLocalLogSegmentSize. If we use `localSize`, users may be think that `size = remoteSize + localSize`. chia_05: Change both `remoteSize` and `onlyLocalSize` to optional long. 100: Updated the description of `RemoteLogSize`. 101: I prefer to align the naming order like UnifiedLog#onlyLocalLogSegmentSize. Updated the description of `onlyLocalSize`. Thanks, PoAn > On Aug 5, 2025, at 1:29 PM, Satish Duggana <satish.dugg...@gmail.com> wrote: > > Hi PoAn, > Thanks for the KIP, this is a valuable feature for operators to get > better visibility into partition sizes across both local and remote > storage. While RemoteLogSegmentMetadata provides segment-level details > to help developers build custom utilities, it's beneficial to enhance > the existing Kafka utilities to surface more operationally useful > information. > > Overall proposal looks good to me. I have a couple of minor comments. > > 100. RemoteLogSize – It would be helpful to enhance the description > with more detail. For example: > "The size of the remote log segments for this partition, in bytes. > Note that some of these segments may still be present in the broker’s > local storage." > > 101. onlyLocalSize – I suggest renaming this to LocalOnlySize for > better clarity. The description can also be made more explicit, such > as: > "The size of the log segments stored only in the broker’s local > storage for this partition, in bytes. This excludes any data that has > been offloaded to remote storage." > > ~Satish. > > On Mon, 4 Aug 2025 at 15:57, Chia-Ping Tsai <chia7...@apache.org> wrote: >> >> hi PoAn >> >> chia_03: what is the difference between `OnlyLocalLogSize` and >> `PartitionSize`? Am I correct in assuming that `PartitionSize` = >> RemoteLogSize + OnlyLocalLogSize? >> >> chia_04: could you please consider renaming `onlyLocalSize` to `localSize` >> for consistency? >> >> chia_05: should we use optional int as returned type for `remoteSize` and >> `onlyLocalSize`? If not, could you please add comments to explain the use of >> "-1"? >> >> Best, >> Chia-Ping >> >> >> On 2025/06/16 14:32:34 PoAn Yang wrote: >>> Hi all, >>> >>> I would like to start a discussion thread about KIP-1187. >>> >>> Please take a look and feel free to share any thought. >>> >>> https://cwiki.apache.org/confluence/x/sYkhFg >>> >>> Thanks, >>> PoAn