rpk topic describe-storage
Describe the topic storage status.
This command prints detailed information about the cloud storage status of a topic. The information is divided into four sections.
By default, only the SUMMARY and SIZE sections are printed. Use the section
flags to print specific sections, or --print-all to print all four.
Usage
rpk topic describe-storage <topic> [flags]
Summary
The summary section contains general information about the topic, the cloud
storage mode (one of disabled, write_only, read_only, full, read_replica,
cloud_topic, cloud_topic_read_replica, and tiered_cloud_topic),
and the delta in milliseconds since the last upload of either the partition
manifest or a segment. The last upload delta is not shown for cloud_topic and
cloud_topic_read_replica topics.
Offset
The offset section contains the start and last offsets (inclusive) per
partition of data available in both the cloud and on local disk.
Size
For tiered storage topics, the size section contains the total bytes per partition in the cloud and on local disk, the total size of the log of each partition (excluding cloud and local overlap), and the number of segments in the cloud and on local disk. The cloud segment count does not include segments queued for deletion.
For cloud topics, the size section shows the local log size, the L0 (level
zero) and L1 (level one) byte breakdown, the total bytes, and the number of L1
extents. For tiered_cloud_topic, the local segment count is also shown.
Sync
The sync section contains the state of cloud synchronization: milliseconds since the last upload of the partition manifest, milliseconds since the last segment upload, milliseconds since the last manifest sync (for read replicas), and whether the remote metadata has a pending update to include all uploaded segments.
Flags
| Value | Type | Description |
|---|---|---|
|
bool |
Print times (in milliseconds) and byte values in human-readable units (for example, 1.2 GiB, 3m 20s). |
|
bool |
Print all cloud storage status. |
|
bool |
Print the offset section. |
|
bool |
Print the log size section. |
|
bool |
Print the summary section. |
|
bool |
Print the sync section. |
Global flags
| Value | Type | Description |
|---|---|---|
|
string |
Redpanda or |
|
stringArray |
Override |
|
bool |
Ignore |
|
string |
|
|
bool |
Enable verbose logging. |