Skip to main content
Version: 23.1

rpk cluster logdirs describe

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 returned root directory in kafka/{topic}/{partition}_{revision}/ where revision is a Redpanda internal concept.

Usage

rpk cluster logdirs describe [flags]

Flags

ValueTypeDescription
--aggregate-intostringIf non-empty, what column to aggregate into starting from the partition column (broker, dir, topic).
-b, --brokerint32If non-negative, the specific broker to describe (default -1).
-h, --help-Help for describe.
--sort-by-size-If true, sort by size.
--topicsstringsSpecific topics to describe.
--brokersstringsComma-separated list of broker <ip>:<port> pairs (for example,--brokers `192.168.78.34:9092,192.168.78.35:9092,192.179.23.54:9092`). Alternatively, you may set the REDPANDA_BROKERSenvironment variable with the comma-separated list of broker addresses.
--configstringRedpanda config file, if not set the file will be searched for in the default locations.
--passwordstringSASL password to be used for authentication.
--sasl-mechanismstringThe authentication mechanism to use. Supported values: SCRAM-SHA-256, SCRAM-SHA-512.
--tls-certstringThe certificate to be used for TLS authentication with the broker.
--tls-enabled-Enable TLS for the Kafka API (not necessary if specifying custom certs).
--tls-keystringThe certificate key to be used for TLS authentication with the broker.
--tls-truststorestringThe truststore to be used for TLS communication with the broker.
--userstringSASL user to be used for authentication.
-v, --verbose-Enable verbose logging (default false).

What do you like about this doc?




Optional: Share your email address if we can contact you about your feedback.

Let us know what we do well: