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.
Sign in to your Datadog account.
Click your username or avatar in the bottom-left corner of the sidebar, then select Organization Settings.
In the left menu, click API Keys.
Click + New Key.
Enter a name for the key (e.g. CerteroX).
Click Create Key.
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.
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.
Click + New Key.
Enter a name for the key (e.g. CerteroX).
Click Create Key.
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 |
|---|
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 |
|---|
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
Log in to CerteroX and navigate to Settings > Data Sources.
Click Actions and select Add.
Select Datadog.
Fill in the following fields:
Field | Required | Description |
|---|
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. |
Click the Connect button.
Step 5: Verify the Connection
Return to Settings > Data Sources in CerteroX.
Click on your Datadog data source.
Check the Status indicator — it should show as connected.
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 |
|---|
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. |