Please note, you will need to have the admin role on the account to add/view the API Access keys.

In PagerDuty

Go to the Configuration menu and select API Access.

On the API Access page, click Create New API Key.

In the dialog that pops up, you’ll be prompted to enter a Description for your key, and choose an API version. Select v1 Legacy for this integration. You will also have the option to create the key as Read-only; leaving this box unchecked will create a full access key.

Note: This integration uses API v1, and will not work with an API v2 key.

Once you have filled in your description, click Create Key.

Once you click Create Key, you will see a dialog displaying your key and confirming the options you filled in on the previous step. Make sure to copy this key into any application that needs it now, as you will not have access to the key after this step. If you lose a key that you created previously and need access to it again, you should remove the key and create a new one. Click Close once you have successfully copied your key.

Once created, you will see your key appear in the list of keys on the API Access page, with versioning noted.

Go to the Configuration menu and select Services.

On the Services page:

If you are creating a new service for your integration, click Add New Service.

If you are adding your integration to an existing service, click the name of the service you want to add the integration to. Then click the Integrations tab and click the New Integration button.

Select your app from the Integration Type menu and enter an Integration Name.

If you are creating a new service for your integration, in General Settings, enter a Name for your new service. Then, in Incident Settings, specify the Escalation Policy, Notification Urgency, and Incident Behavior for your new service.

Click the Add Service or Add Integration button to save your new integration. You will be redirected to the Integrations page for your service.

Copy the Integration Key for your new integration.

On Your Spotlight Server

Go to Configure → Diagnostic Server.

Click Configure PagerDuty.

Fill in the API Access Key and Service API Key fields with the API Access and Integration Keys you created earlier, then click Trigger Test Incident.

If everything is correct, you should see a new incident triggered in your PagerDuty account. Click OK to continue to the next steps.

Go to Configure → Alarm Actions.

Click New….

Give the action a Name and select the Conditions that you would like to trigger a PagerDuty incident for. Check Send PagerDuty Incident and then click OK.

Congratulations! You’ve completed the integration with Spotlight. Now when an alarm triggers, is acknowledged or resolved within Spotlight, it will trigger a new incident (or update the corresponding incident) within PagerDuty.

FAQ

How do I configure Spotlight to work with multiple PagerDuty services?

Unfortunately this isn’t possible. Spotlight integrates with a single PagerDuty service.

Will actions in Spotlight reflect in PagerDuty?

Yes. Acknowledgements and resolves in Spotlight will reflect in PagerDuty, however actions from PagerDuty will not reflect in Spotlight.