Create a PagerDuty integration
Send alert notifications to your PagerDuty service by creating a PagerDuty integration in Maxim.
Prerequisites
Gather these requirements before starting:
- A PagerDuty account with permission to create a service and integration.
- A PagerDuty service where you want to receive notifications.
- The Integration Key (also known as the Routing Key) for the PagerDuty service.
Find this key by following these steps:
Navigate to Service Directory
In PagerDuty, navigate to Services → Service Directory and select or search the service you want to integrate with Maxim.
Access Integrations tab
Go to the Integrations tab.
Manage integrations
Click Add or manage integrations.
Create new integration
Click the + New Integration button.
Name your integration
Enter a name for the integration (e.g., “Maxim Alerts”).
Select integration type
Select the integration type (usually “Events API v2”).
Add the integration
Click Add Integration.
Copy Integration Key
Copy the Integration Key that is generated.
Creating the integration in Maxim
Open Settings
Navigate to the Settings page in Maxim.
Navigate to Integrations
Click on Integrations in the left sidebar.
Add integration
Click the Add integration button.
Select PagerDuty
Choose PagerDuty as the integration type.
Enter Integration Key
In the Integration Key field, paste the Integration Key you copied from PagerDuty.
Name your integration
Give your integration a descriptive name (e.g., “Production Alerts”).
Save configuration
Click Save to create the integration.
Using the integration
Once the PagerDuty integration is created, you can select it as a notification channel when creating or editing alerts. Triggered alerts create incidents in the specified PagerDuty service.
Editing or deleting the integration
Edit or delete an integration by hovering over the respective integration on the Integrations page and clicking on the edit/delete icons respectively.