How to Integrate Pingdom with PagerDuty

Introduction

Pingdom is a simple and convenient tool to monitor the uptime of your website and other infrastructure. It can be easily configured to send alerts to PagerDuty (via email), thus allowing you to take advantage of PagerDuty’s comprehensive alerting and incident tracking functionality. PagerDuty adds two-way phone, SMS, and email alerting to your existing Pingdom checks. You’ll also be able to configure automatic escalation of alerts, handle alerts on-the-go from a mobile phone, and set up on-call duty scheduling.

In PagerDuty:

  1. Click on the Services tab
  2. On the right sidebar, click Add New Service.
    SL-AddNewServiceButton
  3. Enter a name for this service and select an escalation policy. Start typing Pingdom under Integration Type to filter your choices.
    Configure your PagerDuty service
  4. Click the Add Service button.
  5. You’ll be taken to the service page. Copy the Integration email to the clipboard; you’ll need it to set up the integration in Pingdom.
    Copy the PagerDuty integration email

In Pingdom:

  1. Click on the Alerting icon, and then click on Alerting Endpoints.
    Pingdom Alerting Endpoints
  2. Click on ADD ALERTING ENDPOINT.
    Add a Pingdom alerting endpoint
  3. Enter a Name for your alerting endpoint, then click the ADD CONTACT METHOD button.
    Configure Alerting Endpoint
  4. Select Email from the How should we contact? dropdown menu.  Paste the email address from step 5 (above).  Click on the Add button once complete.
    Configure alerting endpoint settings
  5. Click on Save Settings.
    Save alerting endpoint settings
  6. Now we’ll need to associate the new Alerting Endpoint with an Alert Policy.  Click on the Alerting icon, then select Alert Policies.
    Pingdom alert policies
  7. Edit the policy that you would like to use to notify your new Alerting Endpoint.Edit Pingdom Alert Policy
  8. In the ASSIGN TO: field, select the name of the alerting endpoint that you just created (step 3), then press Save.
    Edit the Pingdom alert policy
  9. Congratulations!  Your integration is now complete!  Now when an alert on one of your Pingdom checks that meets the necessary criteria, a PagerDuty incident will be triggered.

If you’re running into issues with this integration, please contact us at support@pagerduty.com.

Verify that Pingdom and PagerDuty are Communicating

  • Once you have a check fail within Pingdom, an alert will be sent to users in the associated alert policy.  This causes an email to be sent to PagerDuty which triggers an incident:
    Triggered Pingdom incident
  • Once the check is restored, Pingdom will notify PagerDuty and the incident will be automatically resolved:
    Resolved incident

 FAQ

My Pingdom check is alerting but it’s not alerting PagerDuty.  What’s wrong?

Please make sure that the Alert Policy that you configured to notify PagerDuty is associated with the checks that you want to receive alerts from.  If you go to your check, you can then choose an Alert Policy:

Associate an Alert Policy with a Check

Can I use a user’s contact methods instead of creating an Alerting Endpoint within Pingdom?

Yes, you can define an email contact method that will tie to your PagerDuty service.  Please follow the below guide for how to configure your Pingdom user.

  1. Click on the Alerting icon and then the Users tab.
    Navigate to Pingdom Users
  2. Select Edit User from the menu next to the user account that you would like to be associated with PagerDuty alerts.
    Edit a User
  3. Click the ADD CONTACT METHOD button.
    Add a new Pingdom contact method
  4. Select Email for the How should we contact? field, and paste the email address that you copied in step 5 (above).
    configure_contact_method
  5. Click on the Add button.
  6. Click on the Save Settings button.
    Save your settings
  7. Now you’ll need to add this as a notification method.  For each of the severity levels that you want to have notifications go to PagerDuty, add this new contact method by clicking on the ADD FALLBACK button and then selecting the newly created email.
    Add a Pingdom notification method
  8. If you haven’t already, associate this user with an Alert Policy.  Click on the Alerting icon and then select Alert Policies.
    Pingdom alert policies
  9. Edit the policy that you would like to use to notify your user.
    Edit Pingdom Alert Policy
  10. In the ASSIGN TO: field, select the user that you configured to email PagerDuty (steps 2-6), then press Save.
    Edit Pingdom alert policy
  11. Congratulations!  Your integration is now complete!  Now when an alert on one of your Pingdom checks meets the necessary criteria, a PagerDuty incident will be triggered.

If you’re running into issues with this integration, please contact us at support@pagerduty.com.