Datadog Add-on Guide

Datadog screenboards are powerful dashboards for your incident metrics. By bringing these dashboards straight into PagerDuty, you can view your incident metrics alongside your incident management dashboard. This will allow you to both manage and analyze your incidents in one centralized location.

See a live demo:

Single-Page Dashboards

In Datadog

  1. Navigate to a dashboard you want to include in PagerDuty

  2. Click on the settings button

  3. In the drop-down menu, select Generate Public URL

    4. Monitor___Datadog

  4. Copy the URL

    5. Monitor___Datadog 2

In PagerDuty

  1. Click on Configuration followed by Extensions

  2. Click on the Add-Ons tab and click Add an Add-on

  3. Enter a name for your add-on, choose It’s Own Page, and enter the URL you copied in step 4 above

  4. Click Save

    5. Extension_-_PagerDuty 2

Incident Dashboards

In Datadog

  1. Navigate to the dashboard you want appended to incidents

  2. Click on the edit button of the metric you want to append to incidents

    3. Lucas_s_TimeBoard_9_Aug_2016_15_30___Datadog 2

  3. Click on the share tab

  4. Pick a timeframe, graph size, and choose whether or not to include the legend. We recommend using the Medium size for the best visibility across mobile and desktop web.

  5. Click on Generate embed code

  6. Copy the src attribute value to your clipboard

    7. Lucas_s_TimeBoard_9_Aug_2016_15_30___Datadog

In PagerDuty

  1. Click on Configuration followed by Extensions

  2. Go to the Add-Ons tab and click Add an Add-On

  3. Name your add-on whatever you want, select Add this to incidents on a service, select your service, and add your URL you copied from the src attribute in step 5 above

  4. Click Save

    5. Extension_-_PagerDuty

FAQ

Is there any way to update a dashboard from within PagerDuty?

No, the public URLs for Datadog dashboards are read-only. To update a dashboard you must make the edits within Datadog.

I added my dashboard as an add-on but nothing is loading on the page

Ensure that the public URL for the dashboard is accessible by going directly to the URL in your browser. If you can load the dashboard within your browser, it should be loading within PagerDuty as well. If you are experiencing this issue, please contact our Support Team for assistance resolving this issue.

Will these dashboards be available for our mobile users?

While single-page dashboards will not be available via the mobile app, incident dashboards will be available when viewing your incidents. On each incident, your mobile users will see a link to the Datadog add-on for this incident. Clicking on this link will open the Datadog scoreboard within the default web browser on their mobile phones.

Can I add more than one timecard to my incidents?

Yes, you can add multiple add-ons to a particular service and all of these add-ons will appear within the details of the incidents triggered on this service.