Usage Metrics


The following in-app configuration pages allow you to set ingested and indexed volumes for APM:

Both pages are powered by usage metrics.

The following metrics are available in your account:

  • datadog.estimated_usage.apm.ingested_bytes (billed dimension)
  • datadog.estimated_usage.apm.ingested_spans
  • datadog.estimated_usage.apm.ingested_traces
  • datadog.estimated_usage.apm.indexed_spans (billed dimension)

Leverage these metrics in dashboards and monitors to visualize and control your usage. Two out-of-the box dashboards are built with these metrics. These dashboards help monitor your APM usage as well as your ingested and indexed span volumes.

Datadog APM plans come with indexed and ingested spans included. For more information, see the Pricing page or some pricing example scenarios.

Ingested spans volume

The following metrics are associated with ingested spans usage:

  • datadog.estimated_usage.apm.ingested_bytes
  • datadog.estimated_usage.apm.ingested_spans
  • datadog.estimated_usage.apm.ingested_traces

Control the usage with datadog.estimated_usage.apm.ingested_bytes. Ingestion is metered as a volume, not as a number of spans or traces. This metric is tagged by env and service so you can spot which environments and services are contributing to the ingestion volume.

This metric is also tagged by ingestion_reason, reflecting which ingestion mechanisms are responsible for sending spans to Datadog. These mechanisms are nested in the tracing libraries of the Datadog Agent. For more information about this dimension, see the Ingestion Reasons dashboard.

The datadog.estimated_usage.apm.ingested_traces metric measures the number of requests sampled per second, and only counts traces sampled by head-based sampling. This metric is also tagged by env and service so you can spot which services are starting the most traces.

Indexed spans

Use the datadog.estimated_usage.apm.indexed_spans metric to control the number of spans indexed by tag-based retention filters.

This metric is tagged by env and service so you can spot which environments and services are contributing to the indexing usage.

APM Traces Estimated Usage dashboard

The APM Traces Usage dashboard contains several widget groups displaying high-level KPIs and additional usage information.

APM Estimated Usage Dashboard

In this dashboard, you can find information about:

  • Global usage metrics
  • Infrastructure with APM enabled, including hosts, Fargate, and AWS Lambda
  • Ingestion volumes separated by service, env, and ingestion_reason
  • Indexing volumes separated by service and env

APM Ingestion Reasons dashboard

The APM Ingestion Reasons dashboard provides insights on each source of ingestion volume. Each ingestion usage metric is tagged with an ingestion_reason dimension, so you can see which configuration options (Datadog Agent configuration or tracing library configuration) and products (such as RUM or Synthetic Testing) are generating the most APM data.

APM Ingestion Reasons Dashboard

For each ingestion reason, you can find out which environments and services are contributing the most to the overall volume.

Further Reading

Additional helpful documentation, links, and articles: