Skip to content

PagerDuty Integration Guide

Overview

Integrating UptimeObserver with PagerDuty enables seamless incident management by automatically creating and resolving incidents based on your website's uptime status. When a monitor goes down, an incident is automatically triggered in PagerDuty; when it comes back up, the incident is resolved.

Support

If you need help with this integration please reach out to us using the "Need Help?" button on the bottom right corner or send us an email at support@uptimeobserver.com.

Note

PagerDuty integration is offered exclusively on paid plans.

Step-by-Step Guide

  1. Go to UptimeObserver and log in to your account.
  2. Navigate to the Integrations section from your dashboard.
  3. Choose PagerDuty from the list of available integrations.
  4. Click on "Connect PagerDuty" Connect PagerDuty
  5. Select all the services you want to allow UptimeObserver to trigger, acknowledge and resolve, then click "Connect!" Connect PagerDuty and UptimeObserver
  6. After connecting, you will be redirected back to UptimeObserver and the allowed services should appear. Connected UptimeObserver and PagerDuty

Enabling Alerts on Monitors

After connecting PagerDuty, you must add alerts to your monitors:

  1. Go to your monitor and click on Add Alert.
  2. Select PagerDuty as the alert type.
  3. Pick the related PagerDuty service from the dropdown.
  4. Choose the event:
    • Monitor Down — Triggers a new incident in PagerDuty
    • Monitor Up — Resolves the incident in PagerDuty
  5. Click Save Changes.

Recommendation

Add alerts for both "Monitor Down" and "Monitor Up" events. This ensures incidents are automatically created when problems occur and resolved when your service recovers.

Adding PagerDuty Alert to a Monitor

Troubleshooting

If you are having trouble with the integration, check the common solutions below.

1. Services Not Appearing After Connection

If you connected PagerDuty but don't see your services in UptimeObserver:

  • Permission issues: During the OAuth flow, ensure you selected the services you want UptimeObserver to access
  • Reconnect: Try disconnecting and reconnecting the integration, making sure to select all required services
  • PagerDuty role: Verify your PagerDuty account has permission to manage integrations for the services you need

2. Incidents Not Being Created

If monitors go down but no PagerDuty incident is triggered:

  • Alert not added: Verify that PagerDuty is added as an alert on the specific monitor. Go to Monitor Detail → Alerts
  • Wrong event selected: Ensure you selected "Monitor Down" as the event trigger
  • Service selection: Confirm you selected the correct PagerDuty service when adding the alert
  • PagerDuty service status: Check that the PagerDuty service isn't disabled or in maintenance mode

3. Incidents Not Being Resolved Automatically

If incidents are created but not resolved when the monitor comes back up:

  • Missing "Monitor Up" alert: You need to add a separate alert for the "Monitor Up" event. Create another alert with the same PagerDuty service but select "Monitor Up" as the event
  • Incident already resolved: If someone manually resolved the incident in PagerDuty, UptimeObserver won't try to resolve it again
  • Different services: Ensure both "Down" and "Up" alerts are configured for the same PagerDuty service

4. Permission or Authorization Errors

If you see authorization errors:

  • Re-authorize: Go to Integrations → PagerDuty and click to reconnect. This refreshes the OAuth tokens
  • PagerDuty admin: You may need admin or manager role in PagerDuty to set up integrations
  • Check PagerDuty integrations: In PagerDuty, go to Services → [Your Service] → Integrations and verify UptimeObserver is listed

5. Duplicate Incidents

If you're seeing duplicate incidents for the same monitor:

  • Multiple alerts configured: Check if you accidentally added multiple PagerDuty alerts for the same "Monitor Down" event on the same monitor
  • Remove duplicates: Go to the monitor's alert settings and remove any duplicate PagerDuty alerts

6. Test Connection

To verify the integration is working:

  1. Add a PagerDuty alert to a monitor
  2. Temporarily pause the monitored service or use a test endpoint that returns errors
  3. Check PagerDuty for a new incident
  4. Restore the service and verify the incident resolves

7. How to Reset the Integration

If all else fails, try a fresh start:

  1. Follow the "How to Uninstall" steps below to remove the integration from both platforms
  2. Wait a few minutes
  3. Follow the Step-by-Step Guide to reconnect

How to Uninstall

In UptimeObserver:

Go to the PagerDuty settings page and click delete on the specific integration. Connected UptimeObserver and PagerDuty

In PagerDuty:

Remove UptimeObserver Integration from Services:

  1. Log in to your PagerDuty account.
  2. Navigate to Services → Service Directory.
  3. Select the service associated with UptimeObserver.
  4. Go to the Integrations tab.
  5. Click the Remove or Delete option next to the UptimeObserver integration.

By completing these steps, you will fully disconnect the integration between UptimeObserver and PagerDuty.