# PagerDuty

{% hint style="info" %}
This plugin is part of Pro and Enterprise plan only
{% endhint %}

## Overview

PagerDuty is an alerting and incident management platform, known for its robust on-call scheduling, escalation policies, and real-time alerts. By integrating PagerDuty with Rely.io, you can automate the incident response and synchronize your on-call information with your service catalog, thus ensuring smoother operations and quicker issue resolution.

## Installation Guide

### Setup

#### Step 1: Generate a PagerDuty API Key (official docs [here](https://support.pagerduty.com/docs/api-access-keys)).

1. Log in to your PagerDuty account and navigate to `Integrations` → `API Access Keys`.
2. Click the `Create New API Key` button.
3. Enter a description for the API Key, for instance, "Rely.io Integration."
4. Set the API key to have `Read` access, as needed for the integration.
5. Click `Create Key` and make sure to copy and store the generated API Key securely.

#### Step 2: Configure PagerDuty in Rely.io

1. Open the Rely.io application and go to `Settings` → `Data Sources`.
2. Click on the `Add Data Source` button and select `PagerDuty`.
3. A form will appear asking for details to complete the integration.
   * **Collector Name**: Assign a name for the PagerDuty data collector.
   * **API Key**: Paste the API Key you generated in Step 1.

Click on `Create` to establish the integration. Your PagerDuty collector should now be listed in the `Active` section of your `Data Sources`.

After you submit your form, an entity discovery run will be kickstarted that can take a few minutes. By the end of this discovery run:

* New blueprints will be added to your data model
* Entities will be queries from the data-source and added to your software catalog
* These entities will be periodically updated to ensure they remain in sync with their external counter-parts
