# PagerDuty Destination

## Overview

Destinations are integrations that receive alerts from rules, policies, system health notifications, and rule errors. Panther supports configuring PagerDuty as the destination where you will receive alerts.

[PagerDuty](https://www.pagerduty.com/) is a service to manage on-call rotations for critical systems. You can use the PagerDuty alert destination to page an on-call team. We typically only recommend this Destination for `High` and `Critical` severity issues that need to be addressed immediately.

### Video overview

{% embed url="<https://youtu.be/AiPw7rtN7Gs>" %}

## How to set up PagerDuty alert destinations in Panther

### Configure the integration in PagerDuty

1. Log in to your PagerDuty account.
2. Navigate to **Services > Service Directory**.
3. Click **+New Service**.
4. Fill out the forms to set up your new service, including a name and description. Select your escalation policy and noise reduction options as desired.

   * On the final **Integrations** form, select **Events API V2**.

   ![In the PagerDuty console, the Create a Service screen is shown. The Integrations form is shown, and the Events API v2 integration has been selected.](/files/xkNQeW05jaYLwxg2dmSf)
5. You will be redirected to the **Integrations** page for that service. On this page, copy the **Integration Key** and store it in a secure location. You will need this in the next steps.\
   ![In the PagerDuty console, the Integrations page is shown. There are "Integration Name" and "Integration Key" fields, with the latter highlighted.](/files/KwMKz6ZBfkxMPHE8FdSP)

{% hint style="info" %}
To ensure that you receive alerts from this integration, make sure you have assigned a user to be on-call in PagerDuty. For more information about setting on-call schedules, see [PagerDuty's schedule basics documentation](https://support.pagerduty.com/docs/schedule-basics)
{% endhint %}

### Configure the PagerDuty alert destination in Panther

1. Log in to the Panther Console.
2. In the left sidebar, click **Configure > Alert Destinations**.
3. Click **+Add your first Destination**.
   * If you have already created Destinations, click **Create New** in the upper right side of the page to add a new Destination.
4. Click **PagerDuty**.
5. Fill out the form to configure the Destination:
   * **Display Name**: Enter a descriptive name.
   * **Integration Key**: Enter the PagerDuty Integration Key you generated in the earlier steps of this documentation.
   * **Severity**: Select the severity level of alerts to send to this Destination.
   * **Alert Types**: Select the alert types to send to this Destination.
   * **Log Type**: By default, we will send alerts from all log types. Specify log types here if you want to only send alerts from specific log types.
   * **Allow Manual Dispatch**: Set this toggle ON if you'd like to be able to [manually dispatch alerts](https://docs.panther.com/alerts#manual-alert-dispatch) to this destination.\
     ![In the Panther Console, the "Configure your PagerDuty Destination" page is displayed. It contains fields for Display Name, Integration Key, Severity, Alert Types, and Log Types.](/files/dFB4729gUOtJfiw80QWV)
6. Click **Add Destination**.
7. On the final page, optionally click **Send Test Alert** to test the integration. When you are finished, click **Finish Setup**.

## Additional Information on Destinations

For more information on alert routing order, modifying or deleting destinations, and workflow automation, please see the Panther docs: [Destinations](https://docs.panther.com/destinations).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.panther.com/alerts/destinations/pagerduty.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
