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/.
- 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
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 Configuration>Add New Service.
- For an Existing Service, click the Service Name, then click Configurations>New Integration, or select from Service Directory.
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.
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. Checks that returned to UP status before auto-resolve is applied will not automatically resolve in PagerDuty.
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 fails.
Assign Integration to Contacts
To add your integration to an existing contact, click on or type the name of the contact into the Assign to Contacts field within the integration setup screen.
You can designate a new contact from within the integration setup. Simply enter the name of your new contact into the Assign to Contacts field, and select it as depicted below:
Uptime.com will create a new contact and assign the integration to it. You can find this contact when you click Notifications>Contact.
Assign Integration Contact to a Check
If you have created a new or dedicated contact for your integration, you will need to add it to specific checks. If you have assigned the integration to a contact that is already assigned to one (or more) checks, you may skip this step.
Return to your Check’s Edit screen and assign this contact to the Contacts field to be notified of a downtime event. Alert data will appear in real time.
Test Your Integration
Test your integration with one of the following two options:
- Force the Check assigned to your Integration to fail by altering it (HTTPS checks can use a misspelling of the domain, for example)
- Click Notifications>Contacts, then click Actions>Test to send a test to the Contact