PagerDuty Integration

InsightFinder can source the data from and send the notifications/alerts to PagerDuty. Below documentation is a walk through of how to configure PagerDuty in InsightFinder.

How it Works

InsightFinder generates alerts for incidents predicted in the system. Alert from InsightFinder trigger a new event on the corresponding PagerDuty Service for Global Event Routing.

Requirements

The PagerDuty integration requires an admin role in order to authorize the account. If you are not an admin, please reach out to an admin or account owner within your organization to configure the integration for you.

Support

If you need any help getting the PagerDuty integration up and running, please do not hesitate to reach out to us via email at support@insightfinder.com.

Project Configuration

Information needed:

  1. PagerDuty API Key (required to get data from PagerDuty): You can to go Integrations → Developer Tools → API Access Keys and Create New API key.
    (See Figure 1)
  2. PagerDuty Service Key (required to send data from PagerDuty) – You must have a service registered in PagerDuty to get the key. In the service, go to “View Integrations”.
    (See Figure 2)
  3. Click on the integration to see the “Integration Key”.
    (See Figure 3)
  4. If you don’t have integrations already, add “Event API v1” integration.

Project Creation

  1. Go to “Settings”->“System Settings”. Click on “Add New Project”.
  2. Select “PagerDuty” from the list and click on “Create Project” on the next page.
  3. Provide “API Token” from pagerduty here and click “Verify”.
    (See Figure 4)
  4. On the next page, select the PagerDuty Service you want to source data from, Timestamp and Instance based on your PagerDuty field configurations.
    (See Figure 5 and 6)
  5. Then on the next page, you can type in the “Project Name” and “System Name” and click on Register.
    (See Figure 7)
  6. Once a project is successfully created, you will see a message like below.
    (See Figure 8)
  7. You can go to the “Alert Analysis” page and check the data coming in there with the next alert raised in PagerDuty.
    (See Figure 9)
  8. You are all set to receive PagerDuty alerts/incidents in InsightFinder and start to use InsightFinder AI engine for Incident Investigation and Prediction.

Push alerts to PagerDuty (Sending notification to PagerDuty)

  1. Go to “Settings”->“External Service Settings”. Click on “PagerDuty”.
  2. Pop up will open up where you click on “Add New”.
    (See Figure 10)
  3. Select the “System name” that you want to send notifications for and provide the “Service Key” and close the window.
    (See Figure 11)
  4. You are all set to send InsightFinder incident notifications/alerts to PagerDuty.

Figures

Click on an image to expand.