AlertOps Notification Integration for Checkmk

Send Checkmk alerts directly to AlertOps with a simple, configurable webhook integration.

This Checkmk Extension Package (MKP) enables seamless delivery of host and service notifications from Checkmk to AlertOps. It uses a lightweight Python notification script that transforms Checkmk’s built-in environment variables into a structured JSON payload and posts it to your AlertOps webhook endpoint.

The integration is ideal for teams who want reliable alert delivery, routing, escalation, and noise reduction through AlertOps—without modifying the core Checkmk configuration.

🚀 Features

• Native Checkmk notification script (Python 3)
• Environment-driven webhook URL (ALERTOPS_WEBHOOK_URL) can be set per site
• Automatic severity mapping (OK/WARN/CRIT/UNKNOWN → AlertOps priority)
• Host & service alert support
• Clean, JSON-based payload with timestamps
• Requires no agent modifications
• Safe to run in containerized Checkmk (Docker)

📦 What’s Included

AlertOps Notification Integration for Checkmk

Send Checkmk alerts directly to AlertOps with a simple, configurable webhook integration.

This Checkmk Extension Package (MKP) enables seamless delivery of host and service notifications from Checkmk to AlertOps. It uses a lightweight Python notification script that transforms Checkmk’s built-in environment variables into a structured JSON payload and posts it to your AlertOps webhook endpoint.

The integration is ideal for teams who want reliable alert delivery, routing, escalation, and noise reduction through AlertOps—without modifying the core Checkmk configuration.

🚀 Features

• Native Checkmk notification script (Python 3)
• Environment-driven webhook URL (ALERTOPS_WEBHOOK_URL) can be set per site
• Automatic severity mapping (OK/WARN/CRIT/UNKNOWN → AlertOps priority)
• Host & service alert support
• Clean, JSON-based payload with timestamps
• Requires no agent modifications
• Safe to run in containerized Checkmk (Docker)

📦 What’s Included

• local/share/check_mk/notifications/alertops_notification.py

• local/bin/alertops_notification (wrapper)

This MKP registers a new Checkmk notification method:

Visible under:

Setup → Events & Notifications → Notification Rules → Method

🔧 Configuration

1. Set the AlertOps Webhook URL (site-level environment variable)

omd config set ALERTOPS_WEBHOOK_URL "https://notify.alertops.com/POSTAlert/xxxx/CheckMK"

omd restart

2. Enable the Notification Rule

In Checkmk:

Setup → Events & Notifications → Notification Rules

Add a rule:

• Notification Method: AlertOps Notification
• Match host/service: Select any test object
• Save and activate changes

---

🧪 Testing

1. Open any monitored host or service
2. Click Commands
3. Select Simulate notification
4. Confirm:
   • A rule matches
   • AlertOps receives the POST
   • Payload fields are populated as expected

---

🛠 Payload Example

{
  "EventKey": "hostname_cpu_utilization",
  "Source": "Checkmk",
  "Host": "hostname",
  "Service": "CPU utilization",
  "State": "CRITICAL",
  "Severity": "critical",
  "NotificationType": "PROBLEM",
  "Summary": "CRITICAL: CPU utilization on hostname",
  "Message": "CPU load above threshold",
  "Resolved": false,
  "Timestamp": "2025-12-04T11:29:48Z"
}

📝 Requirements

• Checkmk 2.2+ (Raw or Enterprise)
• Python 3 (included with Checkmk)
• Internet access or internal routing to the AlertOps webhook