Datadog Apps Integration Guide | PagerDuty
Configure the Datadog Apps integration
Datadog Apps + PagerDuty Benefits
- Users can view information from PagerDuty in their Datadog dashboard.
- Users can take action on PagerDuty incidents in their Datadog dashboard.
- Users can then navigate quickly from Datadog to PagerDuty to view details.
Requirements
In order to use Datadog apps, you must first install the PagerDuty UI integration in your Datadog account.
- In Datadog, navigate to Integrations in the left menu.
- Search for the PagerDuty UI integration and click Install.
Once the PagerDuty UI integration has been installed, please follow the individual configuration steps for each app. The following apps are available:
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
- In order to use the Status Dashboards by PagerDuty app, you will need to configure an Internal Status Page in your PagerDuty account.
In Datadog
- 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.
- 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.
- In the Status Dashboard by PagerDuty Editor modal, click Connect. Click Sign in to PagerDuty and complete the login process. You will be redirected to the Editor modal where you will see a preview of how the app will appear. Under Options, make a selection from the dropdown to choose which Internal Status Page is displayed by default. Optionally enter a Widget title. Click Save to add the app to your dashboard.
The integration is now complete.
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 this account’s Status Dashboard, click and then 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 will update its incident list.
- Incidents by PagerDuty will display up to 20 active incidents. Users can easily navigate to PagerDuty to view individual incidents and their services, or view all incidents.
Integration Walkthrough
In Datadog
- 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.
- 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.
- In the Incidents by PagerDuty Editor modal, click Connect. Click Sign in to PagerDuty and complete the login process. 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 Save to add the app to your dashboard.
The integration is now complete.
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
- Check the box to the left of the incident.
- Click Acknowledge or Resolve in the bottom menu.
View Incident or Service Details in PagerDuty
- Click the Incident Title or Service to view more details in PagerDuty.
- 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.
Updated about 1 month ago
Learn more