PagerDuty

Learn how to setup a Bugsnag integration with PagerDuty.

The PagerDuty integration creates incidents in PagerDuty when error activity is reported to Bugsnag.

Configuration

In PagerDuty, you can set up a new integration by going to Configuration > Services > Add New Service. Enter “Bugsnag” as the Integration Type and select Add Service. From the Service details page, you will be able to find the Integration Key. This key will be needed to complete setup in Bugsnag.

In Bugsnag, set up the PagerDuty integration from Project Settings > Incident managment, then select PagerDuty from the Available integrations section.

You will be prompted for an Integration Key which you can find in PagerDuty as described in the step above.

Configuration

Configuring alerts

Select the alerts that you want to receive from the Notify me when section. The following alert types are available:

Project alerts

  • This project has a spike in errors will alert you when there is an overall spike in all the errors that match your filter. Learn more >

Error alerts

  • A new error occurs will alert you if the first event of an error (per release stage) matches your filters.
  • An error occurs frequently will alert you when an error receives x events in y hours that match your filters, where you can define the number of events (x) and the time interval (y).
  • An error milestone is reached will alert you when the number of events of an error (per release stage) reaches a milestone, and the event matches your filters. The milestones are the 10th, 1000th, 1000th event then each additional 1000 events.
  • Every time an error occurs will alert you every time an event matching your filters is received.
  • An error is automatically reopened will alert you when an error that has been marked as fixed or snoozed (and matches your filters) receives an event that causes the error to be reopened.

Collaborator alerts

  • A collaborator changes the state of an error will alert you when a collaborator on your project manually changes the state of an error that matches your filter, for example marking an error as fixed.

Notification settings

Filter settings

Alerts can configured using Basic filters or Advanced filters.

Basic Filters

Basic filtering for alert is provided for severity, type, and release stage.

  • Filter by release stage: Select the release stage(s) that you want to receive alerts about from the Release stage dropdown.
  • Filter by type: Receive alerts for either handled or unhandled errors only. Find out more >
  • Filter by severity: Select the severity option(s) that you want to include in your filter from the Severity toggle.
  • Filter by status: Select the status option(s) that you want to include in your filter from the Status toggle.

Basic Filters

Advanced filters

Advanced filtering leverages Bookmarks to enable you to filter an alert based on any field you can filter on using the filter bar. Advanced filtering is available on Standard and Enterprise plans.

  1. Create desired filters using the filter bar: From the Inbox or Timeline, create filters to match the errors you want to receive alerts for. Learn more >
  2. Save filters as a Bookmark: Select + Bookmark current search and name your bookmark. Select Share this bookmark with my team.
  3. Select the bookmark for your alert: Open the configuration for your desired alert, select Advanced filter, and pick the bookmark that you created.