Skip to content

feat: add Kapacitor provider#5636

Open
janisag07 wants to merge 1 commit intokeephq:mainfrom
janisag07:feat/kapacitor-provider
Open

feat: add Kapacitor provider#5636
janisag07 wants to merge 1 commit intokeephq:mainfrom
janisag07:feat/kapacitor-provider

Conversation

@janisag07
Copy link

Summary

Adds a new Kapacitor provider to receive time-series alerts from InfluxData's Kapacitor.

Changes

  • keep/providers/kapacitor_provider/kapacitor_provider.py — Full provider implementation
  • keep/providers/kapacitor_provider/alerts_mock.py — Sample TICKscript alerts (CPU, disk, service recovery)
  • tests/test_kapacitor_provider.py — Unit tests for all alert levels

Features

  • Webhook ingestion: Receives TICKscript HTTP POST alerts (JSON format)
  • API pull: Queries alerts via /kapacitor/v1/alerts/topics endpoint
  • Level mapping: CRITICAL→critical/firing, WARNING→warning/firing, INFO→info/firing, OK→low/resolved
  • Authentication: Optional HTTP Basic Auth (username/password)
  • PROVIDER_TAGS, PROVIDER_SCOPES, FINGERPRINT_FIELDS configured

Linked Issue

Closes #4754

Use Cases

  • Complex time-series alerts from InfluxDB data
  • TICKscript-based monitoring integration
  • Real-time data stream alerting

Benefits over direct PagerDuty

  • Alert correlation and enrichment in Keep
  • Side-loading context data before escalation
  • Better alert routing and noise reduction

Checklist

  • Provider follows existing patterns
  • Unit tests for all alert levels
  • CODE-DOC-TEMPLATE.md included
  • HTTP Basic Auth implemented

@vercel
Copy link

vercel bot commented Feb 16, 2026

Someone is attempting to deploy a commit to the KeepHQ Team on Vercel.

A member of the Team first needs to authorize it.

@dosubot dosubot bot added the size:L This PR changes 100-499 lines, ignoring generated files. label Feb 16, 2026
@greptile-apps
Copy link
Contributor

greptile-apps bot commented Feb 16, 2026

Target branch is not in the allowed branches list.

@CLAassistant
Copy link

CLAassistant commented Feb 16, 2026

CLA assistant check
All committers have signed the CLA.

@dosubot dosubot bot added the Feature A new feature label Feb 16, 2026
@janisag07
Copy link
Author

recheck

@janisag07 janisag07 force-pushed the feat/kapacitor-provider branch from e59657f to 50ec92c Compare February 17, 2026 12:28
@janisag07
Copy link
Author

recheck

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Feature A new feature size:L This PR changes 100-499 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[🔌 Provider]: Kapacitor

2 participants