Configuring Datadog Data Sources

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.

  1. 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.