influxd inspect report-db

API token hashing is enabled by default in InfluxDB OSS 2.9.0

Stronger token security: tokens are stored as hashes on disk, so a copy of the database file doesn’t expose usable tokens. Existing tokens are hashed on first startup and the original strings can’t be recovered afterward — capture any plaintext tokens you still need before you upgrade.

For more information, see Token hashing.

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

FlagDescriptionInput Type
--cWorker concurrency (default is 1).integer
--db-path(Required) Path to InfluxDB data directory.string
--detailedInclude field and tag counts in output.
--exactReport exact counts.
-h--helpView help for the report-db command.
--rollupRollup level: t (total), b (bucket), r (retention policy), or m (measurement) (default).string

Examples

Report the cardinality of measurements in all buckets

# 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

# 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

Was this page helpful?

Thank you for your feedback!