Datadog Integration Guide

Datadog is a hosted monitoring service that brings all your metrics and events in one place, so that they can be seen, shared and discussed by your development and operations teams. Once you integrate your Datadog and PagerDuty accounts you can send Datadog alerts to PagerDuty via a simple @pagerduty mention in Datadog’s newsfeed. You can also follow incidents and escalations in real-time in Datadog’s newsfeed. By sending Datadog alerts to PagerDuty, you take full advantage of PagerDuty’s alerting functionality. With PagerDuty, you can receive alerts via phone call, SMS and email, set up automatic escalation of alerts and set up on-call duty scheduling for your ops teams.

Start in Datadog

  1. Go to your Datadog account profile to create a new contact group. Find the PagerDuty integration and click the PagerDuty Install button to add a new PagerDuty group.

  2. The integration details will appear. Click on the Alert with PagerDuty button on the Configuration tab.

  3. You will be redirected to PagerDuty. Enter your PagerDuty login information and click Authorize Integration.

  4. The next step will ask you to create a new service in PagerDuty for the integration. The default name of the service will be Datadog, which you can change if you’d like. Select an Escalation Policy for the service.

  5. You will be redirected back to Datadog and your new PagerDuty integration will be authorized. If you want to follow incidents, escalations and resolutions in Datadog, or correlate PagerDuty incidents with your metrics, enter your PagerDuty credentials and the schedules you are interested in.

  6. To test the integration, simply make a post with @pagerduty (i.e. @pagerduty Yay, this is my first Datadog alert.) in your newsfeed. This will create an incident in PagerDuty and will show up in your Datadog newsfeed.

  7. You can also ack or resolve the PagerDuty incident within DataDog by mentioning @pagerduty-acknowledge or @pagerduty-resolve.

    Note: You must add these mentions as a comment on the original post in your newsfeed. You can simply use these mentions, and/or you can add comments which will appear as part of the ack or resolve message in the PagerDuty incident log:


Is it possible to have a Datadog integration route alerts to multiple services?

Yes. In the PagerDuty integration configuration, you will find your existing integrated service along with its integration key. Below that, click Add row and you will be able to input another Datadog integration on another service.

You can then reference the second service under Notify your team in a Datadog monitor, to send alerts to the the other service specifically for that monitor.

You can also click the Click here button to use the same integration setup workflow as was used for the first integration.

I’m seeing events in my Datadog newsfeed from PagerDuty services which I did not select for the integration; how do I fix this?

By default, the Show all available PagerDuty incidents? option is selected in the PagerDuty integration settings within Datadog. If you only want to see events from the services you have defined in the Filter Events by Service setting, you should uncheck this option in your integration setup.