Documentation is now available for the Fall 2020 Update release!

Datadog

Describes how to setup an integration to receive alerts from Datadog.

Leave Feedback

Introduction

Datadog is a monitoring service for cloud-scale applications, providing monitoring of servers, databases, tools, and services, through a SaaS-based data analytics platform.

OpsRamp configuration

Configuration involves the following:

  1. Installing the integration.
  2. Configuring the integration.

Step 1: Install the integration

To install:

  1. From All Clients, select a client.
  2. Go to Setup > Integrations > Integrations.
  3. From Available Integrations, select Monitoring > Datadog and click Install.
  4. Provide the following:
    • Name
    • IP address
    • Credentials. Select an existing credential or create a new credential.
  5. Click Save.

Step 2: Configure the integration

To configure the integration:

  1. From the API tab, provide the following:
    1. Authentication: Copy Tenant Id, Token and Webhook URL for configuration. These settings are used for creating a HTTP Request template.
    2. Map Attributes: Provide the mapping information for the third-party.
      1. Select the required OpsRamp property from the drop-down.
      2. Click Add Mapping Attributes to map attributes for the specific OpsRamp alert property.
      3. Provide the entity and property value.
  2. From the Monitoring of Integration tab, click Assign Templates.
    1. Select the IntgMonittool template.
    2. Click Assign Templates.
      Monitoring of Integrations

      Monitoring of Integrations

  3. From the Audit Logs, set up audit log criteria and time frame.

Property mappings

Property Mappings
Datadog PropertyOpsRamp Property
eventTitleAlert subject
eventDetailsAlert description
dateAlert time
eventAlertTypeAlert state
Datadog Property ValueOpsRamp Property Value
errorCritical
successOk
eventAlertMetricAlert metric
eventHostNameAlert resource name

Sample: Datadog Webhook payload

      
        {
        	"id": "4804742212344586948",
        	"eventTitle": "\[Triggered on {host:hydlpt110}\] \[TEST\] CPU load is high",
        	"eventType": "service\_check",
        	"evenAlertID": "8360816",
        	"eventAlertType": "error",
        	"eventHostName": "hydlpt110",
        	"eventAlertMetric": null,
        	"eventAlertTittle": "\[TEST\] CPU load is high on host:hydlpt110",
        	"date": "1550647818000",
        	"org": {
        		"id": "245725",
        		"name": "dev"
        	},
        	"eventDetails": {
        		"email": "",
        		"eventMsg": "%%%\\nPlease chcek @webhook-OR-webhook\\n\\nTest notification triggered by james096@gmail.com.\\n\\n\\n\\n\\n\\n- - -\\n\\n\[\[Monitor Status\](https://app.datadoghq.com/monitors#8360816?group=host%3Ahydlpt110)\] · \[\[Edit Monitor\](https://app.datadoghq.com/monitors#8360816/edit)\] · \[\[View hydlpt110\](https://app.datadoghq.com/infrastructure?filter=hydlpt110)\] · \[\[Show Processes\](https://app.datadoghq.com/process?sort=memory%2CASC&to\_ts=0&tags=host%3Ahydlpt110&from\_ts=-900000&live=false&showSummaryGraphs=true)\]\\n%%%",
        		"eventTxtMsg": "\\nPlease chcek @webhook-OR-webhook\\n\\nTest notification triggered by james096@gmail.com.\\n\\nMetric Graph: https://app.datadoghq.com/monitors#8360816?to\_ts=1550647878000&group=host%3Ahydlpt110&from\_ts=1550644218000 · Monitor Status: https://app.datadoghq.com/monitors#8360816?group=host%3Ahydlpt110 · Edit Monitor: https://app.datadoghq.com/monitors#8360816/edit · Event URL: https://app.datadoghq.com/event/event?id=4804742212344586948 · View hydlpt110: https://app.datadoghq.com/infrastructure?filter=hydlpt110",
        		"evenDatePost": "1550647818",
        		"eventAggregKey": "36adb48abb510bd80816c1f423f2a8f0",
        		"eventAlertStatys": "",
        		"eventUserName": "",
        		"eventSnaoShot": null,
        		"eventLink": "https://app.datadoghq.com/event/event?id=4804742212344586948",
        		"eventTags": "check:cpu,host:hydlpt110,monitor",
        		"eventLastUpdatedPosix": "1550647818",
        		"eventAlertQuery": "\\"datadog.agent.check\_status\\".over(\\"check:cpu\\").by(\\"host\\").last(2).count\_by\_status()",
        		"eventAlertScope": "host:hydlpt110",
        		"eventAlertCycleKey": "4804731423302266881",
        		"last\_updated": "1550647818000"
        	}
        }

Datadog configuration

Configurations in Datadog involve:

  1. Configuring Webhook.
    Webhook allows you to connect with OpsRamp and alert OpsRamp when an event is triggered.
  2. Enabling notification for monitoring.
    Notifications allow you to notify OpsRamp about an event.

Step 1: Configure Webhook

To configure Webhook:

  1. Log into Datadog.
  2. Click the Integrations icon and click Integrations.
  3. Configure Webhook and click Update Configuration to save the details.
    Webhook Configuration

    Webhook Configuration

    1. Name: Provide a name for Webhook. For example: OpsRamp-Alerts)
    2. URL: Provide the Webhook URL copied from OpsRamp.
      For example: https://<api-url>/integrations/alertsWebhook/client_1/alerts?vtoken=bOvr34Kh3Jm3eVJkmfBND7uJ9gyF72bL
    3. Use custom payload: Select the custom payload option.
    4. Custom payload: Provide the below payload
    5. Encode as form: Not Applicable.
    6. Header: Not Applicable.
Name and URL for Webhook Configuration

Name and URL for Webhook Configuration

Custom payload syntax

{
    "id": "$ID",
    "eventTitle": "$EVENT\_TITLE",
    "eventType": "$EVENT\_TYPE",
    "evenAlertID": "$ALERT\_ID",
    "eventAlertType": "$ALERT\_TYPE",
    "eventHostName": "$HOSTNAME",
    "eventAlertMetric": "$ALERT\_METRIC",
    "eventAlertTittle": "$ALERT\_TITLE",
    "date": "$DATE",
    "org": {
        "id": "$ORG\_ID",
        "name": "$ORG\_NAME"
        },
    "eventDetails": {
        "email": "$EMAIL",
        "eventMsg": "$EVENT\_MSG",
        "eventTxtMsg": "$TEXT\_ONLY\_MSG",
        "evenDatePost": "$DATE\_POSIX",
        "eventAggregKey": "$AGGREG\_KEY",
        "eventAlertStatys": "$ALERT\_STATUS",
        "eventUserName": "$USERNAME",
        "eventSnaoShot": "$SNAPSHOT",
        "eventLink": "$LINK",
        "eventTags": "$TAGS",
        "eventLastUpdatedPosix": "$LAST\_UPDATED\_POSIX",
        "eventAlertQuery": "$ALERT\_QUERY",
        "eventAlertScope": "$ALERT\_SCOPE",
        "eventAlertCycleKey": "$ALERT\_CYCLE\_KEY",
        "last\_updated": "$LAST\_UPDATED"
        }
}

Step 2: Enable notifications

To enable the notifications for monitoring:

  1. Click the Select Monitor icon and click Manage Monitors.
  2. Select the monitor that you want to enable the integration to OpsRamp and edit the settings.
  3. In the Notify your team section, type @ to see the available list of Webhooks to trigger.
  4. Select the configured Webhook and specify notifications and restrictions for notification.
Datadog Notifications

Datadog Notifications