# PagerDuty

Firefly integrates with PagerDuty to pull in information about your incidents, services, and on-call schedules as "assets". This means in your Firefly Inventory, you'll see PagerDuty services and incidents listed (with their configurations) just like cloud assets. You can then enforce IaC or policies on them as well (for example, ensuring all services follow a naming convention or have proper escalation policies).

## Prerequisites

* A PagerDuty account with administrative access.
* A Read-Only API Access Key.
* (Optional) A User Token REST API Key for enhanced functionality.
* Access to PagerDuty API endpoints.
* Ability to generate API keys.

## Setup Procedure

1. Log in to your PagerDuty account.
2. Create a Read-Only API Access Key:
   * Navigate to [PagerDuty API Access Keys](https://support.pagerduty.com/docs/api-access-keys#section-generating-a-general-access-rest-api-key).
   * Generate a new Read-Only API Access Key.
   * Copy the key for use in Firefly.
3. (Optional) Generate a User Token REST API Key:
   * Navigate to [PagerDuty User Token REST API Keys](https://support.pagerduty.com/docs/api-access-keys#section-generate-a-user-token-rest-api-key).
   * Generate a new User Token.
   * Copy the token for use in Firefly.
4. In Firefly:
   * Click **Settings > Integrations**.
   * Click **Add New > PagerDuty**.
   * Enter a descriptive name in the Nickname field.
   * Paste your Read-Only API Access Key into the API Access Key field.
   * (Optional) Paste your User Token into the User Token field.
   * Click **Next**.
   * Click **Done**.

## Configuration Details

* Firefly scans every 8 hours by default for SaaS data.
* Your PagerDuty services and incidents list will stay updated automatically.
* You can enforce IaC or policies on your PagerDuty assets.
* The integration supports both Read-Only API Access Keys and User Token REST API Keys for enhanced functionality.
* Supports monitoring of PagerDuty services, incidents, on-call schedules, and escalation policies.


---

# 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.firefly.ai/integrations/data-sources/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.