Multi-channel alert routing with deduplication, throttling, and escalation policies. Ingests alerts from Prometheus Alertmanager, uptime monitors, and custom sources, then routes them to Slack, email, webhook, PagerDuty, or SMS. Replaces PagerDuty alert routing and OpsGenie.
Set your license key with nself license set nself_pro_... before installing. Ships with ɳSelf v1.1.0.
nself license set nself_pro_...
nself plugin install nself-alert-router
nself build
nself start| Variable | Required | Default | Description |
|---|---|---|---|
PLUGIN_ALERT_SLACK_WEBHOOK | No | — | Slack incoming webhook URL for alert delivery |
PLUGIN_ALERT_PAGERDUTY_KEY | No | — | PagerDuty Events API v2 integration key (bridge mode) |
PLUGIN_ALERT_DEDUP_WINDOW_SECONDS | No | 300 | Window for deduplicating identical alerts |
PLUGIN_ALERT_THROTTLE_PER_HOUR | No | 20 | Max alerts per channel per hour before throttling kicks in |
| Endpoint | Method | Description |
|---|---|---|
/alerts/ingest | POST | Ingest alert from any source (Alertmanager-compatible payload) |
/alerts/routes | GET / POST | List or create routing rules |
/alerts/history | GET | Alert delivery history with dedup/throttle metadata |
/alerts/channels | GET / POST | Manage notification channels (Slack, email, webhook, SMS) |
/health | GET | Plugin health check |
PagerDuty charges $21/user/mo on the Professional plan. For a 5-person team that is $105/mo for alert routing alone. nself-alert-router handles routing, deduplication, and throttling for $0.99/mo. If you still need PagerDuty on-call scheduling, use the bridge mode (PLUGIN_ALERT_PAGERDUTY_KEY) to forward SEV1/SEV2 alerts while routing everything else locally.
Port: 3834 | Bundle: ɳSentry ($0.99/mo) or ɳSelf+ ($3.99/mo) | Ships: v1.1.0