Skip to content

feat(providers): Add SNMP trap receiver provider#5540

Open
njg7194 wants to merge 1 commit intokeephq:mainfrom
njg7194:feat/snmp-provider
Open

feat(providers): Add SNMP trap receiver provider#5540
njg7194 wants to merge 1 commit intokeephq:mainfrom
njg7194:feat/snmp-provider

Conversation

@njg7194
Copy link

@njg7194 njg7194 commented Feb 1, 2026

Summary

Adds a new SNMP Provider that receives SNMP traps and converts them to Keep alerts.

Features

  • SNMP v1/v2c/v3 support
  • SNMPv3 security (MD5/SHA auth, DES/AES encryption)
  • Background consumer pattern
  • Standard trap recognition with severity mapping
  • Webhook mode for external forwarders

Issue

Closes #2112

Files

  • keep/providers/snmp_provider/ - Main implementation
  • docs/providers/documentation/snmp-provider.mdx - Documentation
  • tests/test_snmp_provider.py - Unit tests

This commit adds a new SNMP provider that allows Keep to receive and process
SNMP traps from network devices and convert them to alerts.

Features:
- SNMP v1/v2c/v3 trap receiver support
- SNMPv3 authentication (MD5, SHA family) and privacy (DES, 3DES, AES family)
- Automatic severity mapping for standard traps (coldStart, warmStart, linkDown, linkUp, etc.)
- Consumer pattern for continuous trap listening
- Webhook endpoint support for external trap forwarders
- Comprehensive test coverage

Closes keephq#2112
@vercel
Copy link

vercel bot commented Feb 1, 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:XXL This PR changes 1000+ lines, ignoring generated files. label Feb 1, 2026
@CLAassistant
Copy link

CLA assistant check
Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.


SNMP Provider Contributor seems not to be a GitHub user. You need a GitHub account to be able to sign the CLA. If you have already a GitHub account, please add the email address used for this commit to your account.
You have signed the CLA already but the status is still pending? Let us recheck it.

@dosubot
Copy link

dosubot bot commented Feb 1, 2026

Related Documentation

No published documentation to review for changes on this repository.

Write your first living document

How did I do? Any feedback?  Join Discord

@greptile-apps
Copy link
Contributor

greptile-apps bot commented Feb 1, 2026

Target branch is not in the allowed branches list.

@dosubot dosubot bot added the Provider Providers related issues label Feb 1, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Provider Providers related issues size:XXL This PR changes 1000+ lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[🔌 Provider]: SNMP provider

2 participants