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:

Master

InfluxDB

in Minutes — Grab the Ultimate Cheatsheet

(Perfect for DevOps & SREs)

Most-used commands
Real-world configs/examples
Handy troubleshooting shortcuts
Your email is safe with us. No spam, ever.

Thankyou for your submission

We have sent the cheatsheet on your email!
Oops! Something went wrong while submitting the form.

InfluxDB

Cheatsheet

(Perfect for DevOps & SREs)

Most-used commands
Your email is safe with us. No spam, ever.

Thankyou for your submission

We have sent the cheatsheet on your email!
Oops! Something went wrong while submitting the form.

MORE ISSUES

Made with ❤️ in Bangalore & San Francisco 🏢

Doctor Droid