Kapacitor frequently asked questions

This page addresses frequent sources of confusion or important things to know related to Kapacitor. Where applicable, it links to outstanding issues on Github.





Is the alert state and alert data lost happen when updating a script?

Kapacitor will remember the last level of an alert, but other state-like data, such as data buffered in a window, will be lost.

How do I verify that Kapacitor is receiving data from InfluxDB?

There are a few ways to determine whether or not Kapacitor is receiving data from InfluxDB. The kapacitor stats ingress command outputs InfluxDB measurements stored in the Kapacitor database as well as the number of data points that pass through the Kapacitor server.

$ kapacitor stats ingress
Database   Retention Policy Measurement    Points Received
_internal  monitor          cq                        5274
_internal  monitor          database                 52740
_internal  monitor          httpd                     5274
_internal  monitor          queryExecutor             5274
_internal  monitor          runtime                   5274
_internal  monitor          shard                   300976
# ...

You can also use Kapacitor’s /debug/vars API endpoint to view and monitor ingest rates. Using this endpoint and Telegraf’s Kapacitor input plugin, you can create visualizations to monitor Kapacitor ingest rates. Below are example queries that use Kapacitor data written into InfluxDB using Telegraf’s Kapacitor input plugin:

Kapacitor ingest rate (points/sec)

SELECT sum(points_received_rate) FROM (SELECT non_negative_derivative(first("points_received"),1s) as points_received_rate FROM "_kapacitor"."autogen"."ingress" WHERE time > :dashboardTime: GROUP BY "database", "retention_policy", "measurement", time(1m)) WHERE time > :dashboardTime: GROUP BY time(1m)

Kapacitor ingest by task (points/sec)

SELECT non_negative_derivative("collected",1s) FROM "_kapacitor"."autogen"."edges" WHERE time > now() - 15m AND ("parent"='stream' OR "parent"='batch') GROUP BY task


Batches work but streams do not. Why?

Make sure port 9092 is open to inbound connections. Streams are a PUSH’d to port 9092 so it must be allowed through the firewall.

Is there a limit on the number of scripts Kapacitor can handle?

There is no software limit, but it will be limited by available server resources.

What causes unexpected or additional values with same timestamp?

If data is ingested at irregular intervals and you see unexpected results with the same timestamp, use the log node when ingesting data in your TICKscript to debug issues. This surfaces issues, for example, duplicate data hidden by httpOut.


Do you get better performance with running one complex script or having multiple scripts running in parallel?

Taking things to the extreme, best-case is one task that consumes all the data and does all the work since there is added overhead when managing multiple tasks. However, significant effort has gone into reducing the overhead of each task. Use tasks in a way that makes logical sense for your project and organization. If you run into performance issues with multiple tasks, let us know. As a last resort, merge tasks into more complex tasks.

Do template-based scripts use less resources or are they just an ease-of-use tool?

Templates are just an ease-of-use tool and make no difference in regards to performance.

How does Kapacitor handle high load?

If Kapacitor is unable to ingest and process incoming data before it receives new data, Kapacitor queues incoming data in memory and processes it when able. Memory requirements of queued data depend on the ingest rate and shape of the incoming data. Once Kapacitor is able to process all queued data, it slowly releases memory as the internal garbage collector reclaims memory.

Extended periods of high data ingestion can overwhelm available system resources forcing the operating system to stop the kapacitord process. The primary means for avoiding this issue are:

  • Ensure your hardware provides enough system resources to handle additional load.
  • Optimize your Kapacitor tasks. See below.

As Kapacitor processes data in the queue, it may consume other system resources such as CPU, disk and network IO, etc., which will affect the overall performance of your Kapacitor server.

How can I optimize Kapacitor tasks?

As you optimize Kapacitor tasks, consider the following:

“Batch” incoming data

batch queries data from InfluxDB in batches. As long as Kapacitor is able to process a batch before the next batch is queried, it won’t need to queue anything.

stream mirrors all InfluxDB writes to Kapacitor in real time and is more prone to queueing. If using stream, segment incoming data into time-based batches using window.

Was this page helpful?

Thank you for your feedback!

Introducing InfluxDB Clustered

A highly available InfluxDB 3.0 cluster on your own infrastructure.

InfluxDB Clustered is a highly available InfluxDB 3.0 cluster built for high write and query workloads on your own infrastructure.

InfluxDB Clustered is currently in limited availability and is only available to a limited group of InfluxData customers. If interested in being part of the limited access group, please contact the InfluxData Sales team.

Learn more
Contact InfluxData Sales

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.

Flux is going into maintenance mode and will not be supported in InfluxDB 3.0. This was a decision based on the broad demand for SQL and the continued growth and adoption of InfluxQL. We are continuing to support Flux for users in 1.x and 2.x so you can continue using it with no changes to your code. If you are interested in transitioning to InfluxDB 3.0 and want to future-proof your code, we suggest using InfluxQL.

For information about the future of Flux, see the following: