# Datadog Apps Integration Guide | PagerDuty

Configure the Datadog Apps integration

## Datadog Apps and PagerDuty Benefits

You can view information from PagerDuty in your Datadog dashboard.
You can take action on PagerDuty incidents in your Datadog dashboard.
You can navigate quickly from Datadog to PagerDuty to view details.

## Requirements

To use Datadog apps, you must first install the PagerDuty UI integration in your Datadog account.

1. In Datadog, navigate to **Integrations**.
2. Search for the PagerDuty UI integration and click **Install**.

After the PagerDuty UI integration is installed, follow the individual configuration steps for each app. The following apps are available:

- [Status Dashboards by PagerDuty](#status-dashboards-by-pagerduty)
- [Incidents by PagerDuty](#incidents-by-pagerduty)

## Status Dashboards by PagerDuty

- View the [status](/incident-management/communicate/internal-status-page#business-service-statuses) of PagerDuty business services from your Datadog dashboard.
- Navigate quickly from Datadog to PagerDuty business services and their incident details.

### Requirements

**In PagerDuty**:

- The PagerDuty status dashboard feature is only available on the following pricing plans: Business, Digital Operations (legacy) and Enterprise for incident management. [Contact the PagerDuty Sales Team](https://www.pagerduty.com/contact-sales/) to upgrade to a plan including the status dashboard feature.

**In Datadog**:

- This integration requires the `dashboards_write` permission in Datadog.

### How It Works

- When a PagerDuty business service is impacted by an incident on one of its supporting services, the Status Dashboards by PagerDuty app updates with its status.

### Integration Walkthrough

#### Configure PagerDuty

1. To use the Status Dashboards by PagerDuty app, [configure an Internal Status Page](/incident-management/communicate/internal-status-page#configure-the-internal-status-page) in your PagerDuty account.

#### Configure Datadog

2. In your Datadog account, navigate to **Dashboards**. Select the dashboard where you want to add the Status Dashboard app, or [create a new dashboard](https://docs.datadoghq.com/dashboards/#new-dashboard).
3. In the dashboard, click **Add Widgets** to the right of the dashboard title. With the widgets pane expanded, select the **UI Extensions** tab and click **Incidents by PagerDuty**.

![A screenshot of the Datadog UI highlighting the Status Dashboard by PagerDuty widget](/images/kb/1e4a8fa4220803c0c9679caadf88bbd442274493d27f8cc0b20e9eb56edf2aba-status_dashboard_by_PagerDuty.webp)
*Status Dashboard by PagerDuty*

4. In the **Status Dashboard by PagerDuty Editor** modal, click **Connect**.
5. Click **Sign in to PagerDuty** and complete the login process.
6. You are redirected to the **Editor** modal where you see a preview of how the app appears. Configure the following fields:

| Field            | Value                                                                                                                                       |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| **Options**      | Select from the dropdown to choose which [Internal Status Page](/incident-management/communicate/internal-status-page#create-custom-dashboards) is displayed by default. |
| **Widget title** | (Optional) Enter a title for the widget.                                                                                                    |

7. Click **Save** to add the app to your dashboard.

### Using Status Dashboards by PagerDuty

#### View Status Dashboards by PagerDuty

Navigate to **Dashboards** and select the dashboard with the app configured.

#### View Related Business Services

Click **** to the right of a business service to view related business services.

#### View Details in PagerDuty

Click the **Business Service name** to view it within PagerDuty. To view the PagerDuty status dashboard, click **Go to PagerDuty**.

#### Log Out of the Status Dashboard

To log out of the status dashboard of this account, click ****  →  **** and select **Log out**.

## Incidents by PagerDuty

- View and take action on up to 20 active incidents from your teams within the Datadog dashboard.
- Navigate quickly from Datadog to PagerDuty to view full incident and service details.

### Requirements

**In Datadog**:

- This integration requires the `dashboards_write` permission in Datadog.

### How It Works

- When there are active, high-urgency PagerDuty incidents associated with your team, the Incidents by PagerDuty app updates its incident list.
- Incidents by PagerDuty displays up to 20 active incidents. You can navigate to PagerDuty to view individual incidents and their services, or view all incidents.

### Integration Walkthrough

#### Configure Datadog

1. In your Datadog account, navigate to **Dashboards**. Select the dashboard where you want to add the Incidents by PagerDuty app, or [create a new dashboard](https://docs.datadoghq.com/dashboards/#new-dashboard).
2. In the dashboard, click **Add Widgets** to the right of the dashboard title. With the widgets pane expanded, select the **UI Extensions** tab and click **Incidents by PagerDuty**.

![A screenshot of the Datadog UI highlighting the Incidents by PagerDuty widget](/images/kb/300e94437326ef2ae94401bb62c7f9291083aa957abadd226cfbad2eeb2b0694-incicents_by_PagerDuty.webp)
*Incidents by PagerDuty*

3. In the **Incidents by PagerDuty Editor** modal, click **Connect**.
4. Click **Sign in to PagerDuty** and complete the login process.
5. You are redirected to the **Editor** modal where you see a preview of how the app appears. Configure the following field:

| Field            | Value                                    |
| ---------------- | ---------------------------------------- |
| **Widget title** | (Optional) Enter a title for the widget. |

6. Click **Save** to add the app to your dashboard.

### Using Incidents by PagerDuty

#### Incident Details in Datadog

Each incident in the Incidents by PagerDuty app displays the following information:

- **Status**: The [status of the incident](/incident-management/incidents/overview#incident-statuses) as Triggered, Acknowledged or Resolved.
- **Priority**: The [priority level of the incident](/incident-management/incidents/incident-priority).
- **Incident Title**: The title of the incident, linked to view in PagerDuty.
- **Service**: The [service of the incident](/incident-management/services/services-and-integrations), linked to view in PagerDuty.
- **Escalation Policy**: The [escalation policy of the incident](/incident-management/schedules/escalation-policies), linked to view in PagerDuty.
- **Duration**: The duration of the incident.
- **Assigned to**: The assigned responder of the incident.
- **Outlier Incident**: Context on [how often similar incidents occur on a specific service](/ai-automation/aiops/outlier-incident). **Note**: This feature is only available to accounts with the Event Intelligence add-on, or those on the following pricing plans: Digital Operations (legacy) and Enterprise for incident management.

#### Acknowledge or Resolve an Incident

1. **Check the box** to the left of the incident.
2. Click **Acknowledge** or **Resolve** in the bottom menu.

#### View Incident or Service Details in PagerDuty

1. Click the **Incident Title** or **Service** to view more details in PagerDuty.
2. To view a list of all incidents in PagerDuty, click **View all Incidents** in the bottom right.

## FAQ

**Can I add two Status Dashboard apps with two different Status Dashboard views enabled?**

Yes, as long as each Internal Status Page view is from the same PagerDuty account. Using two different PagerDuty accounts on the same dashboard is currently not supported.