Pagerduty Integration

What does ChaosSearch offer PagerDuty users?

ChaosSearch has a one-directional integration with PagerDuty. It's easy to configure alerts to go right into your PagerDuty account to start notifying the right engineers.

Add a Custom Webhook Integration in ChaosSearch, and start taking advantage of PagerDuty's alert and event management platform with the ChaosSearch alert notification system.

Functionality of the inetegration

When an alert is triggered in ChaosSearch, an alert is created in PagerDuty automatically through the integration.

Configuring the integration

In PagerDuty add an API integration to a service or utilize on that has already been created for ChaosSearch

  • You'll need to have PagerDuty account
  • Navigate to Services and select Service Directory
  • Once at Service Directory page create a new service or chose from one of
    the available services.
step 3step 3

step 3

  • From the Service page go to the Integrations tab and click on the "+
    Add an Integration"
    button.
Step 4Step 4

Step 4

  • From the Add Integrations page choose the Events API V2
Step 5Step 5

Step 5

  • From the newly created integration drill down from the right corner.
    The values of interest are the Integration Key and Integration URL
    (Alert Events)
    for our integration with Chaossearch.
Ste 6Ste 6

Ste 6

In ChaosSearch

  • Navigate to three bars Menu to Monitoring / Alerting in the Analytics section
  • Click Destinations and Add Destination
  • Give the destination a name and change Type to Custom Webhook
  • Check Define endpoint by URL
  • In the Webhook paste the Integration URL (Alert Events) value: https://events.pagerduty.com/v2/change/enqueue
  • At the bottom in the Header Information click add header and add the Key X-Routing-Key and the value will be the Integration Key from your PagerDuty service
  • Click Create

Create Monitor

To create a monitor in ChaosSearch, please follow these instructions

Once you completed the Monitor creation, you will then need to define the trigger.

📘

Configure Actions section

In the final step of creating a trigger, the Message payload should be configured as seen below.

{"event_action":"trigger", "payload":{"summary":"thing","severity":"critical","source":"CS"}}

Did this page help you?