---
title: influxd inspect report-db
description: The influxd inspect report-db command reports the cardinality for an InfluxDB bucket.
url: https://docs.influxdata.com/influxdb/v2/reference/cli/influxd/inspect/report-db/
estimated_tokens: 1519
product: InfluxDB OSS v2
version: v2
publisher: InfluxData
canonical: https://docs.influxdata.com/influxdb/v2/reference/cli/influxd/inspect/report-db/
date: '2023-11-06T15:53:12-07:00'
lastmod: '2023-11-06T15:53:12-07:00'
---

This page documents an earlier version of InfluxDB OSS.[InfluxDB 3 Core](/influxdb3/core/) is the latest stable version.

#### 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](/influxdb/v2/admin/tokens/#token-hashing).

The `influxd inspect report-db` command analyzes an InfluxDB bucket and reports the cardinality of data stored in the bucket.

## Usage

```sh
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-all-buckets)
* [Report the cardinality of measurements in a specific bucket](#report-the-cardinality-of-measurements-in-a-specific-bucket)
* [Report the cardinality of all buckets](#report-the-cardinality-of-all-buckets)
* [Report the cardinality of all retention policies](#report-the-cardinality-of-all-retention-policies)
* [Report the total cardinality of your InfluxDB instance](#report-the-total-cardinality-of-your-influxdb-instance)
* [Include tag and field counts in your cardinality summary](#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](/influxdb/v2/reference/internals/file-system-layout/#tsm-directories-and-files-layout).

```sh
# 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)](/influxdb/v2/reference/internals/file-system-layout/#tsm-directories-and-files-layout)in your [InfluxDB data directory](/influxdb/v2/reference/internals/file-system-layout/#tsm-directories-and-files-layout).

```sh
# 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](/influxdb/v2/reference/internals/file-system-layout/#tsm-directories-and-files-layout).
* Use the `--rollup` flag with the value, `b`, to return a bucket-level summary of cardinality.

```sh
# 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](/influxdb/v2/reference/internals/file-system-layout/#tsm-directories-and-files-layout).
* Use the `--rollup` flag with the value, `r`, to return a retention-policy-level summary of cardinality.

```sh
# 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](/influxdb/v2/reference/internals/file-system-layout/#tsm-directories-and-files-layout).
* Use the `--rollup` flag with the value, `t`, to return a summary of total cardinality.

```sh
# 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](/influxdb/v2/reference/internals/file-system-layout/#tsm-directories-and-files-layout).
* Include the `--detailed` flag to return detailed cardinality summaries with tag and field counts.

```sh
# Syntax
influxd inspect report-db \
  --db-path <influxdb-data-directory> \
  --detailed

# Example
influxd inspect report-db \
  --db-path ~/.influxdbv2/engine/data \
  --detailed
```

[cardinality](/influxdb/v2/tags/cardinality/)[inspect](/influxdb/v2/tags/inspect/)
| Flag |  | Description | Input Type |
| --- | --- | --- | --- |
| 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 |