Skip to content

Comments

feat: add Nagios monitoring provider#5643

Open
285729101 wants to merge 1 commit intokeephq:mainfrom
285729101:feat/nagios-provider
Open

feat: add Nagios monitoring provider#5643
285729101 wants to merge 1 commit intokeephq:mainfrom
285729101:feat/nagios-provider

Conversation

@285729101
Copy link

@285729101 285729101 commented Feb 17, 2026

Closes #5648

Summary

  • Adds a new Nagios provider integration for the Keep alerting platform
  • Supports pull-based alert fetching via the Nagios XI REST API (/api/v1/objects/hoststatus and /api/v1/objects/servicestatus)
  • Supports push-based webhook notifications from Nagios (with webhook setup instructions)
  • Maps Nagios host states (UP/DOWN/UNREACHABLE) and service states (OK/WARNING/CRITICAL/UNKNOWN) to Keep's AlertStatus and AlertSeverity
  • Includes provider icon, documentation page, and mint.json navigation entry

Details

Files Added/Modified

  • keep/providers/nagios_provider/nagios_provider.py - Main provider implementation
  • keep/providers/nagios_provider/__init__.py - Package init
  • keep/providers/nagios_provider/alerts_mock.py - Alert mock data for testing
  • keep-ui/public/icons/nagios-icon.png - Provider icon (200x200 PNG)
  • docs/providers/documentation/nagios-provider.mdx - Provider documentation
  • docs/mint.json - Added nagios-provider to docs navigation

Nagios API Integration

  • Authentication: Nagios XI API Key (found in Admin > Manage API Keys)
  • Host Status: Fetches via GET /api/v1/objects/hoststatus?apikey=<KEY>
  • Service Status: Fetches via GET /api/v1/objects/servicestatus?apikey=<KEY>
  • Webhook: Configurable curl-based notification command for push-based alerting

Provider Features

  • PROVIDER_CATEGORY: Monitoring
  • PROVIDER_TAGS: alert
  • Scope validation via API connectivity test
  • SSL certificate verification toggle
  • Acknowledged problem detection

/claim #3960

Test plan

  • Verify provider loads correctly in the Keep platform
  • Test pull-based alert fetching against a Nagios XI instance
  • Test webhook-based alert ingestion
  • Verify severity and status mappings are correct
  • Confirm provider icon displays in the UI
  • Validate documentation renders correctly

🤖 Generated with Claude Code

Implements Nagios provider integration for Keep alerting platform:

- Pull-based alert fetching via Nagios XI REST API (host and service status)
- Webhook support for push-based notifications from Nagios
- Severity and status mapping for Nagios host states (UP/DOWN/UNREACHABLE)
  and service states (OK/WARNING/CRITICAL/UNKNOWN)
- Authentication via Nagios XI API key
- Provider icon and documentation

/claim keephq#3960
@greptile-apps
Copy link
Contributor

greptile-apps bot commented Feb 17, 2026

Target branch is not in the allowed branches list.

@vercel
Copy link

vercel bot commented Feb 17, 2026

@285729101 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:XL This PR changes 500-999 lines, ignoring generated files. label Feb 17, 2026
@CLAassistant
Copy link

CLAassistant commented Feb 17, 2026

CLA assistant check
All committers have signed the CLA.

@dosubot dosubot bot added the Provider Providers related issues label Feb 17, 2026
@285729101 285729101 force-pushed the feat/nagios-provider branch from 619000b to ddeb255 Compare February 17, 2026 16:45
@285729101
Copy link
Author

@talboren @Matvey-Kuk adds Nagios monitoring provider — pulls host/service alerts via Nagios CGI API.

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

Labels

🙋 Bounty claim Provider Providers related issues size:XL This PR changes 500-999 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

feat: Add Nagios monitoring provider integration

2 participants