influxd inspect report-db
This page documents an earlier version of InfluxDB OSS. InfluxDB 3 Core is the latest stable version.
The influxd inspect report-db command analyzes an InfluxDB bucket and reports the cardinality of data stored in the bucket.
Usage
influxd inspect report-db [flags]
Flags
| Flag | Description | Input Type | |
|---|---|---|---|
--c | Worker concurrency (default is 1). | integer | |
--db-path | (Required) Path to InfluxDB data directory. | string | |
--detailed | Include field and tag counts in output. | ||
--exact | Report exact counts. | ||
-h | --help | View help for the report-db command. | |
--rollup | Rollup level: t (total), b (bucket), r (retention policy), or m (measurement) (default). | string |
Examples
- Report the cardinality of measurements in all buckets
- Report the cardinality of measurements in a specific bucket
- Report the cardinality of all buckets
- Report the cardinality of all retention policies
- Report the total cardinality of your InfluxDB instance
- Include tag and field counts in your cardinality summary
Report the cardinality of measurements in all buckets
- Use the
--db-pathflag to provide the path to your InfluxDB data directory.
# Syntax
influxd inspect report-db --db-path <influxdb-data-directory>
# Example
influxd inspect report-db --db-path ~/.influxdbv2/engine/data
Report the cardinality of measurements in a specific bucket
- Use the
--db-pathflag to provide the path to the Bucket directory (bucket ID) in your InfluxDB data directory.
# Syntax
influxd inspect report-db --db-path <influxdb-data-directory>/<bucket-id>
# Example
influxd inspect report-db --db-path ~/.influxdbv2/engine/data/000xX00xxXx000x0
Report the cardinality of all buckets
- Use the
--db-pathflag to provide the path to your InfluxDB data directory. - Use the
--rollupflag with the value,b, to return a bucket-level summary of cardinality.
# Syntax
influxd inspect report-db \
--db-path <influxdb-data-directory> \
--rollup b
# Example
influxd inspect report-db \
--db-path ~/.influxdbv2/engine/data \
--rollup b
Report the cardinality of all retention policies
- Use the
--db-pathflag to provide the path to your InfluxDB data directory. - Use the
--rollupflag with the value,r, to return a retention-policy-level summary of cardinality.
# Syntax
influxd inspect report-db \
--db-path <influxdb-data-directory> \
--rollup r
# Example
influxd inspect report-db \
--db-path ~/.influxdbv2/engine/data \
--rollup r
Report the total cardinality of your InfluxDB instance
- Use the
--db-pathflag to provide the path to your InfluxDB data directory. - Use the
--rollupflag with the value,t, to return a summary of total cardinality.
# Syntax
influxd inspect report-db \
--db-path <influxdb-data-directory> \
--rollup t
# Example
influxd inspect report-db \
--db-path ~/.influxdbv2/engine/data \
--rollup t
Include tag and field counts in your cardinality summary
- Use the
--db-pathflag to provide the path to your InfluxDB data directory. - Include the
--detailedflag to return detailed cardinality summaries with tag and field counts.
# Syntax
influxd inspect report-db \
--db-path <influxdb-data-directory> \
--detailed
# Example
influxd inspect report-db \
--db-path ~/.influxdbv2/engine/data \
--detailed
Was this page helpful?
Thank you for your feedback!
Support and feedback
Thank you for being part of our community! We welcome and encourage your feedback and bug reports for InfluxDB and this documentation. To find support, use the following resources:
Customers with an annual or support contract can contact InfluxData Support. Customers using a trial license can email trial@influxdata.com for assistance.