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

# PagerDuty

> How DSALTA integrates with PagerDuty — data collected, setup guide, and automated compliance checks.

## Overview

DSALTA connects to PagerDuty using read-only API access to collect compliance evidence automatically. Data syncs every 24 hours and feeds into your Data Library modules. DSALTA reads your account **users** (email and role) and **services** to power access reviews.

<Info>
  **Read-only access.** DSALTA never modifies, creates, or deletes resources in your PagerDuty account.
</Info>

## How to Connect

PagerDuty connects with a **REST API key** — there's no app to install. The free tier works; no paid or enterprise plan is required.

<Steps>
  <Step title="Create a REST API key">
    In PagerDuty, open the **Integrations** menu, then **API Access Keys**. Click **Create New API Key**, add a description (for example, `DSALTA`), and — optionally — check **Read-only API Key**. Click **Create Key** and copy the key now; it is shown only once. Creating a key requires account **admin** or **owner** access.
  </Step>

  <Step title="Connect PagerDuty">
    In the DSALTA sidebar, go to **Integrations**, find **PagerDuty**, and click **Connect**. Paste the REST API key in the secure window, then click **Connect**.
  </Step>

  <Step title="Validate and finish">
    DSALTA verifies the key before saving, then runs an initial sync. Once the sync completes, the compliance checks below activate.
  </Step>
</Steps>

## Automated Compliance Checks

Each check below runs automatically every 24 hours. Click any check for step-by-step remediation guidance.

| Check                                                                                                                    | Description                                                                          |
| ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------ |
| [User access to Critical System should be valid](/integrations/pagerduty/user-access-to-critical-system-should-be-valid) | Checks that everyone with PagerDuty access is an active employee on the People page. |
| [Offboarded users should not have active access](/integrations/pagerduty/offboarded-users-should-not-have-active-access) | Checks that offboarded employees no longer have active PagerDuty access.             |

## Troubleshooting

<AccordionGroup>
  <Accordion title="Integration shows Disconnected">
    Re-authenticate from **Integrations → PagerDuty → Reconnect**. This usually happens when the REST API key was deleted or rotated in PagerDuty. Create a new key and reconnect.
  </Accordion>

  <Accordion title="Data is not syncing">
    Confirm the REST API key is still valid and has read access to users. If the key was removed, generate a new one under **Integrations → API Access Keys** and reconnect, then trigger a manual sync from the integration settings.
  </Accordion>
</AccordionGroup>