Advanced Kapacitor usage
On this page
Chronograf provides a user interface for Kapacitor, InfluxData’s processing framework for creating alerts, running ETL jobs, and detecting anomalies in your data. This guide offers insights into how Kapacitor interacts with Chronograf and introduces advanced Kapacitor usage within Chronograf.
Alert history management
Chronograf stores the information on the Alert History page as time series data in InfluxDB.
It stores it in the
chronograf database and in the
By default, this data is subject to an infinite retention policy (RP), that is, InfluxDB stores them forever.
Users who expect to have a large number of alerts and users who do not want to store their alert history forever may want to shorten the duration of that retention policy.
Modifying the retention policy in Chronograf
Use the Chronograf Admin page to modify the retention policy in the
In the Databases tab:
Step 1: Locate the
chronograf database and click on the infinity symbol (∞)
Step 2: Enter a different duration
The minimum allowable duration is one hour (
1h) and the maximum is infinite (
See the InfluxDB documentation for the list of acceptable duration units.
Step 3: Click the green check mark to save your changes
InfluxDB only keeps data in the
chronograf database that fall within that new duration; the system automatically deletes any data with timestamps that occur before the duration setting.
If you set the retention policy’s duration to one hour (
1h), InfluxDB automatically deletes any alerts that occurred before the past hour.
Those alerts no longer appear in your InfluxDB instance or on Chronograf’s Alert History page.
Looking at the image below and assuming that the current time is 19:00 on April 27, 2017, only the first three alerts would appear in your alert history; they occurred within the previous hour (18:00 through 19:00).
The fourth alert, which occurred on the same day at 16:58:50, is outside the previous hour and would no longer appear in the InfluxDB
chronograf database or on the Chronograf Alert History page.
Chronograf creates Kapacitor tasks using the information that you provide on the Rule Configuration page. It uses that information to communicate with Kapacitor and populate Chronograf alert pages. Pre-existing tasks, or TICKscripts, that you created and enabled on your Kapacitor instance without using Chronograf, have limited functionality in the user interface.
In Chronograf, you can:
- View pre-existing tasks the Alert Rules page
- View pre-existing task activity on the Alert History page
- Enable and disable pre-existing tasks on the Alert Rules page (this is equivalent to the
- Delete pre-existing tasks the Alert Rules page (this is equivalent to the
kapacitor delete taskscommand)
You cannot edit pre-existing tasks on the Chronograf Alert Rules page.
mytick task in the image below is a pre-existing task; its name appears on the Alert Rules page but you cannot click on it or edit its TICKscript in the interface.
Currently, you must manually edit your existing tasks and TICKscripts on your machine.
Support and feedback
Thank you for being part of our community! We welcome and encourage your feedback and bug reports for Chronograf and this documentation. To find support, the following resources are available: