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

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