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

# PagerDuty

> Connect PagerDuty to Steadwing so incident timelines, alerts, escalation patterns, and response metrics are automatically pulled into every root cause analysis.

## What does the PagerDuty integration do?

The PagerDuty integration feeds incident timelines, alerts, escalation patterns, and response metrics into Steadwing's root cause analysis giving Steadwing the on-call context needed to correlate responder actions with production incidents. During RCA, Steadwing queries your PagerDuty account for relevant incidents, log entries, and custom fields automatically.

## Why Use PagerDuty with Steadwing?

<CardGroup cols={2}>
  <Card title="Incident Timeline" icon="clock">
    Build complete incident timelines with triggers, acknowledgments, and resolutions
  </Card>

  <Card title="Alert Correlation" icon="bell">
    Connect PagerDuty alerts to monitoring tools like Datadog and Sentry
  </Card>

  <Card title="Response Metrics" icon="gauge">
    Track time to acknowledge and resolve for incident analysis
  </Card>

  <Card title="Escalation Patterns" icon="users">
    Understand escalation paths and responder involvement during incidents
  </Card>
</CardGroup>

## Connection Methods

There are two ways to connect PagerDuty to Steadwing. You can use one or both together.

| Method                      | Best For                                         |
| --------------------------- | ------------------------------------------------ |
| **Marketplace App (OAuth)** | Auto-triggering RCA when a PagerDuty alert fires |
| **API Key**                 | Querying PagerDuty as a data source during RCA   |

***

## Method 1: Marketplace App (OAuth)

Install Steadwing directly from the PagerDuty Marketplace. Once installed, Steadwing automatically launches root cause analysis the moment a PagerDuty alert fires no manual intervention needed.

<CardGroup cols={3}>
  <Card title="1-Click Installation" icon="mouse-pointer">
    Install Steadwing directly from the PagerDuty Marketplace no manual configuration needed.
  </Card>

  <Card title="Auto-Trigger on Alerts" icon="bell">
    Steadwing automatically kicks off root cause analysis whenever a PagerDuty alert fires.
  </Card>

  <Card title="In-Depth Analysis & Noise Reduction" icon="magnifying-glass-chart">
    Get comprehensive analysis of every alert while filtering out noise.
  </Card>
</CardGroup>

### Step 1: Install Steadwing from the PagerDuty Marketplace

1. Go to the **PagerDuty Marketplace** (PagerDuty → Integrations → App Registration or Marketplace)
2. Search for **Steadwing** and click **Install**
3. Authorize the connection it will redirect you back to Steadwing

### Step 2: Link to your Steadwing organization

1. After the redirect, select your Steadwing organization from the dropdown
2. Click **Complete Setup**
3. The app status will show **App installed** on the PagerDuty integration card

<Note>
  The Marketplace App handles webhook delivery. Steadwing receives PagerDuty alert events automatically without any additional configuration.
</Note>

***

## Method 2: API Key

Connect PagerDuty as a **data source**, allowing Steadwing to query incident and alert data during root cause analysis.

### Step 1: Create a PagerDuty API Key

1. Log in to your PagerDuty account
2. Navigate to **Integrations** → **Developer Tools** → **API Access Keys**
   * Direct link: [https://your-subdomain.pagerduty.com/api\_keys](https://your-subdomain.pagerduty.com/api_keys)
3. Click **Create New API Key**
4. Configure the key:
   * **Description:** Steadwing Integration
   * **Key Type:** Read-only API Key (recommended)
5. Click **Create Key**
6. Copy the generated API key

<Warning>
  Save your API key immediately! PagerDuty only shows the key once. Store it securely as it provides access to your incident data.
</Warning>

### Step 2: Connect PagerDuty in Steadwing

1. Navigate to [Steadwing Settings](https://app.steadwing.com/settings)
2. Find the **PagerDuty** integration card
3. Click **Connect via API Key**
4. Fill in the required fields:
   * **API Key:** Your PagerDuty API key
5. Click **Connect**

<Tip>
  Using a read-only API key is recommended. Steadwing only needs to read incident data and never modifies your PagerDuty configuration.
</Tip>

***

## What data does Steadwing pull from PagerDuty?

Steadwing queries PagerDuty for:

* **Incidents** - Active and recent incidents by time range and status
* **Alerts** - Alerts associated with each incident
* **Log Entries** - Complete incident timeline including triggers, escalations, and resolutions
* **Response Metrics** - Time to acknowledge, time to resolve
* **Custom Fields** - Any custom incident field values you've configured

## What permissions does the PagerDuty integration need?

The PagerDuty API key requires read access to:

* **Incidents** - Read incident data and status
* **Alerts** - Read alert details and sources
* **Log Entries** - Read incident activity logs

## FAQs

<AccordionGroup>
  <Accordion title="Do I need both connection methods?">
    No. The Marketplace App auto-triggers RCA when alerts fire. The API Key lets Steadwing query PagerDuty as a data source during analysis. Using both together gives you full coverage — automatic triggers plus deep data access.
  </Accordion>

  <Accordion title="What type of API key should I use?">
    A read-only API key is recommended. Steadwing only queries incident data and does not need write access to your PagerDuty account.
  </Accordion>

  <Accordion title="How does Steadwing correlate PagerDuty with other tools?">
    PagerDuty alerts often contain integration metadata from monitoring tools like Datadog, Sentry, or CloudWatch. Steadwing uses this metadata to correlate incidents across your entire observability stack.
  </Accordion>

  <Accordion title="Can Steadwing acknowledge or resolve incidents?">
    No, Steadwing only has read access. Steadwing queries incident data but never acknowledges, resolves, or modifies incidents in PagerDuty.
  </Accordion>

  <Accordion title="What time range does Steadwing query?">
    Steadwing queries incidents around the incident timeframe being analyzed, typically including some buffer time before and after to capture related events.
  </Accordion>

  <Accordion title="What happens if my API key is revoked?">
    The API Token connection will stop working. Create a new API key and update it in Steadwing Settings to reconnect.
  </Accordion>
</AccordionGroup>

Need additional help? Please reach out to us at [hello@steadwing.com](mailto:hello@steadwing.com)