Skip to content

feat: Add SNMP provider for trap-based alerting#6402

Open
maximdanilchenko wants to merge 1 commit intokeephq:mainfrom
maximdanilchenko:coderbot/5-fix
Open

feat: Add SNMP provider for trap-based alerting#6402
maximdanilchenko wants to merge 1 commit intokeephq:mainfrom
maximdanilchenko:coderbot/5-fix

Conversation

@maximdanilchenko
Copy link
Copy Markdown

Summary

Implements an SNMP provider that receives SNMP traps/events via webhook and converts them into Keep alerts.

Features

  • Supports all 7 SNMP generic trap types (coldStart, warmStart, linkDown, linkUp, authenticationFailure, egpNeighborLoss, enterpriseSpecific)
  • Severity mapping from SNMP conventions to Keep's AlertSeverity
  • Intelligent status resolution (linkUp→RESOLVED, linkDown→FIRING, etc.)
  • Fingerprint-based deduplication using OID + agent address
  • Flexible field name handling for various SNMP trap forwarder JSON formats
  • No additional Python dependencies (processes pre-formatted JSON webhooks)

Changes

  • keep/providers/snmp_provider/__init__.py — package init
  • keep/providers/snmp_provider/snmp_provider.py — main provider implementation
  • tests/providers/snmp_provider/test_snmp_provider.py — 30 unit tests

Testing

python -m pytest tests/providers/snmp_provider/ -v

Closes #2112

Implements an SNMP provider that receives SNMP traps via webhook and
converts them into Keep alerts. Supports all 7 generic trap types,
severity mapping, intelligent status resolution, and fingerprint-based
deduplication.

Closes keephq#2112
@dosubot dosubot Bot added the size:L This PR changes 100-499 lines, ignoring generated files. label May 5, 2026
@CLAassistant
Copy link
Copy Markdown

CLAassistant commented May 5, 2026

CLA assistant check
All committers have signed the CLA.

@dosubot dosubot Bot added Feature A new feature Provider Providers related issues labels May 5, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Feature A new feature Provider Providers related issues 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]: SNMP provider

2 participants