Datadog Apps Integration Guide | PagerDuty

Datadog apps allow users to view information from PagerDuty in their Datadog dashboard. Users can then navigate quickly from Datadog to PagerDuty to view details. 

Prerequisite: Configure the PagerDuty UI Integration

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

  1. In your Datadog account, navigate to Integrations in the left menu.
  2. Search for the PagerDuty UI integration, hover over the Available button, and then click Install.

Once the PagerDuty UI integration has been installed, please follow the individual configuration steps for each app. The following apps are available:

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 will update its incident list.
  • Incidents by PagerDuty will display up to 20 active incidents. Users can easily navigate into PagerDuty to view individual incidents and their services, or view all incidents.

Integration Walkthrough

In Datadog

  1. In your Datadog account, navigate to Dashboards. Select the dashboard where you would like to add the Incidents by PagerDuty app, or create a new dashboard
  2. In the dashboard, click +Add Widgets to the right of the dashboard title. Scroll to the right through the widgets to the Apps section, and then drag and drop the PagerDuty Event Intelligence app into your desired position on your dashboard. 
  3. In the Editor modal, click Connect. Select your service region and then log in to your PagerDuty account. You will be redirected to the Editor modal where you will see a preview of how the app will appear. Below the preview, you may optionally enter a Widget title. Click Done to add the app to your dashboard. The integration is now complete.
PagerDuty incident

PagerDuty incident

Using Incidents by PagerDuty

Incident Details in Datadog

Each incident in the Incidents by PagerDuty app will display the following information:

  • Status: The incident's status as Triggered, Acknowledged or Resolved.
  • Priority: The incident's priority level.
  • Incident Title: The incident's title, linked to view in PagerDuty.
  • Service: The incident's service, linked to view in PagerDuty.
  • Escalation Policy: The incident's escalation policy, linked to view in PagerDuty.
  • Duration: The incident's duration.
  • Assigned to: The incident's assigned responder.
  • Outlier Incident: Context on how often similar incidents occur on a specific service. 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.

Status Dashboards by PagerDuty

  • Work where you are: View the status 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. Please contact our Sales Team if you would like 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 will be updated with its status. 

Integration Walkthrough

In PagerDuty

  1. In order to use the Status Dashboards by PagerDuty app, you will need to have a Status Dashboard configured in your PagerDuty account. 

In Datadog

  1. In your Datadog account, navigate to Dashboards. Select the dashboard where you would like to add the Status Dashboard app, or create a new dashboard
  2. In the dashboard, click +Add Widgets to the right of the dashboard title. Scroll to the right through the widgets to the Apps section, and then drag and drop the Status Dashboard app into your desired position on your dashboard. 
  3. In the Editor modal, click Connect. Select your service region and then log in to your PagerDuty account. You will be redirected to the Editor modal where you will see a preview of how the app will appear. Below the preview, under Options you may optionally select which Status Dashboard view that you would like the dashboard to default to. You may also optionally enter a Widget title, if desired. Click Done to add the app to your dashboard. The integration is now complete.
Status dashboard

Status 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 the V to the right of each 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 this account’s Status Dashboard, click the button and select Log out.

FAQ

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

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