---
title: "Datadog Integration Guide (Alerts)"
slug: "datadog-integration-guide-alerts"
updated: 2025-07-25T09:10:26Z
published: 2025-07-25T09:10:26Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.catchpoint.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Datadog Integration Guide (Alerts)

## Basic tool information

Datadog is an analytics platform that can aggregate data from servers, databases, applications, tools and services into a unified view for monitoring.

Connect Catchpoint and Datadog to:

- **Configure comprehensive alerts in your event stream**
- **Direct links to Analysis Charts in the Catchpoint Portal**
- **Alert Type tags for easy filtering**

This document outlines the steps to integrate Catchpoint and Datadog using Catchpoint’s Alert Push API.

For more information, go to [https://www.datadoghq.com](https://www.datadoghq.com/) and[http://docs.datadoghq.com/integrations/catchpoint](http://docs.datadoghq.com/integrations/catchpoint/)

## Catchpoint Integration

Catchpoint’s Alert Push API allows Catchpoint to integrate with other tools by pushing data when a test triggers an alert. Any tool supporting Webhooks or providing a URL to POST data can be used. Alert Push API templates can be customized to fit a tool’s format and content-type using Macros. If a template needs modification, please contact Catchpoint Support. We are happy to assist you increating a template meeting your requirements. Below, you will find integration guide on setting upand customizing templates. These guides are standard workflows created by Catchpoint focused oncreating and confirming an API template to be consumed by this tool. Catchpoint does its best to ensure the relevance of these guides and will be happy to assist in implementing a guide as described.

## Catchpoint - Datadog Integration Steps

### Webtool Setup

1. Log in into the Catchpoint Portal and go to **Integrations**.
2. In the **Webhook** select **AddURL>Alertwebhook**.  

![image.png](https://cdn.document360.io/cb4af8f9-6751-4fd2-b39c-07aae832badb/Images/Documentation/image%28489%29.png)
3. Enter the Datadog Endpoint URL. You will also need the Datadog API Key which can be created in the Datadog portal.
4. Set **Status** to **Active**
5. Select **Template** for **Format**
6. Add a new template
7. Enter the template **Name** e.g. "Datadog", and set the **Format** to **JSON**.
8. Paste the following JSON template and then **Save**.

```
{
    "title": "${TestName} [${TestId}] - ${switch(${notificationLevelId},'0','WARNING','1','CRITICAL','3','OK')}",
    "text": "${TestName} - http://portal.catchpoint.com/ui/Content/Charts/Performance.aspx?tList=${testId}&uts=${ alertProcessingTimestampUtc}&z=&chartView=1",
    "priority": "normal",
    "tags": ["alertType:${Switch(${AlertTypeId},'0', 'Unknown','2', 'Byte Length','3','Content Match','4', 'Host Failure','7' , 'Timing','9', 'Test Failure', '10',Insight', '11','Javascript Failure', '12', 'Ping',13, 'Requests')}"],
    "alert_type": "${switch(${notificationLevelId},'0','warning','1','error','3','success')
}",
"source_type_name": "catchpoint"
```

![image.png](https://cdn.document360.io/cb4af8f9-6751-4fd2-b39c-07aae832badb/Images/Documentation/image%28490%29.png)

Catchpoint will now send any alerts directly to the Events stream in Datadog.

![](https://cdn.document360.io/cb4af8f9-6751-4fd2-b39c-07aae832badb/Images/Documentation/115017969326-mceclip4.png) Alert Macro Index A full list of the Alert API Macros can be found at:

[https://docs.catchpoint.com/docs/Alert-API-Macros](https://docs.catchpoint.com/docs/Alert-API-Macros)