Last modified on September 12, 2018

PagerDuty is an incident management and alerting system. PagerDuty collects alerts from various monitoring systems, and notifies the appropriate team members based on your on-call duty schedule and escalation policies. AlertSite can send alerts directly to PagerDuty to automatically trigger and resolve incidents.

Requirements

To configure the integration, you need the following user permissions:

  • In AlertSite – Admin, Co-Admin, or Power User.
  • In PagerDuty – Account Owner, Admin, or User.

Private locations (Private Node Server and InSite) support PagerDuty alerts starting from version 2.0.

Configure PagerDuty

First, you need to create an AlertSite service in PagerDuty:

  1. In your PagerDuty account, go to Configuration > Services.

    PagerDuty: Configuration > Services

    Click the image to enlarge it.

  2. Click Add New Service.

    PagerDuty: Add New Service

    Click the image to enlarge it.

  3. Enter the Name for the service (for example, AlertSite UXM) and select the needed Escalation Policy.

  4. Under Integration Type, select AlertSite UXM from the list of tools. Type AlertSite into the filter box to find it faster.

    Adding AlertSite service in PagerDuty

    Click the image to enlarge it.

  5. Scroll down and click Add Service.

Configure AlertSite

Now you can add a PagerDuty recipient in AlertSite:

  1. In AlertSite UXM, select Alerts > Alert Recipients from the top menu.

  2. Click + New Recipient.

    Adding a PagerDuty recipient
  3. Select PagerDuty from the Method list.

  4. Click Alert with PagerDuty.

    Alert with PagerDuty
  5. You will be redirected to the PagerDuty website. Enter your PagerDuty email and password, and click Authorize Integration.

    PagerDuty: Autorize Integration
  6. Select Use an existing AlertSite UXM service, then select the service that you created earlier.

    PagerDuty: Configure AlertSite integration
  7. Click Finish Integration.

  8. You will be redirected back to AlertSite, and a dialog will show the service name and key:

    AlertSite: PagerDuty service key

    Click the image to enlarge it.

  9. Click Add.

  10. PagerDuty is now available as an alert recipient in AlertSite:

    PagerDuty recipient in AlertSite

    Click the image to enlarge it.

  11. To select the alert types to send to PagerDuty, click next to the recipient and specify the settings for availability and performance alerts. For a description of available settings, see Recipient Properties.

Note: By default, all AlertSite monitors send alerts to all configured alert recipients. But if you have recipient groups configured, each group’s monitors send alerts only to recipients in that group. In this case you need to add the PagerDuty recipient to the relevant groups to receive alerts from monitors in that group.

Test the integration

  1. In AlertSite, configure a monitor to trigger an alert. For example, edit the monitor settings and set the timeout to 1 second, or create a keyword validation for a word that does not appear in the monitored web page.

  2. Wait until the next time the monitor runs. It will trigger an alert.

  3. In PagerDuty, open the Dashboard.

  4. You should see that an incident has been triggered by AlertSite:

    An incident in PagerDuty

    Click the image to enlarge it.

  5. Click the incident number # to open the incident details. The problem description is in the status_text field in the Details table. For a description of other fields, see Alert Data Fields.

    PagerDuty incident details

    Click the image to enlarge it.

FAQ

Will PagerDuty incidents automatically resolve when AlertSite sends a “clear” notification?

Yes.

Can I integrate AlertSite with more than one PagerDuty service?

Yes. This way you can use different PagerDuty escalation policies for different AlertSite monitors.

You need to create several AlertSite services with different names in PagerDuty, and the corresponding PagerDuty recipients in AlertSite.

Got other questions?

Contact SmartBear Support for assistance.

See Also

Alerts
Performance Alerts
Alert Data Fields

Highlight search results