Datadog Integration Guide

Datadog Integration

Datadog is a monitoring service for cloud-scale applications, bringing together data from servers, databases, tools, and services to present a unified view of an entire stack.

How Datadog users benefit from PagerTree

Datadog triggers user defined alerts by monitoring services and applications. PagerTree acts as the dispatcher for these alerts, determining the right people to notify based on on-call schedules. PagerTree notifies them via email, sms, voice, and/or push notifications until the incident is acknowledged or closed.

Functionality of Integration

The Datadog integration is one-way, meaning:

  • When a monitor alert is triggered (ALERT_TRANSITION == "Triggered") in Datadog, an incident is created in PagerTree automatically.
  • When a monitor alert is resolved (ALERT_TRANSITION == "Recovered") in Datadog, the incident is resolved in PagerTree automatically.

Tutorial Overview

In this integration tutorial we will show you how to send alerts from Datadog into PagerTree. The estimated time for this integration is 15 minutes. We assume that you already have a PagerTree and Datadog account setup.

In PagerTree

  1. Click the team you wish to add the integration to. Select Team
  2. On the team page, click the “Integrations” tab. Click Integrations Tab
  3. On the “Integrations” tab, click the “+ Integration” button. Click Plus Integration Button
  4. In the “Create Integration” box, fill out the following:
    1. Name of the Integration,
    2. Select the Integration Type to Datadog
    3. Select an appropriate urgency for when this integration is triggered
    4. Select the team member the incident will be created by (example: manager or team lead)
    5. Select the team this incident will be assigned to Click Create
  5. Click “Create”
  6. Copy the WebHook URL Copy Webhook URL

In Datadog

Create the Integration
  1. Click Menu -> Integrations -> Integration Click Menu -> Integrations -> Integration
  2. Type “webhook” in the search bar, then click “+Available” Search webhook
  3. Click the “Configuration” tab Click configuration tab
  4. Scroll to the bottom and enter in the following values
    1. Name – Give you integration an appropriate name (e.g. “pt_retail_team_integration”)
    2. URL – Paste the PagerTree WebHook URL you copied
    3. Check “Use custom payload”
    4. Copy & Paste the following
       {
      "ID": "$ID",
      "EVENT_TITLE": "$EVENT_TITLE",
      "TEXT_ONLY_MSG": "$TEXT_ONLY_MSG",
      "EVENT_TYPE": "$EVENT_TYPE",
      "LAST_UPDATED": "$LAST_UPDATED",
      "AGGREG_KEY": "$AGGREG_KEY",
      "DATE": "$DATE",
      "USER": "$USER",
      "SNAPSHOT": "$SNAPSHOT",
      "LINK": "$LINK",
      "PRIORITY": "$PRIORITY",
      "TAGS": "$TAGS",
      "ALERT_ID": "$ALERT_ID",
      "ALERT_TITLE": "$ALERT_TITLE",
      "ALERT_METRIC": "$ALERT_METRIC",
      "ALERT_SCOPE": "$ALERT_SCOPE",
      "ALERT_QUERY": "$ALERT_QUERY",
      "ALERT_STATUS": "$ALERT_STATUS",
      "ALERT_TRANSITION": "$ALERT_TRANSITION"
        }
      
  5. Click “Install Integration” Configure and install integration
  6. Click outside the modal to exit
Attach the Integration to a Monitor

Its necessary the integration be attached to a monitor. The monitor will create an alert that is sent to PagerTree. In this example we actually create a new monitor, but you could just as easily attach it to an existing monitor.

  1. Click Menu -> Monitors -> New Monitor Create new monitor
  2. Click the appropriate monitor type for your scenario (e.g. “Host”) select-monitor-type
  3. Enter in appropriate monitor values for your situation
    1. Under the “Notify your team” section
      1. Select the Webhook Integration you just created (e.g. @webhook-pt_retail_team_integration) Configure Monitor
  4. Click “Save”

You have successfully completed the Datadog Integration. Now when Datadog creates an alert, PagerTree will create an incident and route it to the correct team member that is on-call. If you have any questions please contact support@pagertree.com