Pingdom Integration Guide

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 or webhook), 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 scheduling.

Note: The webhook integration is named Pingdom BeepManager and the email-based integration is named Pingdom Email when searching for the integration type while creating a new service in PagerDuty. Instructions for configuring the email-based integration can be found in the latter half of this guide. If you are a Pingdom Legacy customer, you will be able to use the Pingdom BeepManager integration, any new Pingdom customs will need to use the Pingdom Email integration.

In PagerDuty

  1. From the Configuration menu, select Services.
  2. On your Services page:If you are creating a new service for your integration, click +Add New Service.If you are adding your integration to an existing service, click the name of the service you want to add the integration to. Then click the Integrations tab and click the +New Integration button.RS-Add-New-Service

    RS-Add-Integration-Existing-Service

  3. Select your app from the Integration Type menu and enter an Integration Name.If you are creating a new service for your integration, in General Settings, enter a Name for your new service. Then, in Incident Settings, specify the Escalation Policy, Notification Urgency, and Incident Behavior for your new service.
  4. Click the Add Service or Add Integration button to save your new integration. You will be redirected to the Integrations page for your service.RS-Integration-Settings
  5. Copy the Integration URL for your new integration.
    RS-Integration-URL

In Pingdom:

  1. From the Pingdom dashboard on the left-side of your screen, select Alerting > Alerting Endpoints.
    pingdom_3
  2. Click Add alerting endpoint.
    pingdom_10
  3. Enter a Name for your alerting endpoint, then click the Add contact method button, the New message format option will be selected by default.
    pingdom_4
  4. Select URL/Webhook from the How should we contact you? dropdown menu. Paste the Integration URL from step 4 (above). Click the Add button once complete.
    pingdom_5
  5. Click the Save settings button.
    pingdom_6
  6. Now we’ll need to associate the new Alerting Endpoint with an Alert Policy. From the Pingdom dashboard on the left-side of your screen, select Alerting > Alert Policies.
    pingdom_7
  7. You can Edit an existing Alert Policy, or create a new Alert Policy to notify your new Alerting Endpoint.
    Edit Pingdom Alert Policy
  8. In the ASSIGN TO: field, start typing the name of the newly created Alerting Endpoint (steps 3-5), then click the Add step button.
    pingdom_8
  9. After adding this step, feel free to add more steps if desired. If you don’t add more steps, your Alert Policy will look like this and you can click on the Save button:pingdom_9
  10. Congratulations! Your Pingdom BeepManager integration now complete. Now when an alert on one of your Pingdom checks meets the necessary criteria, a PagerDuty incident will be triggered to notify whomever is on-call.

 

FAQ

Will the PagerDuty incident automatically resolve when the check is up?

Yes, the PagerDuty incident will resolve when the Pingdom check is up.

 


 

If you prefer, you can also integrate with Pingdom by creating an email-based service. This guide will walk you through how to configure Pingdom to send alerts to PagerDuty via email. With the email-based integration, PagerDuty incidents will automatically resolve when the Pingdom check is up.

In PagerDuty

  1. From the Configuration menu, select Services.
  2. On your Services page:If you are creating a new service for your integration, click +Add New Service.If you are adding your integration to an existing service, click the name of the service you want to add the integration to. Then click the Integrations tab and click the +New Integration button.RS-Add-New-Service

    RS-Add-Integration-Existing-Service

  3. Select your app from the Integration Type menu and enter an Integration Name.If you are creating a new service for your integration, in General Settings, enter a Name for your new service. Then, in Incident Settings, specify the Escalation Policy, Notification Urgency, and Incident Behavior for your new service.
  4. Click the Add Service or Add Integration button to save your new integration. You will be redirected to the Integrations page for your service.RS-Integration-Settings
  5. Copy the Integration Email for your new integration: RS_email_pd_3

In Pingdom:

  1. From the Pingdom dashboard on the left-side of your screen, select Alerting > Alerting Endpoints.
    pingdom_3
  2. Click Add alerting endpoint.
    pingdom_10
  3. Enter a Name for your alerting endpoint, then click the Add contact method button, the New message format option will be selected by default.
    pingdom_4
  4. Select Email from the How should we contact? dropdown menu. Paste the Integration address from step 4 (above). Click the Add button once complete. Please note: both the new message and old message formats will work for this integration, so you can choose either in the ‘Alert Message’ options.
    Configure alerting endpoint settings
  5. Click Save Settings.
    Save alerting endpoint settings
  6. Now we’ll need to associate the new Alerting Endpoint with an Alert Policy. From the Pingdom dashboard on the left-side of your screen, select Alerting > Alert Policies.
    pingdom_7
  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, start typing the name of the newly created Alerting Endpoint (steps 3-5), then click the Add step button and Save.
    Edit the Pingdom alert policy
  9. Congratulations! Your Pingdom Email integration is now complete! Now when an alert on one of your Pingdom checks meets the necessary criteria, a PagerDuty incident will be triggered to notify whomever is on-call.

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

 

I had a large number of alerts in one email and not all of them triggered/resolved, what happened?

At this time, PagerDuty will process a maximum of 20 events from Pingdom at once.

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

Still have questions?

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