Overview

Administrators can access the Usage page by hovering over their username at the bottom left, then navigate to: Plan & Usage–> Usage.

The Usage page shows usage grouped by product category. You can navigate to a product tab to view usage specific to that product category or the “All” tab to view usage for all products. Each tab provides the following information:

  • Month-to-Date Summary
  • Overall Usage (current and historical)

Certain product tabs also contain additional tools:

  • Custom Metrics Tab: Top Custom Metrics
  • Log Management Tab: Logs Usage by Index

Month-to-date summary

This section summarizes your month-to-date usage. In the “All” tab, view your month-to-date usage of infrastructure hosts, containers, custom metrics, APM hosts, logs, and any other part of the platform you’ve used during the month.

Usage Summary - All tab

In product specific tabs, view your month-to-date usage of the products in that product category.

Usage Summary - Network

The month-to-date usage shown above is “All” usage, which includes non-billable usage such as product trials. Most accounts are able to view “Billable” usage, which only shows usage that contributes to your final bill. The “Billable” view breaks out on-demand usage above your commitments and allocations.

Usage Summary - Billable
For API users, endpoints are available to access “All” usage and “Billable” usage.

Month-to-date usage of each product is calculated as follows:

ProductDescription
Infra. HostsShows the 99th percentile of all distinct infrastructure hosts over all hours in the current month.
ContainersShows the high watermark of all distinct containers over all hours in the current month.
APM HostsShows the 99th percentile of all distinct APM hosts over all hours in the current month.
Profiled HostsShows the 99th percentile of all distinct profiled hosts over all hours in the current month.
Profiled ContainersShows the average of all distinct profiled containers over all hours in the current month.
Custom MetricsShows the average number of distinct custom metrics over all hours in the current month.
Ingested Custom MetricsShows the average number of distinct INGESTED custom metrics over all hours in the current month.
Ingested LogsShows the sum of all log bytes ingested over all hours in the current month.
Indexed LogsShows the sum of all log events indexed over all hours in the current month.
Scanned LogsShows the sum of all log bytes scanned by Sensitive Data Scanner over all hours in the current month.
Ingested SpansShows the sum of all spans ingested over all hours in the current month.
Indexed SpansShows the sum of all Indexed Spans indexed over all hours in the current month.
Analyzed Logs (Security)Shows the sum of all analyzed log bytes ingested over all hours in the current month.
Serverless FunctionsShows the average of the number of functions that are executed 1 or more times each hour in the current month.
Serverless InvocationsShows the sum of all invocations over all hours in the current month.
Fargate TasksShows the sum of all Fargate tasks over all hours in the current month.
Network HostsShows the 99th percentile of all distinct Network hosts over all hours in the current month.
Network FlowsShows the sum of all Network flows indexed over all hours in the current month.
Network DevicesShows the 99th percentile of all distinct Network devices over all hours in the current month.
Synthetic API TestsShows the sum of all Synthetic API tests over all hours in the current month.
Synthetic Browser TestsShows the sum of all Synthetic browser tests over all hours in the current month.
RUM SessionsShows the sum of all distinct RUM sessions over all hours in the current month.
Incident ManagementShows number of unique active users to date in the selected month who interacted with incident lifecycle and timelines.
IoT DevicesShows the 99th percentile of all distinct IoT devices over all hours in the current month.

The Usage Trends section contains product usage graphs displaying summed usage for all organizations across an account. Usage reports are downloadable through the Download as CSV button. For each organization, these reports include an hourly breakdown of usage by product.

Usage Trends graphs page in the Datadog application with Download as CSV option highlighted

For products with subtypes, each category is distinguished on the graph for that product.

Usage summary with infrastructure tab selected and multiple graphs for infrastructure usage subtypes such as infra hosts, agent hosts, and containers

More detailed product subtype graphs can be found on each product’s tab. For example, a breakdown by host type is available on the Infrastructure tab.

Usage trends section of the Infrastructure tab with Infra Hosts graph containing Agent hosts and AWS hosts, Indexed Logs graph containing Daily Indexed Live Logs and Cumulative Indexed Live Logs

Cumulative usage over time is available for sum-based products.

Graphs for Ingested Spans and Indexed Spans, each plotting data for the daily and cumulative sums of their respective spans

Time selection contains options to view usage graphs at daily, weekly, monthly or yearly intervals.

Time intervals on usage graphs

The dashed Committed line shows commitments per product, without any allowances (such as Custom Metrics or Containers).

Committed usage line on APM Hosts graph configured with the value 10

Top custom metrics

In the Custom Metrics tab, the Top Custom Metrics table provides two views for your month-to-date usage and most recent day usage, such as usage on the date of the last update).

The “Top 5000” view provides the following information about your Top 5000 custom metrics:

  • Metric name
  • Average custom metrics per hour
  • Max custom metrics per hour
  • The metric’s contribution percentage to the overall custom metrics usage
  • Search for a metric within your top 5000 custom metrics
  • This data can be downloaded as a CSV file.

The “All” view provides the following information about all your custom metrics:

  • Metric name
  • Average custom metrics per hour
  • Max custom metrics per hour
  • Search for a metric within all your custom metrics
  • This data can be downloaded as a CSV file, with a maximum of 300,000 custom metrics. You can download over 300,000 custom metrics using our API endpoint.

For more details on your metrics, navigate to the Metrics Summary by hovering over the row of the metric you are interested in and clicking on the meter icon that shows up on the right side.

Overview of Top Custom Metrics table

Logs usage by index

In the Log Management tab, this table displays your hourly, daily, monthly, and annual indexed log usage by index name and retention period. It also shows the breakdown between live logs and rehydrated logs. The following information is provided:

  • Index name
  • Retention period in days
  • Indexed log count
  • The index’s contribution percentage to the overall indexed log usage for the time period selected

This data can be downloaded as a CSV file.

Logs Usage by Index

Troubleshooting

For technical questions, contact Datadog support.

For billing questions, contact your Customer Success Manager.