Note: This is a one-way outbound integration. Incidents created or updated
by Plerion appear in PagerDuty, but changes made directly in PagerDuty do not
sync back to Plerion.
Steps for adding a PagerDuty integration
1
On the Plerion dashboard, go to Settings > Integrations
2
Find PagerDuty and click the + button
3
Enter connection details and send a test
Provide Integration name, Integration key, and Severity level. Click 
Send test message to create a test incident in your PagerDuty service.- If you do not have an Integration key, see Obtaining the PagerDuty integration key below.
- We recommend configuring Reduce Noise in PagerDuty to group related alerts; see Configure Reduce Noise below.
4
Review the test incident in PagerDuty
Confirm the test incident appears as expected in your PagerDuty service. Notifications will follow your service’s configuration.
5
Add the integration
When the test succeeds, click
Add in Plerion to finish setup.Obtaining the PagerDuty integration key
You need a PagerDuty Events API v2 integration key on a service. Create a new service or add the integration to an existing service.Create a New Service
1
Go to Services > Service Directory and select New service
PagerDuty will guide you through the service setup steps.
2
Name the service
Enter a Name and Description, then select 
Next.3
Assign an escalation policy
Choose Generate a new Escalation Policy or Select an existing Escalation Policy, then select 
Next. You can edit escalation policies later in PagerDuty.4
Configure Reduce Noise (recommended)
Select Content-based and choose 
Create grouping. Set Group alerts based on All of the following fields, and select Component and Group, then select Save. If Create grouping is not available, complete service creation and configure Reduce Noise afterward (see Configure Reduce Noise).5
Add the Events API v2 integration
Select Events API v2 on the Integrations step and create the service.
6
Copy the integration key
After creation, you will land on the service Integrations tab. Copy the Integration key and store it securely for use in Plerion.
Add an integration to an existing service
1
Open Services > Service Directory and select your service
2
Go to the Integrations tab and add another integration
Select Events API v2, then select 
Add.3
Copy the integration key
After adding, copy the Integration key from the service Integrations tab and use it in Plerion. We also recommend configuring Reduce Noise as described below.
Configure Reduce Noise
Set up Reduce Noise in PagerDuty to group related alerts into a single incident and keep the incident list clean.1
Open your service settings in PagerDuty
Go to Services > Service Directory, select the service, then open the Settings tab. Scroll to Reduce Noise and select 
Edit.2
Use content-based grouping
Select Content-based, then choose 
Create grouping. Set Group alerts based on All of the following fields and select Component and Group, then select Save. If Content-based is unavailable, first send a test from Plerion using Send test message, then return to this screen.3
Confirm saved settings
Verify the Reduce Noise configuration displays your grouping rule.