Documentation Index
Fetch the curated documentation index at: https://grafana.com/llms.txt
Fetch the complete documentation index at: https://grafana.com/llms-full.txt
Use this file to discover all available pages before exploring further.
STOP! If you are an AI agent or LLM, read this before continuing. This is the HTML version of a Grafana documentation page. Always request the Markdown version instead - HTML wastes context. Get this page as Markdown: https://grafana.com/docs/grafana-cloud/alerting-and-irm/irm/integrations/alert-sources/kapacitor.md (append .md) or send Accept: text/markdown to https://grafana.com/docs/grafana-cloud/alerting-and-irm/irm/integrations/alert-sources/kapacitor/. For the curated documentation index, use https://grafana.com/llms.txt. For the complete documentation index, use https://grafana.com/llms-full.txt.
Kapacitor integration for Grafana IRM
The Kapacitor integration for Grafana IRM handles ticket events sent from Kapacitor webhooks. The integration provides grouping, auto-acknowledge and auto-resolve logic via customizable alert templates.
Configure Grafana IRM to receive alerts from Kapacitor
- In Grafana IRM, navigate to IRM > Integrations > Monitoring Systems
- Click + New integration
- Select Kapacitor from the list of available integrations
- Enter a name and description for the integration, click Create
- A new page will open with the integration details. Copy the IRM Integration URL from HTTP Endpoint section
Configure Kapacitor to send alerts to Grafana IRM
To send an alert from Kapacitor, you can follow these steps:
Create a Kapacitor TICKscript or modify an existing one to define the conditions for triggering the alert
The TICKscript specifies the data source, data processing, and the alert rule. Here’s an example of a simple TICKscript:
tickscriptstream |from() .measurement('measurement_name') .where(lambda: <condition>) |alert() .webhook('<webhook_url>')Replace
'measurement_name'with the name of the measurement you want to monitor,<condition>with the condition that triggers the alert, and'<webhook_url>'with IRM Integration URLSave the TICKscript file with a
.tickextension, for example,alert_script.tickStart the Kapacitor service using the TICKscript:
Bashkapacitor define <alert_name> -tick /path/to/alert_script.tick kapacitor enable <alert_name> kapacitor reloadReplace
<alert_name>with a suitable name for your alertEnsure that the Kapacitor service is running and actively monitoring the data
When the condition defined in the TICKscript is met, Kapacitor will trigger the alert and send a POST request to the specified webhook URL with the necessary information. Make sure your webhook endpoint is configured to receive and process the incoming alerts from Kapacitor
Related topics
Was this page helpful?
Related resources from Grafana Labs


