Prerequisites

Gather these requirements before starting:

  1. A PagerDuty account with permission to create a service and integration.
  2. A PagerDuty service where you want to receive notifications.
  3. The Integration Key (also known as the Routing Key) for the PagerDuty service.

Find this key by following these steps:

1

Navigate to Service Directory

In PagerDuty, navigate to ServicesService Directory and select or search the service you want to integrate with Maxim.

2

Access Integrations tab

Go to the Integrations tab.

3

Manage integrations

Click Add or manage integrations.

4

Create new integration

Click the + New Integration button.

5

Name your integration

Enter a name for the integration (e.g., “Maxim Alerts”).

6

Select integration type

Select the integration type (usually “Events API v2”).

7

Add the integration

Click Add Integration.

8

Copy Integration Key

Copy the Integration Key that is generated.

Creating the integration in Maxim

1

Open Settings

Navigate to the Settings page in Maxim.

2

Navigate to Integrations

Click on Integrations in the left sidebar.

3

Add integration

Click the Add integration button.

4

Select PagerDuty

Choose PagerDuty as the integration type.

5

Enter Integration Key

In the Integration Key field, paste the Integration Key you copied from PagerDuty.

6

Name your integration

Give your integration a descriptive name (e.g., “Production Alerts”).

7

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.