Kapacitor
Kapacitor is a real-time streaming data processing engine in the TICK stack. It can process both stream and batch data from InfluxDB, acting on this data in real-time via its programming language TICKscript. Route detailed alerts from Kapacitor to the right users in Squadcast.
How to integrate Kapacitor with Squadcast
In Squadcast: Using Kapacitor as an Alert Source
(1) From the navigation bar on the left, select Services. Pick the applicable Team from the Team-picker on the top. Next, click on Alert Sources for the applicable Service
(2) Search for Kapacitor from the Alert Source drop-down and copy the Webhook URL
For an Alert Source to turn active (indicated by a green dot - Receiving alerts against the name of the Alert Source in the drop-down), you can either generate a test alert or wait for a real-time alert to be generated by the Alert Source.
An Alert Source is active if there is a recorded incident via that Alert Source for the Service in the last 30 days.
In Kapacitor: Setup a Squadcast Webhook
Method 1: Configuring Squadcast Webhook through Chronograf
(1) From your Chronograf account, hover over the Alerts icon in the side bar, and select Manage Tasks
(2) You can either modify an existing Alert Rule or create one by selecting Add Alert Rule
(3) Within the Alert Rule Builder, give the Alert Rule a Name, select Alert Type, Time Series, Conditions
Scroll further to Alert Handlers
(a) Select post from the drop down
(3) (b) Paste the Webhook copied from Squadcast under HTTP endpoint for POST request
(4) Click on Save Rule
Method 2: Configure Squadcast Webhook in kapacitor.conf and use the endpoint in TICKscript
(1) Within kapacitor.conf, scroll to [[httppost]] and paste the following:
endpoint = "squadcast"
url = "<Copied_Webhook_URL_from_Squadcast"
headers = { Content-Type = "application/json" }
(2) Go to your TICKscript, within alert context, set up a post call to the above configured endpoint
In Mac OS, Kapacitor's configuration file is generally in /usr/local/etc/kapacitor.conf and in Linux machines, it generally is in /etc/kapacitor.conf
That is it, you are now good to go!
Whenever an alert is generated in Kapacitor, an incident is triggered for it in Squadcast. When the alert recovers in Kapacitor, the corresponding incident will be auto-resolved in Squadcast as well.