Usage Details

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

Overall usage

This section contains hourly, daily, monthly, and annual usage:

Hourly Usage - All

In product specific tabs, view your hourly, daily, monthly, and annual usage of the products in that product category. Some products also provide additional detailed breakdowns of usage. For example, in the Infrastructure tab, the breakdown by host type is available.

Hourly Usage - Infra Hosts

Most accounts have access to the feature Included Lines, which allows you to see how your usage is tracking over the month. The graphs on your Usage page contain an “Included” line that shows commitments per product plus any allowances (such as, custom metrics, containers).

Usage graph with an Included line

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.