PagerDuty

CloudQA includes a ready-made PagerDuty integration that sends monitoring notifications to your PagerDuty account. Data flows one way, from CloudQA to PagerDuty.

How it works

When CloudQA detects a failure, it sends an event to a PagerDuty service. The event can open a new incident on that service or be grouped as an alert under an existing incident.

Before you start

• You need the Admin base role in PagerDuty. If you don’t have it, ask an Admin or Account Owner to set this up.
• CloudQA needs a service key and an event type. You get the key by creating a new PagerDuty service or by adding an integration to an existing one.

1. Configure PagerDuty

1. Log in to PagerDuty and choose Services from the Configuration menu.
2. Add the integration in one of two ways:
   • Existing service: open the service, go to the Integrations tab and select New Integration.
   • New service: follow PagerDuty’s guide to creating a service. Choose Use our API directly as the integration type, then select API in the dropdown. See the Events API v2.
3. Enter an integration name in the form monitoring-tool-service-name, for example CQAAPI.
4. Select Add Integration. You land on the service’s Integrations tab.
5. PagerDuty generates an Integration Key. Store it securely, because you need it in CloudQA.

2. Configure CloudQA

1. Open Settings and select the Integrations tab.

2. Select Add Integration, then the PagerDuty tab.

3. Enter the Service Key (the integration key from PagerDuty), set Event Type to trigger, and save.

   

4. On the same page, open the Notifications tab.

5. Select Add Notification, set the product type to Monitoring and the notification type to Pager Duty.

6. Set the conditions:

   • Priority: choose the level that matches the test case’s priority.
   • Consecutive failure: set how many failures in a row trigger a notification.

7. Select the PagerDuty Event and save.

Once configured, each test failure creates an incident in PagerDuty.