InfluxDB ERR: series overflow

The number of series in the database exceeds the configured limit.

Understanding InfluxDB

InfluxDB is a powerful time-series database designed to handle high write and query loads. It is widely used for monitoring, analytics, and real-time data processing. InfluxDB excels at storing large volumes of time-stamped data, making it ideal for IoT, DevOps monitoring, and real-time analytics applications.

Identifying the Symptom: ERR: series overflow

When working with InfluxDB, you might encounter the error message: ERR: series overflow. This error indicates that the number of series in your database has exceeded the configured limit, preventing new series from being created.

Understanding the Issue: Series Overflow

InfluxDB organizes data into series, which are unique combinations of a measurement, tag set, and field key. The series overflow error occurs when the number of unique series surpasses the limit set in the database configuration. This limit is in place to prevent excessive memory usage and ensure optimal performance.

Why Series Overflow Occurs

The series overflow issue often arises in environments with high cardinality, where there are many unique combinations of tags and fields. This can happen if you have a large number of unique tag values or if your data model is not optimized for InfluxDB.

Steps to Fix the Series Overflow Issue

1. Review and Optimize Your Data Model

Start by reviewing your data model to ensure it is optimized for InfluxDB. Consider the following:

  • Reduce the number of unique tag values. Avoid using high-cardinality fields as tags.
  • Consolidate similar measurements where possible.
  • Use fewer tags and fields to reduce the number of unique series.

2. Increase the Series Limit

If optimizing the data model is not feasible or sufficient, you can increase the series limit in the InfluxDB configuration. Follow these steps:

  1. Open the InfluxDB configuration file, typically located at /etc/influxdb/influxdb.conf.
  2. Locate the [data] section and find the max-series-per-database setting.
  3. Increase the value of max-series-per-database to a higher number that suits your needs.
  4. Save the configuration file and restart InfluxDB using the command: sudo systemctl restart influxdb.

3. Monitor Series Usage

Regularly monitor your series usage to prevent future overflow issues. Use the following query to check the current number of series:

SHOW SERIES CARDINALITY

This query provides the total number of series in your database, helping you track usage trends over time.

Additional Resources

For more information on managing series and optimizing InfluxDB, refer to the following resources:

Never debug

InfluxDB

manually again

Let Dr. Droid create custom investigation plans for your infrastructure.

Start Free POC (15-min setup) →
Automate Debugging for
InfluxDB
See how Dr. Droid creates investigation plans for your infrastructure.

MORE ISSUES

Made with ❤️ in Bangalore & San Francisco 🏢

Doctor Droid