---
title: "Configuring Datadog Data Sources"
canonical: "https://ai-docs.certero.com/space/CXCM/230490125/Configuring%20Datadog%20Data%20Sources"
format: markdown
---
This guide explains how to connect your Datadog account to CerteroX for cost management. The integration uses the Datadog Usage Metering API to collect cost data across your Datadog products and services.

> **Important:** Cost data collection requires a **parent-level** Datadog organization on a **Pro or Enterprise plan**. Child organizations and free/trial accounts cannot access cost APIs.

---

## Step 1: Create an API Key

An API key is required for CerteroX to authenticate with the Datadog API.

1. Sign in to your Datadog account.
2. Click your **username or avatar** in the bottom-left corner of the sidebar, then select **Organization Settings**.
3. In the left menu, click **API Keys**.
4. Click **+ New Key**.
5. Enter a name for the key (e.g. `CerteroX`).
6. Click **Create Key**.
7. Copy the **API Key** value for use later.

> **Important:** The API key value is only shown once at creation time. Copy it before navigating away.

---

## Step 2: Create an Application Key

An application key is required alongside the API key. The application key controls the permissions available to the integration.

1. From within **Organization Settings** (click your **username or avatar** in the bottom-left corner of the sidebar if you have navigated away), click **Application Keys** in the left menu.
2. Click **+ New Key**.
3. Enter a name for the key (e.g. `CerteroX`).
4. Click **Create Key**.
5. Copy the **Application Key** value for use later.

The application key must belong to a user (or service account) with permissions to read usage and billing data. The required scopes are:

| Scope | Purpose |
| --- | --- |
| **usage_read** | Read usage metering data |
| **billing_read** | Read billing and cost data |

> **Note:** If your organization uses Datadog service accounts, consider creating a dedicated service account for CerteroX with only these scopes assigned.

---

## Step 3: Identify Your Datadog Site

Datadog operates across multiple regional sites. You need to provide the correct site domain for your account.

You can determine your site by looking at the URL in your browser when logged into Datadog. For example, if your Datadog URL is `https://app.datadoghq.com`, your site is `datadoghq.com`. If it is `https://app.datadoghq.eu`, your site is `datadoghq.eu`.

| Site | Domain | Region |
| --- | --- | --- |
| US1 | `datadoghq.com` | US (Virginia) |
| US3 | `us3.datadoghq.com` | US (Virginia) |
| US5 | `us5.datadoghq.com` | US (Oregon) |
| EU1 | `datadoghq.eu` | EU (Frankfurt) |
| AP1 | `ap1.datadoghq.com` | Asia-Pacific (Tokyo) |
| US1-FED | `ddog-gov.com` | US GovCloud |

---

## Step 4: Create the Datadog Data Source in CerteroX

1. Log in to CerteroX and navigate to **Settings** > **Data Sources**.
2. Click **Actions** and select **Add**.
3. Select **Datadog**.
4. Fill in the following fields:

| Field | Required | Description |
| --- | --- | --- |
| **Name** | Yes | A meaningful name to identify this data source (e.g. "Datadog Production"). |
| **Datadog site** | No | Your Datadog site domain from Step 3. Defaults to `datadoghq.com` if not set. |
| **API Key** | Yes | The API key created in Step 1. |
| **Application Key** | Yes | The Application key created in Step 2. |

5. Click the **Connect** button.

---

## Step 5: Verify the Connection

1. Return to **Settings** > **Data Sources** in CerteroX.
2. Click on your Datadog data source.
3. Check the **Status** indicator — it should show as connected.
4. Navigate to the **Advanced** tab to view detailed data ingestion information.

> **Note:** Initial cost data may take up to one hour to appear while CerteroX queries and processes your Datadog usage data. CerteroX collects both finalised historical costs and estimated costs for the current billing period.

---

## What Data is Collected

CerteroX uses the Datadog Usage Metering API to collect cost data, including:

- **Historical costs** — finalised costs for previous billing months, broken down by product (e.g. Infrastructure Hosts, APM, Logs, Synthetics, etc.).
- **Estimated costs** — projected costs for the current billing period.

Costs are broken down per Datadog product and charge type, allowing visibility into which services are driving spend. Where available, data is collected at the sub-organization level for multi-org accounts.

---

## Troubleshooting

| Error | Cause | Resolution |
| --- | --- | --- |
| Invalid API key or Application key | Incorrect or revoked keys | Verify the API key and Application key in **Organization Settings**. |
| Cost data APIs are not accessible | Account is a child organization, or on a free/trial plan | Ensure you are connecting a **parent-level** organization on a **Pro or Enterprise** plan. |
| No organizations found | API key does not belong to any organization | Check the API key is valid and associated with an active Datadog organization. |