Prerequisites

•  A PagerDuty account
• Capsule Console 4.8.0 or later with the console.crypto_key configuration field set (refer to Integrations Portal (beta)).
• A user with the "Edit Global Settings" permission

Set up a PagerDuty Application

• Login to Pagerduty.
• Navigate to Integrations > Developer Mode:

• You should land on My Apps page. Click "Create New App".

• Fill in the required fields. Most users will choose "No, I am not interested" in publishing this app.
• Click "Save".

• Scroll down to "Event Integration" and click "Add".

• Advanced PagerDuty users may prefer to modify defaults on the Events Integration page. Such changes are out of scope of these docs. Refer to PagerDuty's docs.
• Users new to PagerDuty will find it easiest to leave the defaults alone, and take advantage of the Events Integration Test Service to route the alerts into Pagerduty. Click the "Create" button next to "Create a Test Service":

• Make a note of the "Integration Key" and "Events API Endpoint". You'll need to paste these into the Capsule8 Console or add them to your capsule8-sensor.yaml.
• Click Save:

Set up the Console Integrations Portal

• Navigate to your Console.
• Click your username in the top right.
• Click "Global Settings".
• In the top right, you'll see "Beta Features". Set "Integrations Portal" to enabled. Click "Save" in the Beta Features component. Click "Integrations" on the header bar:

• Click PagerDuty.
• Populate the Integration Key and the URL with the values from the PagerDuty Event Integration.
• Click "Install":

• Congratulations. The integration is set up and alerts are now being forwarded.
• Verify functionality with a test alert:
  • Click PagerDuty again on the Integrations page.
  • Click Send Test Alert:

• Navigate from the PagerDuty developer site back to the Incidents page of the PagerDuty console.
• You'll see your test alert showing up: