You can merge related incidents into a single incident to streamline the notification and resolution process when an incident is triggered. Merging incidents also enables you to consolidate the alert information into a single incident, helping responders identify the root cause and impact. Before merging incidents, make sure that you have enabled alerts and incidents for your service.
How to merge incidents
If there are two or more triggered incidents on the incident dashboard, you can merge them into a single incident. When you merge them, they will appear as a single incident with multiple alerts.
- Use the checkboxes to select the incidents
- Next, select Merge Incidents.
- In the popup, you can choose which incident you would like all of the alerts to be grouped under. When merging, you also have the ability to update the incident summary to more accurately reflect the problem.
- The incident dashboard will show a single incident. When you click to open the Incident and view its details, the alerts that you merged will be listed as the incident details.
You can also merge incident on the Incident details page by clicking Merge Incidents on the right side of the page. Then enter the incident number to merge into.
To view more granular details about what was sent you can also navigate to Show or Hide Details.
What happens when incidents are merged
When merging multiple incidents together, alerts will be consolidated into the selected incident. The other selected incidents will be resolved, with the reason for the resolution listed as "merged". These incidents will reference the target incident that you selected in the merge dialog.
The deduplication key, called the
alert_key, will not be changed, but it will move so that it is under a single incident with other deduplication keys.
If you are using a bidirectional integration such as the Slack integration, the merged incidents will display as resolved and reference the new target incident that contains all of the alerts.
When you merge the incidents, acknowledgers, assignees and responders from the source incidents are not merged. Instead, the target incident’s assigner, responder, and acknowledgers are preserved and they become the user(s) assigned to all alerts under that incident. These users may be viewed under the Response tab on the incident's page.
Moving alerts to another incident
If an alert is incorrectly merged, open up the Alert details page and select Move to Another Incident in the upper right hand corner. A dialog box will prompt you to move the alert to its own new Incident, or you can optionally move the alert to an existing incident in PagerDuty:
Merged incidents and webhooks
If you are using webhooks, merging alerts into a single incident will send a resolve action through the webhooks for the source incidents with a
resolve_reason of “merged.”
Webhooks will continue to update the target incident, but all past incidents that were merged into the target incident will be updated as resolved.
Likewise webhook updates will only continue to be sent for the service for that target incident; all past resolved incidents will remain resolved for other services. For example, if an incident from service A is merged into an incident for service B, only webhooks on service B will continue to be sent.
For incidents that were resolved when merged into the target incidents, the resolve webhook will trigger, if there are any that are configured. These incidents will contain reference to the new target incident ID: in the API response, the field will be