> For the complete documentation index, see [llms.txt](https://help.sleuth.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.sleuth.io/sleuth-dora/integrations-1/impact-sources/incident-tracker-integrations/pagerduty.md).

# PagerDuty

## About the integration <img src="https://2832637360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1bR_-Od0islbiOl4G0%2Fuploads%2Fgit-blob-69095d71dfd4d7c9b71313e2eed676a69246168b%2Fpagerduty-logo.png?alt=media" alt="" data-size="line">

PagerDuty centralizes, simplifies, and automates your incident response process to help you resolve issues quickly and efficiently. Integrating PagerDuty with Sleuth is simple using OAuth2.

## Setting up the integration

To add the Sleuth PagerDuty integration:

* Click **Integrations** in the sidebar.
* Click the \_Incidents \_tab, then **enable** in the PagerDuty card.
* Select the PagerDuty account you want to use
* Upon successful integration, you'll see **PagerDuty enabled (Connected as \_\<PagerDuty user account>)**&#x64;isplayed in the PagerDuty tile. You'll next configure the impact sources.

![](https://2832637360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1bR_-Od0islbiOl4G0%2Fuploads%2Fgit-blob-f903e478d35f408b1606ae4ae6159bcb4562aa84%2FScreenshot%202021-10-05%20at%2015.10.07.png?alt=media)

## Configuring the integration

* Click **Add incident source** and select a Sleuth project that will track PagerDuty incidents. All projects within your organization will be displayed in the dropdown.
* Configure impact source by selecting desired PagerDuty services and urgencies to track with Sleuth.
* Under advanced settings, you can control the historic data population. If checked Sleuth will populate all incidents that happened in the last 30 days and recalculate the project's Failure Rate and MTTR metrics.

{% hint style="info" %}
Integrations are made at the Sleuth organization level and are available for all projects within that organization. Individual settings for integration are made at the project level.
{% endhint %}

* That's it! Sleuth will now start tracking incidents declared in PagerDuty.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.sleuth.io/sleuth-dora/integrations-1/impact-sources/incident-tracker-integrations/pagerduty.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
