PagerDuty Alert Integration

Setup

Prerequisites

Pagerduty account with elevated privileges
Pagerduty Service created and configured with Events API v2 integration

Configure PagerDuty Integration

In your PagerDuty account, navigate to the desired Service and access its “Integrations” settings.
Add a new “Events API v2” integration and configure it according to your requirements.
Copy the Integration Key provided by PagerDuty for the newly created integration.
Navigate to the PagerDuty integration setup page in your Courier account and provide the necessary information, including the Integration Key.


Routing Key	Paste the Integration Key obtained from PagerDuty.
Event Action	Specify the event action (e.g., trigger) for the notifications.
Source	Enter the host name or fully qualified domain name (FQDN) of the source sending the notifications.
Severity	Choose the appropriate severity level (e.g., info, warning, error, critical) for the notifications.

Overrides

Routing Key

You can override the routing key by specifying a routing_key in the user profile using profile.pagerduty.routing_key.

{
  "profile": {
    "pagerduty": {
      "routing_key": "PROFILE_SPECIFIC_ROUTING_KEY"
    }
  }
}

If a routing_key is specified in profile.pagerduty, it will take precedence over the routing key from the main configuration.

Payload

You can use the provider override the payload sent to PagerDuty’s Events API. Supported overrides include the Severity and Source.

{
  "message": {
    "template": "NOTIFICATION_TEMPLATE_ID",
    "to": {
      "user_id": "1234567890"
    },
    "providers": {
      "pagerduty": {
        "override": {
          "body": {
            "payload": {
              "severity": "error",
              "source": "a different source"
            }
          }
        }
      }
    }
  }
}

For more information on supported payload overrides, refer to the PagerDuty Events API v2 documentation.

​Setup

​Prerequisites

​Configure PagerDuty Integration

​Overrides

​Routing Key

​Payload