Skip to content

feat: Add Nagios monitoring provider#5654

Open
kai-agent-free wants to merge 2 commits intokeephq:mainfrom
kai-agent-free:feat/nagios-provider
Open

feat: Add Nagios monitoring provider#5654
kai-agent-free wants to merge 2 commits intokeephq:mainfrom
kai-agent-free:feat/nagios-provider

Conversation

@kai-agent-free
Copy link

Summary

Implements a Nagios monitoring provider for Keep, closing #3960.

What is Nagios?

Nagios is one of the most widely-used open source monitoring tools for systems, networks, and infrastructure. It monitors hosts and services, alerting when things go wrong and when they recover.

Implementation

Provider (nagios_provider.py)

  • Webhook-based integration via Nagios notification commands (curl)
  • Maps Nagios service states (OK, WARNING, CRITICAL, UNKNOWN) to Keep severity levels
  • Maps Nagios host states (UP, DOWN, UNREACHABLE) to Keep severity levels
  • Handles all notification types: PROBLEM, RECOVERY, ACKNOWLEDGEMENT, FLAPPINGSTART/STOP, DOWNTIMESTART/END
  • Fingerprints by host_name + service_description for proper deduplication
  • Parses Unix timestamps from Nagios into UTC ISO format
  • Handles both host and service notifications with appropriate descriptions

Webhook Setup

Detailed documentation for configuring Nagios notification commands to send alerts to Keep, including:

  • Service notification command definition
  • Host notification command definition
  • Contact configuration
  • All standard Nagios macros mapped to webhook payload fields

Mock Alerts (alerts_mock.py)

Sample Nagios alert payload for testing.

Pattern

Follows the same pattern as existing webhook-based providers (Checkmk, Zabbix, etc.).

Closes #3960

@vercel
Copy link

vercel bot commented Feb 19, 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 19, 2026
@CLAassistant
Copy link

CLAassistant commented Feb 19, 2026

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.
You have signed the CLA already but the status is still pending? Let us recheck it.

@greptile-apps
Copy link
Contributor

greptile-apps bot commented Feb 19, 2026

Target branch is not in the allowed branches list.

@dosubot dosubot bot added Feature A new feature Provider Providers related issues labels Feb 19, 2026
@kai-agent-free
Copy link
Author

I have read the CLA Document and I hereby sign the CLA.

Implements Nagios provider for Keep (keephq#3960):
- Webhook-based integration via Nagios notification commands
- Maps Nagios service states (OK/WARNING/CRITICAL/UNKNOWN) and host states (UP/DOWN/UNREACHABLE) to Keep severity/status
- Handles notification types: PROBLEM, RECOVERY, ACKNOWLEDGEMENT, FLAPPING, DOWNTIME
- Includes mock alerts and webhook setup documentation
- Fingerprints by host_name + service_description for deduplication
@kai-agent-free
Copy link
Author

I have read the CLA Document and I hereby sign the CLA

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]: Nagios Provider

2 participants