- influxd inspect report-db
- Usage
- Flags
- 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
influxd inspect report-db
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-path
flag 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-path
flag 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-path
flag to provide the path to your InfluxDB data directory. - Use the
--rollup
flag 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-path
flag to provide the path to your InfluxDB data directory. - Use the
--rollup
flag 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-path
flag to provide the path to your InfluxDB data directory. - Use the
--rollup
flag 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-path
flag to provide the path to your InfluxDB data directory. - Include the
--detailed
flag 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