Influx Inspect

This page documents an earlier version of InfluxDB. InfluxDB v2.7 is the latest stable version.

Influx Inspect is a tool designed to view detailed information about on disk shards, as well as export data from a shard to line protocol that can be inserted back into the database.

influx_inspect [[command] [arguments]]

-help is the default command and will print usage for the tool.

The commands are:

    dumptsm              dumps low-level details about tsm1 files.
    dumptsi              dumps low-level details about tsi1 files.
    export               exports raw data from a shard to line protocol
    help                 display this help message
    inmem2tsi            convert existing in-memory (TSM-based) shards to TSI format
    report               displays a shard level report
    verify               verifies integrity of TSM files

influx_inspect dumptsm

Dumps low-level details about tsm files.


influx_inspect dumptsm [<flags>] <path>


-index bool

Dump raw index data.

default = false

-blocks bool

Dump raw block data.

default = false


Dump all data. Caution: This may print a lot of information.

default = false


Only display index and block data that match this key substring.

default = ""

influx_inspect dumptsi

Dumps low-level details about tsi1 files. dumptsi returns summary stats for each file if the command does not specify any flags.


influx_inspect dumptsi [<flags>] <path>



Dump raw series data.


Dump raw measurement data.


Dump raw tag keys.


Dump raw tag values.


Dump raw series for each tag value.

-measurement-filter <regular_expression>

Filters data by measurement regular expression.

-tag-key-filter <regular_expression>

Filters data by tag key regular expression.

-tag-value-filter <regular_expresssion>

Filters data by tag value regular expression.

influx_inspect export

Exports all tsm files to line protocol. This output file can be imported via the influx command.


influx_inspect export [flags]


-compress boolean (optional)

Compress the output.

default = false

-database string (optional)

Database to export.

default = ""

-retention string (optional)

Retention policy to export.

default = ""

-datadir string

Data storage path.

default = “$HOME/.influxdb/data”

-start string (optional)

The start of the time range. The date-time string must be RFC3339 format.

-end string (optional)

The end of the time range. The date-time string must be RFC3339 format.

-out string

Specifies location for export file

default = “$HOME/.influxdb/export”

-waldir string

WAL storage path.

default = “$HOME/.influxdb/wal”

Sample Commands

Export entire database and compress the output:

influx_inspect export -compress

Export data from a specific database and retention policy:

influx_inspect export -database mydb -retention autogen

Sample Data

This is a sample of what the output will look like.


randset value=97.9296104805 1439856000000000000
randset value=25.3849066842 1439856100000000000

influx_inspect inmem2tsi

Converts existing in-memory (TSM-based) shards to TSI (time series index) format. The index is written to a temporary location until complete and then moved to a permanent location. If an error occurs, then this operation will fall back to the original in-memory index.

Note: This tool is for offline conversion only. When TSI is enabled, new shards use the TSI format, but existing shards continue as TSM-based shards until converted offline.


influx_inspect inmem2tsi [ flags ]


-datadir <data_directory> string

Path to the data directory.

-waldir <wal_directory> string

Path to the WAL directory.

-v (optional)

Verbose output


$ influx_inspect inmem2tsi -datadir ~/.influxdb/data/stress/autogen/1 -waldir ~/.influxdb/wal/stress/autogen/1

influx_inspect report

Displays series meta-data for all shards. The default location is [$HOME/.influxdb].


influx_inspect report [flags]


-pattern regular expression/wildcard (optional)

Include only files matching the specified pattern.

default = ""

-detailed boolean

Report detailed cardinality estimates.

default = false

influx_inspect verify

Verifies the integrity of TSM files.


influx_inspect verify [flags]


-dir string (optional)

Root storage path

default = “/root/.influxdb”


The system does not have access to the meta store when exporting TSM shards. As such, it always creates the retention policy with infinite duration and replication factor of 1. End users may want to change this prior to re-importing if they are importing to a cluster or want a different duration for retention.

Was this page helpful?

Thank you for your feedback!

Set your InfluxDB URL

Introducing InfluxDB 3.0

The new core of InfluxDB built with Rust and Apache Arrow. Available today in InfluxDB Cloud Dedicated.

Learn more

State of the InfluxDB Cloud Serverless documentation

The new documentation for InfluxDB Cloud Serverless is a work in progress. We are adding new information and content almost daily. Thank you for your patience!

If there is specific information you’re looking for, please submit a documentation issue.