Documentation Index

Fetch the complete documentation index at: https://help.nucleussec.com/llms.txt

Use this file to discover all available pages before exploring further.

PagerDuty

  • 2 minute(s) read
Prev Next

Service Setup

  1. Open a browser and login to PagerDuty.

  2. Browse to Services > Service Directory using the tabs at the top of the page

pagerdutydropdown.png

  1. Click on the green +New Service button in the top right of the screen.

  2. Fill out the rest of the form with your desired settings:
    a. "Name" - Fill out "Name" and "Description".
    b. "Assign" - Choose you preferred Escalation Policy or Select an existing Escalation Policy > Default.
    c. "Reduce Noise" - For Alert Grouping, choose your preferred configuration or Use Intelligent (Recommended) and keep all defaults.

  3. Under "Integrations" select Create Service without an Integration at the bottom of the form.

pagerdutycreateservice.png

  1. You are now at your new service's page. At the top navigation bar, select Integrations.

  2. On the Integrations page, scroll down to the Service Extensions section. Click + New Extension.

  3. From the Extension Dropdown, scroll until you see Service Level, and select Generic V2 Webhook.

pagerdutyaddextension.png

  1. Enter the Name of the extension, select the Service you just created and enter the URL of the nucleus application in the Details Column.
Note

The url for the extension should be the url to the nucleus application with /public/index.php/webhook/pagerduty appended. An example url would be: https://example.com/nucleus/public/index.php/webhook/pagerduty.

  1. Once these have been entered, click Add.

API Access Setup

  1. Still in PagerDuty, use the tabs to navigate to Integrations > API Access Keys

pagerdutyapiaccess.png

  1. Click Create New API Key. Note, make sure "read-only" is not selected.

  2. Provide a Description. Select Create Key.

  3. Copy key to clipboard.

Nucleus Setup

  1. In a 2nd browser window, open Nucleus and browse to Integrations > Connector Setup.

  2. Under the Issue Trackers section, click the PagerDuty icon.

  3. In the Setup PagerDuty Connector popup, fill in the API Key field with the API Key which was just generated in PagerDuty.

  4. Click the Save Changes button and wait for the Success message.

  5. Once the success message has appeared, click the Retrieve Data button in Setup PagerDuty Connector Popup.

  6. In Nucleus Popup, select the PagerDuty service we just created.

  7. Select the Default Requester from the dropdown. Note, you may want to create a user specifically as the requester for this application

  8. Optional: Select the default escalation policy for issues which originate from this connector. These will be used to help you escalate tickets within PagerDuty.

  9. Optional: Select the Default Assignee in order to assign tickets to a default user.

  10. Once the options have been selected from the dropdowns, click Save Changes.

  11. Click Verify Connection to ensure everything is working properly. If successful, you're all done!

  12. Close the popup window.