Follow these steps to integrate Lightup with a PagerDuty service. Setting up integrations in PagerDuty requires an Admin or Editor role. If you do not have either role, please reach out to an Admin within your organization to configure the integration.

Prepare in PagerDuty

1. Navigate to Services > Service Directory.
2. Add an integration to a service through one of the following methods:
   • Add your integration to an existing service—In the Configuring Services and Integrations documentation, follow the procedure outlined in the Edit Existing Service Settings section.
   • Create a new service for your integration—In the Configuring Services and Integrations documentation, follow the procedure outlined in the Create a New Service section.
3. Expand the Lightup integration settings.
4. Edit the Integration Name so it uses the format monitoring-tool-service-name (e.g., Lightup-Incident-Monitoring) and click Save.
5. When you expand the Integration settings, you can also view the Integration Key. Save this key in a safe location because you'll need it to configure the integration with Lightup in the next section.

Add a PagerDuty alerting channel

You'll need your PagerDuty integration key to complete this procedure.

1. Select the workspace where you want to add an integration, and then select Integrations on the left panel.
2. Select Create Integration +.
3. Select PagerDuty .
4. Name the channel.
5. Add your integration key in the Integration Key field.
6. Set the Severity field to the PagerDuty severity that should be used for all incidents sent via this PagerDuty integration channel.
7. Optionally set Description to a short summary if applicable.
8. Set Timezone to the time zone in which PagerDuty should display the incident.
9. Click Send Test Message. You will see "Successfully posted test message" appear briefly on the screen, indicating the integration is set up correctly.
10. Click Save.
11. From the PagerDuty console, confirm that an incident was triggered with the subject "Hello from Lightup Data."

Delete a PagerDuty alert channel

1. Log in to the Lightup and navigate to Settings > Integrations. You must have editor or admin privilege.
2. Select the PagerDuty integration you want to delete, then click Delete.

How PagerDuty integration works

Lightup incidents send an event to a service in PagerDuty. Events from Lightup can either trigger a new incident on the corresponding PagerDuty service or be grouped as alerts into an existing incident.

Changes in the status of the Lightup incident are not updated in PagerDuty, and changes in the status of the PagerDuty incident are not updated in Lightup.

For more information about incidents and alerts, go to PagerDuty's incidents support page and PagerDuty's alerts support page.

PagerDuty + Lightup Integration Benefits

• Notify on-call responders of Lightup incidents.
• PagerDuty incidents link back to Lightup to provide detailed incident analysis.