# PagerDuty

## PagerDuty + Multitudes Integration Benefits

* See [`Mean Time To Recovery`](/metrics-and-definitions/process-metrics/quality-of-work/mean-time-to-recovery.md) for PagerDuty incidents
* See [`Mean Time To Acknowledge`](/metrics-and-definitions/process-metrics/quality-of-work/mean-time-to-acknowledge.md) for PagerDuty incidents 
* See [`Number of Pages`](/metrics-and-definitions/process-metrics/quality-of-work/number-of-pages.md) split by service and escalation policy
* Keep track of burnout risk by seeing  [`Page Disruptions`](/metrics-and-definitions/people-metrics/wellbeing/page-disruptions.md)  – by either the number of pages or number of disrupted hours per team and user, during both work hours and out-of-hours (customisable by each team member's usual working hours)

## How it works

Incident-related events from PagerDuty (such as an incident being triggered, assigned, acknowledged, and resolved) will be sent to Multitudes. This data is then processed by our data pipelines and shown in the Multitudes app as actionable insights around [`Quality of Work`](/metrics-and-definitions/process-metrics/quality-of-work.md) and [`Wellbeing`](/metrics-and-definitions/people-metrics/wellbeing.md).

## Requirements

PagerDuty integrations require an Admin base role for account authorization. If you do not have this role, please reach out to a PagerDuty Admin or Account Owner within your organization to configure the integration.

If you need help with this integration, please contact `support@multitudes.com`.

## How to install 

1. Go to <https://app.multitudes.co/teamSettings/integrations>
2. Find the **PagerDuty** card and click **Connect**.
3. In the modal, click **Continue to set up PagerDuty**. This will open the PagerDuty sign in page.
4. Sign in with your PagerDuty credentials.
5. **Submit Consent** for the app installation. This will redirect you back to Multitudes.You will see a new modal screen that prompts you to input an API key.

<figure><img src="https://cdn.prod.website-files.com/610c8a14b4df1ae46b1a13a3/6625964f7929cf971beab58a_Screenshot%202024-04-19%20at%205.32.49%E2%80%AFPM.png" alt="Screenshot of the approval screen on PagerDuty"><figcaption><p>Step 5: approve the pemissions by clicking "Submit Consent"</p></figcaption></figure>

6. For the next step, go to PagerDuty in a new tab.
7. In the top navigation bar, navigate to **Integrations** > **API Access Keys**.
8. Click **Create new API key.**&#x200D;
9. Add a description, e.g. "Multitudes App Integration", do **not** select "Read-only API Key"\*, and click **Create Key**.\
   \*We need write access to create the webhook on your PagerDuty account.<br>

   <figure><img src="/files/3R6MtYhadrwOLe5nea5A" alt=""><figcaption></figcaption></figure>
10. Copy the newly generated **API Key**, then **Close**.
11. Back in the Multitudes tab, paste the API Key in the text field on the modal, and click **Add API Key**.

<figure><img src="https://cdn.prod.website-files.com/610c8a14b4df1ae46b1a13a3/661eeafe12fda48e21927633_Screenshot%202024-04-17%20at%208.21.42%E2%80%AFAM.png" alt="A screenshot of the Multitudes PagerDuty configuration modal, showing where to input the API key."><figcaption></figcaption></figure>

This is the installation part complete. You can now revoke the API token in PagerDuty as we only use it to set up the webhook. In the top navigation bar, navigate to **Integrations > API Access Keys**, find the API key you just created, and click **Remove** on the right hand side of the row.

The next two steps in Multitudes help you configure your data so that it is accurate and comprehensive.

1. User linking: see the [section on user linking](/configuration-and-setup/user-linking.md) for how to match your Multitudes team members to PagerDuty users, so that incident assignments and pages are attributed to the correct people in Multitudes.
2. Default filter setting: choose which field would be most useful for you to filter incidents on, between **urgency** and **priority level.**

## **How we use PagerDuty's webhooks**

<figure><img src="https://cdn.prod.website-files.com/610c8a14b4df1ae46b1a13a3/661eee4f7e8aa97dddfa2700_Screenshot%202024-04-17%20at%209.29.47%E2%80%AFAM.png" alt="Screenshot of PagerDuty showing the organization&#x27;s list of webhooks from the Integrations tab."><figcaption><p>List of webhooks on PagerDuty</p></figcaption></figure>

We use your API token to create a webhook. You can see this in PagerDuty by navigating to **Integrations** > **Generic Webhooks (v3)**. The webhook sends us events on updates to incidents, which powers our PagerDuty-related insights about incidents and pages in Multitudes.

<figure><img src="https://cdn.prod.website-files.com/610c8a14b4df1ae46b1a13a3/661eee323713c76abcbb6516_Screenshot%202024-04-17%20at%209.31.14%E2%80%AFAM.png" alt="Screenshot of PagerDuty showing the &#x22;Manage Webhook&#x22; screen for a Multitudes webhook."><figcaption><p>Webhook settings shown when you click into the webhook.</p></figcaption></figure>

{% hint style="danger" %}
Please don't edit this webhook, as it will impact the delivery of data into Multitudes and affect the accuracy of your insights. This includes the `multitudesId` custom header is used to identify your PagerDuty organization inside Multitudes.
{% endhint %}

If you have any questions about the settings, please contact `support@multitudes.com`.

## Historic Data

Once the data from Pagerduty has been ingested, you will see that the `Mean Time To Recovery` (MTTR) graph will be populated with the last six weeks of data.&#x20;

Due to limitations from the Pagerduty API, the `Mean Time To Acknowledge` (MTTA) will not display historic data and will instead be populated with data from the point at which the webhook was created.&#x20;

## How to Uninstall

To uninstall the app, please contact `support@multitudes.com`.

To uninstall the webhook:

1. In PagerDuty, in the top navigation bar, navigate to **Integrations** > **Generic Webhooks (v3)**.
2. Under **Subscriptions**, find the webhook called `https://pagerduty.prod.multitudes.co/events`. Click the **"..." menu** on the right hand side of the card, and click **Delete**.


---

# 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.multitudes.com/integrations/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.