Notification Channels

Notification channels define where alarm notifications are delivered. Supported types: webhook (HTTP POST with optional HMAC signature), Slack (incoming webhook), and email (raw SMTP). Sensitive credentials (secrets, passwords, webhook URLs) are encrypted at rest and masked in API responses.

Fields & Columns

Name Description
Name Unique identifier for the channel
Type Channel type: webhook, slack, or email
Enabled Whether the channel is active for notification delivery

How To

Add a webhook channel

  1. Click "Add Channel"
  2. Enter a name and select "webhook" type
  3. Provide the webhook URL
  4. Optionally add an HMAC secret for request signature verification
  5. Click "Create"

Test a channel

  1. Find the channel in the table
  2. Click the "Test" button
  3. A test notification will be sent to verify delivery
  4. Check the result message for success or error details

Gotchas

  1. Sensitive fields (secrets, passwords, Slack URLs) are shown as "********" in the UI and API responses.
  2. When editing a channel, leaving sensitive fields as "********" preserves the existing value.
  3. Deleting a channel cascades to delete all associated policies. Notification log entries are preserved.
  4. Webhook channels support HMAC-SHA256 signatures via the X-Mipo-Signature-256 header.
  5. Email uses raw SMTP and requires a valid SMTP server. Only plain text is supported — this minimizes formatting issues across email clients and avoids security risks from HTML rendering.

API Calls (7)

Method Path Description
GET /api/admin/alerting/notification-channels List all notification channels
POST /api/admin/alerting/notification-channels Create a new notification channel
GET /api/admin/alerting/notification-channels/:id Get channel details
PATCH /api/admin/alerting/notification-channels/:id Update a channel
DELETE /api/admin/alerting/notification-channels/:id Delete a channel
POST /api/admin/alerting/notification-channels/:id/test Send a test notification
POST /api/admin/alerting/notification-channels/test-config Test unsaved channel configuration before creating

Related Pages

  • Notification Policies — Policies connect alarm rules to channels with severity and transition filters
  • Notification Log — Log shows delivery history and errors for all channels
  • Alarms — Alarm state transitions trigger notifications through policies