Documentation

Data retention in InfluxDB Clustered

InfluxDB Clustered enforces database retention periods at query time. Any points with timestamps beyond a database’s retention period are filtered out of query results, even though the data may still exist.

Database retention period

A database retention period is the duration of time that a database retains data. Retention periods are designed to automatically delete expired data and optimize storage without any user intervention.

Retention periods can be as short as an hour or infinite. Points in a database with timestamps beyond the defined retention period (relative to now) are not queryable, but may still exist in storage until fully deleted.

View database retention periods

Use the influxctl database list command to view your databases’ retention periods.

When does data actually get deleted?

InfluxDB routinely deletes Parquet files containing only expired data. InfluxDB retains expired Parquet files for approximately 100 days for disaster recovery. After the disaster recovery period, expired Parquet files are permanently deleted and can’t be recovered.


Was this page helpful?

Thank you for your feedback!


The future of Flux

Flux is going into maintenance mode. You can continue using it as you currently are without any changes to your code.

Read more

New in InfluxDB 3.2

Key enhancements in InfluxDB 3.2 and the InfluxDB 3 Explorer UI is now generally available.

See the Blog Post

InfluxDB 3.2 is now available for both Core and Enterprise, bringing the general availability of InfluxDB 3 Explorer, a new UI that simplifies how you query, explore, and visualize data. On top of that, InfluxDB 3.2 includes a wide range of performance improvements, feature updates, and bug fixes including automated data retention and more.

For more information, check out: