Set up PagerDuty

Follow these steps to integrate Lightup with a PagerDuty service.


PagerDuty integrations require an Admin or Editor role. If you do not have this role, please reach out to an Admin within your organization to configure the integration.

In PagerDuty

  1. Navigate to Services > Service Directory.
  2. Add an integration to a service through one of the following methods:
  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 it will be used when you configure the integration with Lightup in the next section.

In Lightup


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

  1. Log in to the Lightup app and navigate to Settings > Integrations. You must have editor or admin privilege.
  2. Click on +.
  3. Select PagerDuty Channel.
  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 Description 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."

Uninstall 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.