PagerDuty Notifications

Using PagerDuty Events API v2, you can send Manako incidents as PagerDuty alerts.

Prerequisites: Obtaining a PagerDuty Integration Key

1. Log in to PagerDuty

   Log in to PagerDuty.

2. Create or select a service

   From Services > Service Directory, select the service that will receive Manako alerts (or create a new one).

3. Add an Integration

   On the service’s Integrations tab, click “Add Integration” and select “Events API v2”.

4. Copy the Integration Key

   Copy the 32-character hex string that is displayed.

Note

The Integration Key is a 32-character hexadecimal string (e.g., a1b2c3d4e5f6...). Note that this is different from an API Key.

Manako Configuration

1. Open the “Notification Channels” menu in the dashboard
2. Click “Add Channel” and select PagerDuty as the Type
3. Paste the Integration Key (Routing Key)
4. Enter a channel name and click “Add Channel”

Behavior

Manako Event	PagerDuty Action	severity
Incident Created	trigger (create alert)	critical
Incident Created (warning)	trigger	warning
Incident Recovered	resolve (resolve alert)	-
Web Change Detected	Not sent	-

Note

Since PagerDuty is an incident management tool, web change detection notifications are not sent. If you want to receive web change detection notifications, use Slack or Webhook channels in combination.

Deduplication

Manako sets manako-{Incident ID} as PagerDuty’s dedup_key. Notifications for the same incident will not be duplicated. Recovery notifications use this dedup_key to identify and close the corresponding alert.