# rpk cluster logdirs describe

> For the complete documentation index, see [llms.txt](https://docs.redpanda.com/llms.txt). Component-specific: [streaming-full.txt](https://docs.redpanda.com/streaming-full.txt)

---
title: rpk cluster logdirs describe
latest-redpanda-tag: v26.2.1
latest-console-tag: v3.9.0
latest-operator-version: v26.2.1
# EOL = End-of-Life (support lifecycle status)
page-is-nearing-eol: "false"
page-is-past-eol: "false"
page-eol-date: July 28, 2027
latest-connect-version: 4.104.0
docname: rpk/rpk-cluster/rpk-cluster-logdirs-describe
page-component-name: streaming
page-version: "26.2"
page-component-version: "26.2"
page-component-title: Streaming
page-relative-src-path: rpk/rpk-cluster/rpk-cluster-logdirs-describe.adoc
page-edit-url: https://github.com/redpanda-data/docs/edit/main/modules/reference/pages/rpk/rpk-cluster/rpk-cluster-logdirs-describe.adoc
description: Describe log directories on Redpanda brokers. This command prints information about log directories on brokers, particularly, the base directory that topics and partitions are located in, and the size of data that has been written to the partitions.
page-git-created-date: "2023-05-17"
page-git-modified-date: "2026-08-03"
support-status: supported
---

<!-- Source: https://docs.redpanda.com/streaming/current/reference/rpk/rpk-cluster/rpk-cluster-logdirs-describe.md -->

Describe log directories on Redpanda brokers.

This command prints information about log directories on brokers, particularly, the base directory that topics and partitions are located in, and the size of data that has been written to the partitions. The size you see may not exactly match the size on disk as reported by du: Redpanda allocates files in chunks. The chunks will show up in du, while the actual bytes so far written to the file will show up in this command.

The directory returned is the root directory for partitions. Within Redpanda, the partition data lives underneath the the returned root directory in.

```text
kafka/{topic}/{partition}_{revision}/
```

where revision is a Redpanda internal concept.

## [](#usage)Usage

```bash
rpk cluster logdirs describe [flags]
```

## [](#flags)Flags

| Value | Type | Description |
| --- | --- | --- |
| --aggregate-into | string | Aggregate results into the specified column starting from the partition column. Valid values: broker, dir, topic. |
| -b, --broker | int32 | If non-negative, the specific broker to describe. |
| --format | string | Output format (json,yaml,text,wide,help). (New in v26.2.1) |
| -H, --human-readable | bool | Print the logdirs size in a human-readable form. |
| --sort-by-size | bool | If true, sort by size. |
| --topics | stringSlice | Specific topics to describe. |

## [](#global-flags)Global flags

| Value | Type | Description |
| --- | --- | --- |
| --config | string | Redpanda or rpk config file; default search paths are ~/.config/rpk/rpk.yaml, $PWD/redpanda.yaml, and /etc/redpanda/redpanda.yaml. |
| -X, --config-opt | stringArray | Override rpk configuration settings; -X help for detail or -X list for terser detail. |
| --ignore-profile | bool | Ignore rpk.yaml and redpanda.yaml; use default settings. |
| --profile | string | rpk profile to use. |
| -v, --verbose | bool | Enable verbose logging. |