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
- From the navigation menu, click the “+ Integration” button.
- In the “Create Integration” box, fill out the following:
- Name of the Integration,
- Select the Integration Type to Datadog
- Select an appropriate urgency for when this integration is triggered
- Select the team this incident will be assigned to
- Click “Create”
- Copy the Endpoint URL
In Datadog
Create the Integration
- Click Menu -> Integrations -> Integration
- Type “webhook” in the search bar, then click “+Available”
- Click the “Configuration” tab
- Scroll to the bottom and enter in the following values
- Name – Give you integration an appropriate name (e.g. “pt_retail_team_integration”)
- URL – Paste the PagerTree Endpoint URL you copied
- Check “Use custom payload”
- 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" }
- Click “Install Integration”
- 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.
- Click Menu -> Monitors -> New Monitor
- Click the appropriate monitor type for your scenario (e.g. “Host”)
- Enter in appropriate monitor values for your situation
- Under the “Notify your team” section
- Select the Webhook Integration you just created (e.g. @webhook-pt_retail_team_integration)
- Select the Webhook Integration you just created (e.g. @webhook-pt_retail_team_integration)
- Under the “Notify your team” section
- 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