Skip to content

feat: add Nagios provider #3960#6218

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

feat: add Nagios provider #3960#6218
jyoti369 wants to merge 1 commit intokeephq:mainfrom
jyoti369:feat/nagios-provider

Conversation

@jyoti369
Copy link
Copy Markdown

@jyoti369 jyoti369 commented Apr 6, 2026

Summary

Adds a Nagios provider to Keep, supporting both API polling (Nagios XI) and webhook-based alert ingestion.

What's included

  • keep/providers/nagios_provider/nagios_provider.py - provider implementation
  • docs/providers/documentation/nagios-provider.mdx - setup docs with webhook examples
  • docs/snippets/providers/nagios-snippet-autogenerated.mdx - auto-generated snippet
  • keep-ui/public/icons/nagios-icon.png - provider icon
  • Registered in mint.json, overview.mdx, overview.md

How it works

API polling: Hits the Nagios XI REST API (/nagiosxi/api/v1/objects/servicestatus and /hoststatus) using an API key. Maps Nagios states (0-3 for services, 0-2 for hosts) to Keep's AlertStatus and AlertSeverity.

Webhooks: Accepts JSON payloads from Nagios notification commands. The docs include ready-to-use commands.cfg examples for both host and service notifications.

Auth config

Field Description Sensitive
host_url Nagios XI base URL no
api_key API key from Admin > System Config yes

Provider details

  • Category: Monitoring
  • Tags: alert
  • Scopes: read_alerts (validated via /system/status endpoint)
  • Webhook installation required: yes

Fixes #3960

Demo

Short walkthrough showing the provider code, docs, icon, and file structure:

Watch on Google Drive

@dosubot dosubot bot added the size:L This PR changes 100-499 lines, ignoring generated files. label Apr 6, 2026
@CLAassistant
Copy link
Copy Markdown

CLAassistant commented Apr 6, 2026

CLA assistant check
All committers have signed the CLA.

@dosubot dosubot bot added Documentation Improvements or additions to documentation Feature A new feature Provider Providers related issues labels Apr 6, 2026
@jyoti369
Copy link
Copy Markdown
Author

jyoti369 commented Apr 6, 2026

Added a short demo showing the provider setup, code structure, docs, and icon:

https://drive.google.com/file/d/1PWc-GmWoBrJdf1KZmOukn48ujD5IcEzr/view\?usp\=sharing

Let me know if anything else is needed.

@jyoti369
Copy link
Copy Markdown
Author

jyoti369 commented Apr 8, 2026

hey, just wanted to check if the demo video and the PR look good so far? let me know if there are any changes needed or anything i should fix. thanks!

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

Labels

Documentation Improvements or additions to documentation 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