Usage Attribution


Usage Attribution is an advanced feature included in the Enterprise plan. For all other plans, contact your account representative or to request this feature.

Administrators can access the Usage Attribution tab from the Plan & Usage section in Datadog. The Usage Attribution page provides the following information and functionality:

  • Lists the existing tag keys that usage is being broken down by and provides the ability to change and add new ones (up to three tag keys).
  • Generates daily tab separated values (TSV) files for most usage types.
  • Summarizes usage at the end of each month.
  • Surfaces the data both in the UI and as a TSV download.

This feature does not support product usage that cannot be tagged during instrumentation. For example, Incident Management Users and Parallel Testing Slots.

Getting started

To start receiving daily data, an administrator needs to create a new report with the user interface.

Getting Started with Usage Attribution in Datadog

The Applied Tags section enables the following:

  • Entering up to three tag keys from a dropdown. The dropdown is pre-populated with existing tags on both the root account and any child organizations under the account.
  • Deleting and editing existing tags.
Applied tags in Datadog
  • Once the tags are configured, it takes a full 24-hour period for the first report to be generated.
  • The reports are generated on an ongoing basis.
  • If tags are changed, the new report reflects the new tags. However, the previous reports keep the old tags.
  • Monthly reports reflect the latest set of tags. If you change tags mid-month, the usage percentages might not match up.

Total usage

Monthly usage attribution

Once the reports start to be generated, they are updated daily and aggregated monthly in this table.

Applied tags in Datadog
  • Data is shown by all tag keys selected e.g. by app and service.
  • Data can be shown by specific organization or tag keys by querying on the left-side dropdown.
  • Value and Percentage options are available for table display.
  • Data shown on the table can be edited to include select products.
Usage Attribution options dropdown menu
  • If multi-org is enabled, usage is summarized across all Datadog organizations at the parent account.
  • Previous months’ reports are accessible through the time selector.
  • Monthly reports are not generated until the month is over. Each monthly report should appear by the second day of the following month.
  • Reports are downloadable in TSV format. These TSV reports include both usage numbers and percentages, allowing for simplified allocations and chargebacks. Percentages are calculated on a per-organization basis.

Monthly data can also be pulled using the tool’s public API. For more information, see the API endpoint documentation.

Hourly usage attribution

Hourly data can be pulled using the tool’s public API. For more information, see the API endpoint documentation.

Interpreting the data

The table below shows a sample daily report for Infra usage by two tags: app and service.

publicid12022-03-31 00:00:00<empty>service1 | service250
publicid12022-03-31 09:00:00app128
publicid12022-03-31 18:00:00app2service31023
  • An <empty> value means the resource was tagged with the respective tag but did not have a value.
  • No value means the resource was not tagged with that particular tag.
  • | (pipe) separated values (for example, service1 | service2) mean that a particular tag was applied multiple times on the resource.
  • A valid tag value (see the Defining Tags documentation) refers to the actual value of the respective tag.

Further data analysis

When using multiple tags, both the Hourly and Monthly Usage Attribution reports contain data for all possible combinations of those tags, and are suitable to use as base datasets for further data analysis tasks. For instance, you can use grouping or pivoting to produce views focused on a subset of the tags, or to perform aggregations across custom date ranges.

Tracking usage

  • Data can be shown by specific product(s), organization, or tag keys by editing the search queries below Usage Attribution Trends.
  • Data can be shown at a daily, weekly, or monthly level.
Infra Hosts graphs separated by tags

Interpreting the data

For each product, graphs are displayed by tags.

Infra Hosts and Custom Metrics graphs separated by tags

Each color block represents a unique tag value for each tag.

A breakdown of a pillar in the Infra Hosts graph

Further Reading

Additional helpful documentation, links, and articles: