# 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.](https://4011785613-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LgdiSWdyJcXPahGi9Rs-2910905616%2Fuploads%2Fgit-blob-f3e53e468f84512a1483a1e1c62a84bb844250c4%2FPagerDuty%20Integration%20page%20setup%20final%20form.png?alt=media)
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.](https://4011785613-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LgdiSWdyJcXPahGi9Rs-2910905616%2Fuploads%2Fgit-blob-b13515d46fbeb4ea1633098999c17b32e6944542%2FPagerDuty%20Integration%20Key%20Location.png?alt=media)

{% 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.](https://4011785613-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LgdiSWdyJcXPahGi9Rs-2910905616%2Fuploads%2Fgit-blob-962b1e8861640b663eb84f3710062656a2daff07%2Fpagerduty-panther.png?alt=media)
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).