OBSERVABILITY PLATFORM
PagerDuty

Create a PagerDuty notifier

To create a PagerDuty notifier, create a service in PagerDuty and then create the notifier in Chronosphere Observability Platform.

Create a new service in PagerDuty

Before creating a PagerDuty notifier in Observability Platform, you must configure the notifier in PagerDuty.

To configure a PagerDuty notifier:

  1. In PagerDuty, go to Services > Service Directory and click New Service.
  2. Enter a name and description for the service and follow the remaining prompts.
  3. Select Prometheus from the integration types list and create the service.
  4. After PagerDuty redirects you to the new service, click the Integrations tab, which displays the integration key.
  5. Copy the integration key, which you enter when creating a PagerDuty notifier in Observability Platform.

The PagerDuty v1 Event API (opens in a new tab) uses a service_key, and the PagerDuty v2 Event API (opens in a new tab) uses a routing_key.

If you're using the PagerDuty v2 Event API, create your notifier with either Terraform or Chronoctl. You can specify only a service_key in Observability Platform.

Next, create a PagerDuty notifier in Observability Platform.

Create a PagerDuty notifier in Observability Platform

After creating a service in PagerDuty, you can create a PagerDuty notifier in Observability Platform.

The Observability Platform PagerDuty notifier sends alert details to PagerDuty as a string for improved readability in the PagerDuty user interface. The alert details can also be sent as a JSON object for use in downstream PagerDuty AIOps features. The JSON format makes it easier to consume alert details programmatically, while retaining data visibility in the user interface. To enable JSON format, contact Chronosphere Support.

To create a PagerDuty notifier:

  1. In the navigation menu select Alerts > Notifiers.

  2. Click Create Notifier.

  3. Enter a descriptive name for the notifier.

  4. Select PagerDuty as the type of notifier you want to create.

  5. In the Service key field, enter the integration key you created in PagerDuty.

  6. In the URL field, enter a URL, which is called as a POST request. For example:

    https://events.pagerduty.com/generic/2010-04-15/create_event.json
    ⚠️

    Don't use the default value from PagerDuty in the URL field. You must enter the Integration URL from PagerDuty.

  7. In the Severity dropdown, select a severity for the event.

  8. Click Save.