docs-v2/content/influxdb/v2/reference/cli/influxd/inspect/report-db.md

title	description	influxdb/v2/tags	menu	weight
influxd inspect report-db	The `influxd inspect report-db` command reports the cardinality for an InfluxDB bucket.	cardinality inspect	influxdb_v2 parent influxd inspect	301

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	({{< req >}}) 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