# 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.&#x20;

   * 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%2FO2fy1B9H9nZYOH1s4qBs%2FScreenshot%202023-07-12%20at%2010.47.20%20AM.png?alt=media\&token=cfcc7c43-056a-460f-990b-e09894516274)
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%2Fu1iE8O9EHhlrozVYFUr6%2FPagerDuty%20Integration%20Key%20Location.png?alt=media\&token=5efc0e97-7977-48fe-b283-5bcc6b6badf6)

{% 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**.&#x20;
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.\
     ![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%2FIMKJUWNwH81kZPbkoaq0%2Fpagerduty-panther.png?alt=media\&token=f6d28fbc-feaf-4cc0-8ae0-6cf15d850c6c)
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).