Configuring PagerDuty

PagerDuty provides alerting, on-call scheduling, escalation policies and incident tracking to increase uptime of your apps, servers, websites and databases. The integration allows you to create and resolve incidents at PagerDuty, and we have worked together to make the integration seamless. To get started, you will first need to setup a PagerDuty account at https://www.pagerduty.com/.

Integration Functionality

  • Create an incident from within Uptime.com and a corresponding incident will appear on PagerDuty
  • Resolve incidents from within Uptime.com and the corresponding incident will be resolved on PagerDuty    

Integration Setup

First, login to your PagerDuty account, and click Services from the Configuration menu. From the Services page, you have two options depending on whether you are adding your integration to an existing service, or if the service is new.

  • For a New Service, click Add New Service.
  • For an Existing Service, click the Service Name, then click Integrations>New Integration.

Next, search for the Uptime.com service from the Integration Type menu and then enter an Integration Name. If you are creating a new service for your integration, enter a Name for your new service in General Settings. Then, in the Incident Settings section, specify the Escalation Policy, Notification Urgency, and Incident Behavior for your new service.

To save your integration, click Add Service or Add Integration.

On the next screen, copy the Integration Key provided by PagerDuty.

Return to Uptime.com. In order to activate the integration of PagerDuty within your Uptime account, you will go to Notifications>Integrations, then click New Profile. Select PagerDuty as the Provider Type when adding a new push notifications profile.

Paste the Integration Key copied previously into the Integration Key field, Name this Integration, and then click Save.

pager-duty.png

Use Auto-Resolve Incident to automatically resolve alerts. If you select to auto resolve upon check up, then your alerts will be resolved automatically within PagerDuty once a check is no longer registering downtime.

Once you've configured your PagerDuty integration, you will need to assign it to a contact and make sure that contact is notified when a Check goes down.

First, click Notifications>Contacts>New Contact. Select PagerDuty from the Push Notifications field within the New Contact screen.

Finally, return to your Check’s Edit screen and assign PagerDuty as one of the Contacts to be notified of a downtime event.

Test your integration with one of the following two options:

  1. Force the Check assigned to your Integration to fail by altering it (HTTPS checks can use a misspelling of the domain, for example)
  2. Click Notifications>Contacts, then click Actions>Test to send a test to the Contact

Test.png