Alerts

Learn how PagerDuty handles alerts from events, and how to manage alerts for effective responses and noise reduction

When PagerDuty receives a qualifying event (e.g., from a monitoring tool), it triggers an alert, which then triggers an incident. You can aggregate multiple alerts into a single incident for triage, which streamlines incident handoff between teams, centralizes critical information, and reduces notification fatigue. Alerts can move from one incident to another, either manually or automatically, via Alert Grouping. You may also suppress or deduplicate alerts via Event Orchestration.

Create Alerts

Inbound events submitted via the Events API, or via Events API-based integrations, create alerts. You cannot manually create an alert in PagerDuty.

In the most basic terms, events create alerts, and then alerts create incidents. The following diagram details this flow:

  1. Monitoring tools send events to PagerDuty
  2. PagerDuty triggers an alert
  3. PagerDuty associates the alert with an incident
  4. Incident creation sends out notifications
  5. Users receive notifications
Diagram detailing alerts' role in incident creation

📘

Incidents That do not Create Alerts

Incidents created via any of the following processes do not generate alerts:

With that in mind, Event Orchestration, suppression and other alert-related features are not applicable.

Alerts and Incident Titles

When PagerDuty creates an alert, it creates an accompanying incident and gives it the same title as the alert. As time passes, it is possible that users will manually add additional alerts, or that Alert Grouping will add them automatically. When this happens, the incident’s title will not change — it keeps the title from the original alert. That said, you can manually edit an incident’s title at any time. You cannot edit alert titles.

View Alerts

You can review incident-associated alerts in the web app or the mobile app. For an overview of all alerts, please refer to the Alerts Table article.

View Alerts in the Web App

  1. Go to Incidents and select an incident’s Title to go to its detail page.
  2. Select the Alerts tab.
    • Here you can review information about all of the alerts grouped under the incident, as well as Show/Hide Details about the alert.
Show alert details

Show alert details

  1. Select an alert’s Summary for the most detailed view.
    • The Alert Log shows information about when the alert triggered, how it was processed, and any deduplicated alerts.

View Alerts in the Mobile App

  1. On the Incidents screen, select an incident.
  2. On the incident detail screen, scroll down to the Alerts section and select an alert.

View Deduplicated Alerts

While an incident is unresolved, any subsequent alerts with a matching dedup_key deduplicate into the original alert.

Here is an example of what a deduplicated alert might look like in the Alert Log:

Deduplicated alert

Deduplicated alert

For more information, please read our developer documentation Alert De-duplication.

Move Alerts to Another Incident

Manually Move Alerts to a New Incident

  1. Navigate to the incident's details page and scroll to the Alerts section.
  2. Click the dropdown and select Move to a new incident.
  3. The details of the new incident will populate. Click Create incident.

Manually Move Alerts to an Existing Incident

From the Incident Details Page:

  1. Navigate to the incident's details page and scroll to the Alerts section.
  2. Click into the alert's Summary and then click Move to Another Incident.
  3. Enter the existing incident's number and click Find Incident.
  4. When the incident appears, click Move Alert.

From the Alerts Table:

  1. Navigate to Incidents Alerts.
  2. Click into the alert's Summary and then click Move to Another Incident.
  3. Enter the existing incident's number and click Find Incident.
  4. When the incident appears, click Move Alert.

Alert Grouping

Please see our article on PagerDuty AIOps’ alert grouping features to aggregate alerts and reduce noise.

Alert Suppression and Deduplication

Please see our Event Orchestration article for more information on alert suppression and deduplication.

Resolve Alerts

Alerts, in contrast to incidents, have two only states: triggered and resolved. You can resolve alerts manually, or via the API. If you resolve all alerts under an incident, it will resolve the incident. Conversely, if you resolve an incident, that will then resolve all alerts under that parent incident.

Resolve Alerts in the Web App

To manually resolve an alert in the web app:

  1. Go to Incidents and select the Title of an unresolved incident.
  2. On the incident detail page with the Alerts tab selected, check the box next to the alert you’d like to resolve.
    • To mass select alerts, select the checkbox at the top in the header row.
  3. Click Resolve.

Resolve Alerts in the Mobile App

To manually resolve an alert in the mobile app:

  1. On the Incidents screen, select an incident.
  2. On the incident detail screen, scroll down to the Alerts section and select an alert.
  3. Tap Resolve.