Datadog
Datadog provides monitoring alerts for custom metrics across systems, applications, and services. Install this integration to correlate your Datadog alerts into actionable incidents in BigPanda so you can find and fix problems in your infrastructure quicker and easier.
Supported Versions | Type | Authentication Type |
---|---|---|
SaaS Deployments | Webhook | Bearer Token |
Key Features
- Easily send all Datadog alerts to BigPanda with a native integration in Datadog
- Correlate alerts from Datadog Monitors to help you understand and respond faster to production issues.
How It Works
The integration works by configuring the native BigPanda integration in Datadog. The Datadog alerting pipeline will then send all alerts to BigPanda. BigPanda then processes and correlates the alert data from Datadog to create and maintain up-to-date incidents in BigPanda.
Data Model
BigPanda normalizes alert data from Datadog into tags. You can use tag values to filter the incident feed and to define filter conditions for Environments. The primary and secondary properties are also used during the correlation process.
Data Normalization
All properties from the Datadog alert are mapped 1:1 to tags on the BigPanda alert. The below chart describes some special properties of specific Datadog alert tags.
Tag | Description | Additional Info |
---|---|---|
| Host that triggered the alert. This tag is relevant only when a specific host is selected in the Datadog monitor definition. | |
| Name of the monitor in Datadog. | Alternate Primary Property (if |
| Metric that triggered the alert. This tag is relevant only when a specific metric is selected in the Datadog monitor definition. For example: • | Secondary Property. |
| Type of Datadog event. For example: • | Alternate Secondary Property (if |
| Query of the triggered monitor in Datadog. | |
| Description of the alert. This is the Datadog event message with markdown removed. | |
| Link to the Datadog event this alert represents. | |
| Last trigger time for this Datadog alert. | Parsed from the Datadog event message. |
| Link to related logs in Datadog, if they exist. | Parsed from the Datadog event message. |
| Link to the actual Datadog monitor that this alert is generated by. | Parsed from the Datadog event message. |
| Link to related processes in Datadog, if they exist. | Parsed from the Datadog event message. |
| Link to the related resource in Datadog, if it exists. | Parsed from the Datadog event message. |
| An array of tags on the Datadog monitor without associated keys (values only). | |
| All tags on the Datadog monitor which are in |
|
Statuses
BigPanda will automatically correlate a Datadog status into a BigPanda status that can be used to search and filter incidents.
Datadog Status | BigPanda Status |
---|---|
| Critical |
| Warning |
| Ok |
| Unknown |
Installing the Integration
In BigPanda
Administrators can install the integration by following the on-screen instructions in BigPanda. For more information, see Installing an Integration.
In Datadog
Once you've created the integration in BigPanda you can then finish setup via the BigPanda integration tile in the Datadog console.
If you do not wish to send all of your Datadog monitor alerts to BigPanda you can uncheck the Route All Monitor Events option of the BigPanda integration in Datadog and then manually add @bigpanda
to the notifications for each monitor you wish to send.
Uninstalling the Integration
You must delete the BigPanda integration from Datadog to stop sending alerts to BigPanda.
Prerequisites
Manually resolve any open incidents related to the integration to remove them from your incident feed. Optionally, remove any additional data in BigPanda. For example, modify or remove any Environments or AutoShare rules that reference the integration.
Procedure
- In Datadog, go to the BigPanda integration tile
- Under the Configuration tab click Uninstall Integration
Post-Requisites
Delete the Integration in BigPanda to remove the Datadog integration from your UI.
Upgrading an Existing Datadog Integration
If you are using an existing Datadog integration the best approach is to replace it with a completely new integration using the steps above: Installing the Integration
However if you have many monitors notifications already configured you may wish to keep using your existing Webhook integration. In that case you can follow the below steps:
- In Datadog, go to the Integrations Settings from the sidebar
- Locate your existing Webhook integration sending to BigPanda and click Configure
- Click Edit
- Change the URL to the following, replacing
BEARER_TOKEN
andAPP_KEY
with your BigPanda account bearer token and Datadog integration's app key respectively:
https://inbound.bigpanda.io/datadog/alerts?access_token=BEARER_TOKEN&app_key=APP_KEY
- Change the payload the following:
{
"host": "$HOSTNAME",
"title": "$EVENT_TITLE",
"alert_metric": "$ALERT_METRIC",
"alert_query": "$ALERT_QUERY",
"body": "$EVENT_MSG",
"body_clean": "$TEXT_ONLY_MSG",
"link": "$LINK",
"tags": "$TAGS",
"event_type": "$EVENT_TYPE",
"priority": "$PRIORITY",
"alert_status": "$ALERT_STATUS",
"alert_transition": "$ALERT_TRANSITION",
"last_updated": "$LAST_UPDATED",
"date": "$DATE",
"email": "$EMAIL",
"datadog_org_name": "$ORG_NAME",
"datadog_org_id": "$ORG_ID",
"id":"$ID",
"aggreg_key": "$AGGREG_KEY"
}
- Click Save
Updated about 1 month ago