This is archived documentation for InfluxData product versions that are no longer maintained. For newer documentation, see the latest InfluxData documentation.

In addition to defining alert handler in TICKscript Kapacitor supports an alert system that follows a publish subscribe design pattern. Alerts are published to a topic and handlers subscribe to a topic.


An alert topic is simply a namespace where alerts are grouped. When an alert event fires it is assigned to a topic. Multiple handlers can be defined on a topic and all handlers process each alert event for the topic.


A handler takes action on incoming alert events for a specific topic. Each handler operates on exactly one topic.

A handler definition has a few properties:

  • ID - The unique ID of the handler.
  • Kind - The kind of handler, see handlers for a list of available kinds.
  • Match - A lambda expression to filter matching alerts. By default all alerts match, see matching for details on the match expression.
  • Options - A map of values, differs by kind.


See the Using Alert Topics example for a walk through defining and using alert topics.