Skip to main content

PagerDuty

This guide shows you how to create a webhook to Merlinn in your PagerDuty account.

Overview​

Merlinn uses PagerDuty Generic Webhooks V3 in order to be notified when incidents/alerts happen. Once an incident happens, PagerDuty will send a webhook to your Merlinn account, kicking off the investigation.

For more information about PagerDuty webhooks, checkout the official documentation.

Prerequisites​

  • Working environment with an organization. If you don't have one, head over to the setup page.
  • A configured PagerDuty integration. To learn how to create one, check the PagerDuty integration guide.
  • ngrok tunnel that forwards traffic to your local Merlinn API. Install ngrok, start a tunnel at port 3000 (ngrok http 3000) and copy the tunnel URL.

Setup​

Follow these steps to connect Merlinn to PagerDuty:

  1. Inside your organization settings, go to "Webhooks".
  2. Locate the "PagerDuty" integration and click "Add".
  3. In the modal, click "Generate" to generate a new secret and copy it.

Once you've obtained your secret, go to your PagerDuty account dashboard and follow these steps:

  1. In the top navbar, choose Integrations > Generic Webhooks (V3).
  2. Click “New Webhook”
  3. In the Webhook URL, insert your ngrok tunnel URL followed by /webhooks/pagerduty, e.g https://1234abcd.ngrok.io/webhooks/pagerduty.
  4. In the scope type, choose "Account"
  5. In the event subscription section, click “Deselect all” and choose only “incident.triggered”
  6. Add a custom header called "x-merlinn-secret" and insert your secret.
  7. Click “Add Webhook”

That's it! Now Merlinn will be notified when an incident happens.