> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bronto.io/llms.txt
> Use this file to discover all available pages before exploring further.

# PagerDuty

> Forward PagerDuty events into Bronto using PagerDuty's Generic Webhooks integration, so you can store, search, and analyze incident activity alongside your other telemetry.

## Overview

PagerDuty supports delivering event data to third-party systems using its **Generic Webhooks** integration.
This guide walks you through configuring PagerDuty to forward PagerDuty events into Bronto for storage and analysis.

PagerDuty webhooks can be configured at different scopes and allow you to subscribe to specific event types.
For detailed information on PagerDuty webhooks, scopes, and available event types, refer to the [official PagerDuty documentation](https://support.pagerduty.com/main/docs/webhooks).

Once configured, PagerDuty will send event payloads via HTTPS to Bronto’s ingestion endpoint.

## PagerDuty Webhook Configuration

1. Create a Generic Webhook in PagerDuty.
2. Choose the desired scope and event types.
   Refer to the [PagerDuty documentation](https://support.pagerduty.com/main/docs/webhooks) for details.
   Configure the webhook with destination URL:

```
https://ingestion.<region>.bronto.io/
```

The `<region>` refers to your data storage region, e.g., "eu", "us".

3. Custom Headers
   Add the following custom headers to the webhook:

* `x-bronto-api-key`- your Bronto API key. *Tip: It is recommended to create a dedicated API key for PagerDuty with **ingestion-only** permissions. See the [Bronto API Keys documentation](/Account-Management/API-Keys) for details.*
* `x-bronto-dataset` - target dataset name in Bronto. (*Does not need to pre-exist* in Bronto. It will be automatically created when events are ingested.)
* `x-bronto-collection` - target collection name in Bronto. (*Does not need to pre-exist* in Bronto. It will be automatically created when events are ingested.)
* `x-bronto-tags` (optional) - `<key1=value1,key2=value2,..>`

## Testing the Integration

After saving the webhook, click Send Test Event in PagerDuty.
The event should appear in Bronto under the specified dataset within a few seconds to a few minutes.

## Screenshots

<Frame>
  <img src="https://mintcdn.com/bronto/aZTTPBZdc5OiFZlo/images/integrations/assets/images/pagerduty-settings.png?fit=max&auto=format&n=aZTTPBZdc5OiFZlo&q=85&s=5f39c0f4acf517b899e06520e479564d" width="841" height="458" data-path="images/integrations/assets/images/pagerduty-settings.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/bronto/aZTTPBZdc5OiFZlo/images/integrations/assets/images/pagerduty-custom-headers.png?fit=max&auto=format&n=aZTTPBZdc5OiFZlo&q=85&s=67b4ae48d48ca064c0019b00ab89efd2" width="841" height="422" data-path="images/integrations/assets/images/pagerduty-custom-headers.png" />
</Frame>