Skip to content

feat: add Nagios provider with webhook support#6025

Closed
a638011 wants to merge 1 commit intokeephq:mainfrom
a638011:feat/nagios-provider
Closed

feat: add Nagios provider with webhook support#6025
a638011 wants to merge 1 commit intokeephq:mainfrom
a638011:feat/nagios-provider

Conversation

@a638011
Copy link
Copy Markdown

@a638011 a638011 commented Mar 7, 2026

Description

This PR adds a new Nagios provider that enables Keep to receive alerts from Nagios via webhook notifications.

Changes

  • ✅ Implement webhook-based Nagios provider
  • ✅ Support both host and service notifications
  • ✅ Handle all Nagios notification types (PROBLEM, RECOVERY, ACKNOWLEDGEMENT, FLAPPING, DOWNTIME)
  • ✅ Map Nagios states to Keep severity/status
  • ✅ Add comprehensive documentation with setup instructions
  • ✅ Include Nagios icon
  • ✅ Add provider to overview page and mint.json

Implementation Details

The provider follows the same webhook pattern as other monitoring providers (Checkmk, Icinga2, LibreNMS). It:

  • Accepts webhook POST requests from Nagios notification commands
  • Parses both host and service alert payloads
  • Generates stable alert IDs based on host/service names
  • Maps Nagios states (OK/WARNING/CRITICAL/UNKNOWN/UP/DOWN/UNREACHABLE) to Keep severities
  • Handles notification types for proper alert lifecycle (firing/resolved/acknowledged/suppressed)

Testing

Tested with mock alert data covering:

  • Service alerts (WARNING, CRITICAL, RECOVERY)
  • Host alerts (DOWN, UP, UNREACHABLE)
  • Acknowledgements and downtime notifications

Documentation

Complete setup guide included in docs/providers/documentation/nagios-provider.mdx with:

  • Notification command definitions for both hosts and services
  • Contact and contact group configuration
  • All supported Nagios macros
  • Links to official Nagios documentation

Closes #3960

/claim #3960

- Implement webhook-based Nagios provider for receiving alerts
- Support both host and service notifications
- Handle all Nagios notification types (PROBLEM, RECOVERY, ACKNOWLEDGEMENT, etc.)
- Add comprehensive documentation with setup instructions
- Include Nagios icon and provider overview entry

Closes keephq#3960
@vercel
Copy link
Copy Markdown

vercel bot commented Mar 7, 2026

@a638011 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 Mar 7, 2026
@CLAassistant
Copy link
Copy Markdown

CLAassistant commented Mar 7, 2026

CLA assistant check
All committers have signed the CLA.

@dosubot dosubot bot added Documentation Improvements or additions to documentation Feature A new feature labels Mar 7, 2026
@shahargl shahargl closed this Mar 9, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

🙋 Bounty claim Documentation Improvements or additions to documentation 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]: Nagios Provider

3 participants