Datadog Logo

Datadog Integration Guide

Datadog is a popular SaaS monitoring platform for cloud-scale applications. It allows organizations to monitor their servers, databases, tools, and services. It triggers alerts when certain metrics go outside of their desired ranges. TaskCall's Datadog integration creates an effective channel to make these alerts more visible and help responders focus on resolving the issues triggering them.

Pointers
  • The integration is between a TaskCall service and Datadog.
  • Incidents will automatically resolve in TaskCall when metrics fall back within the normal threshold.
  • This integration only supports alerts to be received from Datadog to TaskCall.
In TaskCall
  1. Go to Configurations > Services . Select the service you want to integrate with.
  2. Once you are on the Service details page, go to the Integrations tab. Click on New Integration.
  3. Give the integration a name.
  4. From the integration types, select the top radio button indiciating that you are trying to use a built-in integration.
  5. From the list of built-in integrations, select Datadog.
  6. Click Save.
  7. Copy the Integration Url that is issued for the integration.
In Datadog
  1. Go to Integrations > Integrations.
  2. Find Webhooks and click on it.

    Datadog Integration Step 1
  3. Click on the New Webhook button.
  4. Give it a name and paste the Integration Url you copied over from TaskCall.
  5. Paste the following in the Payload section:

    {
         "body": "$EVENT_MSG",
         "last_updated": "$LAST_UPDATED",
         "event_type": "$EVENT_TYPE",
         "title": "$EVENT_TITLE",
         "date": "$DATE",
         "org": {
             "id": "$ORG_ID",
             "name": "$ORG_NAME"
         },
         "id": "$ID",
         "aggreg_key": "$AGGREG_KEY",
         "alert": {
             "cycle_key": "$ALERT_CYCLE_KEY",
             "id": "$ALERT_ID",
             "metric": "$ALERT_METRIC",
             "scope": "$ALERT_SCOPE",
             "status": "$ALERT_STATUS",
             "title": "$ALERT_TITLE",
             "transition": "$ALERT_TRANSITION",
             "type": "$ALERT_TYPE"
         },
         "user": "$USER",
         "username": "$USERNAME",
         "priority": "$PRIORITY",
         "text_msg": "$TEXT_ONLY_MSG",
         "tags": "$TAGS",
         "snapshot": "$SNAPSHOT",
         "link": "$LINK"
    }


  6. Once the details have been entered, click Save .

    Datadog Integration Step 2
To test the integration, make a post with @webhook-{integration-name} (e.g. @webhook-{integration-name} Test alert from Datadog!) in the "Events" page. This will create an incident in TaskCall. (Replace {integration-name} with the name that you entered for the webhook integration)
On this page