---
title: "Datadog integration"
description: "Learn how to integrate CircleCI with Datadog for monitoring and observability."
platform: "Cloud, Server"
doc_version: "Server"
last_updated: "2026-10-07"
---

> For current CircleCI product defaults, deprecated patterns, and Cloud/Server differences, see [AGENTS.md](https://circleci.com/docs/AGENTS.md).
>
> For the complete documentation index and site structure, see [llms.txt](https://circleci.com/docs/llms.txt).

# Datadog integration

This page describes how to connect Insights data with [Datadog](https://www.datadoghq.com/).

## Overview

The [Datadog CircleCI integration](https://docs.datadoghq.com/integrations/circleci/) allows you to visualize and analyze data about your CircleCI jobs within Datadog.

## Integration

Complete the following steps to set up a CircleCI webhook to forward your logs to Datadog.

1.  Log in to the CircleCI web app.
    
2.  Access one of your CircleCI projects.
    
3.  Open **Project settings**.
    
4.  In the project settings sidebar, click **Webhooks**.
    
5.  Select **Add webhook**.
    
6.  Complete the following fields:
    
    *   **Webhook name**: `Datadog CI Visibility` or any other identifier name that you want to provide.
        
    *   **Receiver URL**: `https://webhook-intake.datadoghq.com/api/v2/webhook/?dd-api-key=<API_KEY>` where `<API_KEY>` is your [Datadog API key](https://app.datadoghq.com/account/login).
        
    *   **Events**: Select **Workflow Completed** and **Job Completed**.
        
    *   Enable the check: **Certificate verifications**.
        
    
7.  Select **Add Webhook** to save the new webhook.
    

Webhook payload may be different depending on the integration used by the pipeline that emits the webhook. Check out the [Sample Webhook Payloads](https://circleci.com/docs/reference/outbound-webhooks-reference/#sample-webhook-payloads) for each integration for more information.

### Visualize pipeline data in Datadog

Sign in to [Datadog](https://app.datadoghq.com/account/login) and visit the Pipelines and Pipeline Executions pages to see data populate after workflows finish.

The Pipelines page will only show data for the default branch of each repository.