Skip to main content
Vantage uses a read-only (scoped to billing_read) Datadog OAuth token. This token is used to pull data from the usage metering endpoint. The usage metering API provides hourly, daily, and monthly usage across multiple facets of Datadog. This API is available to all Pro and Enterprise customers. For Datadog business metrics, Vantage also requires the metrics_read and timeseries_query scopes.
Usage is only accessible for parent-level organizations.
For documentation about connecting to Vantage from Datadog, see the Vantage Integration page in Datadog’s documentation.

​
Connect Your Datadog Account

​
Prerequisites

  • You must have a Vantage Organization Owner or Integration Owner role to add or remove this integration. See the Role-Based Access Control documentation for details.
  • When connecting your Datadog account, your user will need access to the usage_read and billing_read scopes to complete the connection. Vantage also requests the metrics_read and timeseries_query scopes for importing Datadog business metrics. See the Datadog documentation for more information on roles.
  • Create a free Vantage account, then follow the steps below to integrate Datadog costs.

​
Create the Connection

1
From the Vantage console, navigate to the Integrations page.
2
Select Datadog and add a connection.
3
You will be brought to the Datadog login screen and guided through the Datadog OAuth flow for adding your Datadog account.
After authorizing the connection with Vantage, you will see the status of your connection change to Importing within the Vantage console. This status indicates that Vantage is actively importing your Datadog cost data. See the Integration Status documentation for details on integration statuses.
Once connected, Vantage will ingest six months of historical Datadog costs.

​
Next Steps - Manage Workspace Access

Once the import is complete and the integration status changes to Stable, you can select which workspaces this integration is associated with. See the Workspaces documentation for information.

​
Data Refresh

See the provider data refresh documentation for information on when data for each provider refreshes in Vantage.

​
Update the Datadog Integration

Sometimes an update is required to use new Vantage features related to Datadog. Navigate to the Manage Integration page for your Datadog integration. If you need to update the integration, the Update Required button is displayed in the Status column. Click the button to access the OAuth integration workflow and reconnect your integration.
Update button for an out-of-date Datadog integration

​
Datadog Reporting Dimensions

Within Cost Reports, Vantage will show cost data for at least the following services.
  • APM
  • Application Security Monitoring
  • Audit Trail
  • CI Visibility
  • CSPM
  • Database Monitoring
  • Incident Management
  • Infrastructure
  • Log Management
  • Network Monitoring
  • Observability pipelines
  • RUM
  • Sensitive Data Scanner
  • Serverless Monitoring
  • Synthetic Monitoring
  • Workload Security
The following Cost Report filters are available for Datadog:
  • Organization
  • Category
  • Tag/Not Tagged (see the section below)
  • Subcategory
  • Service
At the Category and Subcategory levels, you can access information such as how much Datadog spend is covered by committed-use discounts or which individual Datadog container is contributing to overall Logging costs.

​
Datadog Cost Tags (Usage Attribution Tags)

This feature is only available if you have a Datadog Enterprise plan with usage tags enabled.
You can have up to three tag keys per organization enabled for usage attribution in Datadog. Once enabled, Datadog begins breaking down the usage by any number of tag values for these keys. This allows you to see usage for specific services allocated to a specific key/value pair. The following Datadog services support Datadog cost tags:
  • APM
  • Container Services
  • CI Pipeline
  • Fargate
  • Infrastructure Hosts
  • Invocations
  • Lambda
  • Logs
  • NPM
  • Spans
  • Synthetic Tests
  • Time Series
To use these tags within Vantage:
1
Open any Cost Report.
2
Click Filters, and select Datadog for the provider.
3
Click New Rule > Tag.
You can also Group By a specific tag key on a Datadog Cost Report. The following filter operators are supported:
  • Tagged with key
  • Tagged with Key where the value: is, is not, contains, does not contain
  • Not Tagged
  • Not Tagged with Key
If you just applied your first Datadog tag key and value, it can take up to 48 hours for the tag to appear in Vantage. Tags are not applied retroactively.

​
Usage-Based Cost Allocation

Vantage assigns Datadog cost to tags using usage data from Datadog’s usage attribution API. For each cost category (e.g., logs_ingested), Vantage matches the cost to a corresponding usage key in your usage attribution export and splits the cost across tag values based on each value’s share of usage.
Vantage tries several usage keys and patterns when matching cost categories to usage data, so when your usage is tagged (e.g., by team), that data is used to split the cost. As a result, more cost appears under the correct tags and less is left as untagged, giving you better visibility by team and other dimensions in Cost Reports and Virtual Tags without changing your total Datadog spend.
Because Vantage allocates cost using usage-level tag data, you may see differences when comparing against Datadog’s own “cost by tag” exports, which may only attribute cost where the cost itself is directly tagged. This difference is methodological—total spend remains the same, but Vantage may attribute more cost to named tags and show less as untagged.

​
Datadog Pricing in Vantage

For certain services, Datadog prices based on the 95th to 99th percentile (p95/p99) of usage rather than daily usage. For example, APM is billed on the 99th percentile of the number of hosts you have running at any given time. In Vantage, Datadog costs are realized on the first day of the month. As the month progresses, you might notice that costs retroactively increase or decrease based on your usage. Because these costs are always realized on the first of the month, when you compare previous periods for services that price on the p95/p99 of usage, you’ll always have the same comparison dates. For services that do not price on p95/p99, Vantage shows costs realized per day, when the accompanying usage data is available. In the below visual example, a Cost Report is filtered to all Datadog costs. The date grouping is set to Daily. If you select a service row in the table, that service is isolated on the graph, and you can see how the service is priced. In this example, Log Management has accrual data and prices daily; whereas, Containers is priced based on the p95/p99 of usage, and costs are realized on the first of the month.
GIF selecting different Datadog services. When Log Management is selected, costs are displayed for the whole month. When Containers is selected, costs are displayed on the first of the month.

​
Reporting Dimensions

On Datadog Cost Reports, you can filter across several dimensions:
  • Organization (organization name)
  • Category (e.g., APM ingested spans)
  • Tag/Not Tagged (includes Datadog tags and virtual tags created in Vantage for this provider). The following additional tag is available for filtering and grouping:
    • datadog:organization:name: The human-readable organization name associated with the cost, allowing you to filter and group multi-org Datadog costs by organization name.
  • Subcategory (e.g., Commitment or On Demand)
  • Charge Type (e.g., Usage)
  • Service (e.g., Database Monitoring)

​
View Datadog Metrics on Cost Reports

You can import Datadog metrics as business metrics to view alongside Cost Reports. See the Per Unit Costs documentation for more information.

​
Datadog Host Costs

For cloud resources that have the Datadog agent installed, Vantage can associate Datadog per-host fees along with the primary cloud resources from AWS, Azure, and Google Cloud that drive those costs. See the Active Resources documentation for details on how to view these costs.