PagerDuty Integration

Last modified on July 26, 2024

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 add the AlertSite integration to your existing service in PagerDuty:

  1. In your PagerDuty account, go to Services > Service Directory.

    PagerDuty Service Directory

    Click the image to enlarge it.

  2. If you do not have a service yet, create one. For details, see Create a New Service in the PagerDuty documentation.

  3. Click the service for which you want to create incidents from AlertSite alerts.

    A service in PagerDuty service directory

    Click the image to enlarge it.

  4. Switch to the Integrations tab and click Add an integration.

    Adding an integration to a service in PagerDuty

    Click the image to enlarge it.

  5. Search for AlertSite. Select the check box next to the AlertSite integration and click Add.

    AlertSite in the list of PagerDuty integrations

    Click the image to enlarge it.

  6. Expand the added integration and copy the Integration Key. You will need to specify it later in AlertSite.

    PagerDuty integration key

    Click the image to enlarge it.

Configure AlertSite

Now, you can add a PagerDuty recipient in AlertSite:

AlertSite UXM

  1. Go to Alerts > Alert Recipients.

  2. Click + New Recipient.

    Adding a PagerDuty recipient
  3. Specify the following:

    • Name - an arbitrary name for this recipient, for example, PagerDuty.

    • Recipient - paste the integration key you copied earlier from PagerDuty.

    • Method - select PagerDuty.

    AlertSite: PagerDuty service key

    Click the image to enlarge it.

  4. Click Add.

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

    PagerDuty recipient in AlertSite

    Click the image to enlarge it.

  6. Click the pencil icon next to the PagerDuty recipient to access additional alerting options.

  7. Select Notify when the error has cleared. This will automatically resolve incidents in PagerDuty when an error condition clears in AlertSite.

    Notify when the error has cleared

    Click the image to enlarge it.

  8. Configure other options for availability and performance alerts as required. For the description of these options, see Recipient Properties.

AlertSite 1.0

  1. Go to Notifiers > Notifiers.

  2. Click Add Notifier.

    Add Notifier

    Click the image to enlarge it.

  3. Specify the following:

    • Description - an arbitrary name for this recipient, for example, PagerDuty.

    • Send a(n) - select PagerDuty.

    • To - paste the integration key you copied earlier from PagerDuty.

    PagerDuty recipient configuration

    Click the image to enlarge it.

  4. In the Configure Standard (Availability) Notifications section, select the Notify me when the error has cleared option. This will automatically resolve incidents in PagerDuty when an error condition clears in AlertSite.

    Notify me when the error has cleared
  5. Configure other options for availability and performance alerts as required. For the description of these options, see Recipient Properties.

  6. Click Submit in the top right corner.

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