PagerDuty

If your team uses PagerDuty, consider enabling Tesults to trigger and resolve incidents on PagerDuty.

What does using PagerDuty with Tesults do?

Tesults will automatically trigger and resolve incidents on PagerDuty based on the latest incoming test results for each of your targets on Tesults. If you are using Tesults for production environment monitoring and site reliability then triggering incidents on PagerDuty if key tests fail can be useful to notify team members that are on-call. Tesults will trigger an incident when results dip below 100% pass and resolve an incident automatically when tests are passing again.

How do I add PagerDuty to Tesults?

Create a project on Tesults.

Click Configuration from the menu and select PagerDuty.

Configuration menu

You will be presented with two options for integrating with PagerDuty

  1. Create Pager Duty integrations yourself within PagerDuty's interface and add your integration key to Tesults
  2. Have Tesults request authorization to create an integration on your behalf in your PagerDuty account
PagerDuty integration options

Option 1 - Create integrations yourself on PagerDuty and add your integration key to Tesults

If you select this option all of the targets for your project will be listed. For each target you can add an integration name and key corresponding to an integration you have setup in PagerDuty. You can choose to use the same integration across targets or have different targets trigger incidents to different integrations.

PagerDuty integration key paste

To complete setup paste the integration key and name from PagerDuty and click the save button. To do this you must first create an integration on PagerDuty. Begin by selecting a service to add the integration to and click the ‘+ New Integration’ button.

Pagerduty integration key

Enter a name for the Integration and then from the Integration Type dropdown list, select Tesults.

Pagerduty integration key

After clicking the Add Integration button you can view the integration you have added and the integration key is displayed. Copy this integration key and paste it in Tesults.

Pagerduty integration key

At this point, setup is complete. You are ready to go!

Option 2 - Tesults creates integrations on your behalf in PagerDuty

If you select this option then you will directed to PagerDuty to authorize Tesults to use your account.

PagerDuty authorization

After completing authorization you return to PagerDuty configuration in Tesults

Configuration add

All targets for your Tesults project are listed (in the example above there is only one). Each target can be assigned an integration to trigger incidents. Click the Add button for your chosen target.

Configuration select service

Select the service you want to add an integration for from the dropdown list and click the Integrate with selected service button.

Integration added

At this point Tesults creates the integration and is now enabled to trigger and resolve incidents based on the test results for the target that you have configured. You are ready to go!

PagerDuty can be removed from each target by clicking the remove button for a particular target or from the entire project by clicking the Remove PagerDuty button from the bottom of the page.