---
title: PagerDuty
summary: null
url: >-
  https://www.fastly.com/documentation/guides/next-gen-waf/integrations/pagerduty
---

Our PagerDuty integration (alert) creates an incident in PagerDuty when certain Next-Gen WAF activity occurs.

> **HINT:** 
>
> Want to set up alerting for your CDN or Compute service? Check out our [Observability](/guides/observability/alerts/about-alerts/) guides.
>
>
>

## Setting up PagerDuty integrations (alerts)

To set up a PagerDuty integration (alert), you need to [create a PagerDuty service](https://www.fastly.com/documentation/guides/next-gen-waf/integrations/pagerduty#creating-pagerduty-services) and then [add the integration (alert)](https://www.fastly.com/documentation/guides/next-gen-waf/integrations/pagerduty#adding-pagerduty-integrations-alerts) in the control panel you use to access the Next-Gen WAF. PagerDuty integrations (alerts) are configured per project.

### Creating PagerDuty services

Before adding the PagerDuty integration (alert), create a new PagerDuty service:

1. In PagerDuty, create a [new service](https://support.pagerduty.com/docs/services-and-integrations#create-a-service) by selecting **Use Our API Directly** from the **Integration Type** menu.
2. Copy the newly created **Service API Key**.

### Adding PagerDuty integrations (alerts)

After creating a new PagerDuty service, you can set up the PagerDuty integration (alert):

### Next Gen Waf Control Panel

1.   Log in to the [Next-Gen WAF control panel](https://dashboard.signalsciences.net).

2.   From the **Sites** menu, select a site if you have more than one site.

3. From the **Manage** menu, select **Site Integrations**.
4. Click **Add site integration**.
5. Select the **PagerDuty Trigger** integration.
6. In the **Service API Key** field, enter the **Service API Key** created in PagerDuty.
7.   Select if you want to be alerted regarding **All activity** or **Specific activity**. If you selected **Specific activity**, then in the **Activity** menu choose the activity types that you want the integration to create alerts for.

8. Click **Create site integration**.

### Fastly Control Panel

1. [Create a new service in PagerDuty](https://support.pagerduty.com/docs/services-and-integrations#create-a-service) selecting **Use Our API Directly** from the **Integration Type** menu.
2. Copy the newly created **Service API Key**.
3.   Log in to the [Fastly control panel](https://manage.fastly.com).

4.   Go to **Security** > **Next-Gen WAF** > [**Workspaces**](https://manage.fastly.com/security/ngwaf/workspaces).

5.   Click the gear <span class="inline-icons"><img src="/img/icons/gear.png" alt="Gear icon" /></span> next to the workspace that you want to modify.

6. Click **Alerts** and then **Add alert**.
7. Fill out the **Add alert** form as follows:
   - From the **Integration type** menu, select **PagerDuty**.
   - In the **API key** field, enter the **API key** created in PagerDuty.
   - In the **Select activities** menu, leave **Flagged IPs** checked.
8. Click **Add workspace alert**.

## Activity types

> **IMPORTANT:** This section only applies to Next-Gen WAF customers with access to the [Next-Gen WAF control panel](https://dashboard.signalsciences.net).

When setting up a PagerDuty integration in the Next-Gen WAF control panel, you can select from the following activity types:

| Activity type | Description                  |
| ------------- | ---------------------------- |
| `flag`        | An IP was address flagged    |
| `agentAlert`  | An agent alert was triggered |

## Related content

- [Using an API with the Next-Gen WAF](https://www.fastly.com/documentation/guides/next-gen-waf/developer/using-an-api-with-the-next-gen-waf)