Datadog

Company	Estimated Time	Vendor Docs	Open Source
Datadog	5 minutes	view	v3.rb

What is Datadog?

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 It Works

Datadog triggers user defined alerts by monitoring services and applications.

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

Integration Walkthrough

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

In PagerTree

1. Create the integration by clicking the Datadog logo.
2. Copy the Endpoint URL.

In Datadog

Create the Integration

1. Click Menu -> Integrations -> Integration.

   

   Navigate to Integrations

2. Type “webhook” in the search bar, then click “+Available”.

   

   Search for the webhook integration.

3. Click the “Configuration” tab.

   

   Click the configuration tab for the webhook integration.

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 Endpoint URL you copied
   3. Check “Use custom payload”
   4. Copy & Paste the following

datadog_payload.json

{
  "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"
}

1. Click “Install Integration”.

   

   Datadog PagerTree Integration Configuration

2. 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.

   

   Navigate to new monitor

2. Click the appropriate monitor type for your scenario (e.g. “Host”).

   

   Select the host 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)

         

         Notify PagerTree when monitor in Datadog fails.

4. Click “Save”.

---

You have successfully completed the Datadog Integration.

---