View and Alert on APM Usage

Datadog has many pricing plans to fit your needs. For more information, see the Pricing page. Read APM documentation on APM Billing to understand how billing works for APM and Distributed Tracing.

Usage page

If you are an admin of your account, you can view your account usage using the Usage Page which gets updated every 24 hours.

DimensionDescription
APM HostsShows the 99th percentile of all distinct APM hosts over all hours in the current month.
APM Fargate TasksShows the average of distinct Fargate tasks over 5-minute time periods in the current month.
Ingested SpansShows the sum of Ingested Bytes from spans ingested in the current month.
Indexed SpansShows the sum of Indexed Spans indexed in the current month.

Each APM host and APM Fargate task grants you an allotment of ingested and indexed volume:

  • Ingested spans: 150 GB ingested spans per APM host and 10 GB ingested spans per APM Fargate task.
  • Indexed spans: 1M indexed spans per APM host and 65k spans indexed spans per APM Fargate task.

Set alerts based on ingested/indexed volumes

Set alerts on ingested bytes

To ensure that your ingested spans usage remains within the allocation that APM hosts and APM Fargate tasks grants you, set up monitors to alert when your monthly usage is close to your allocation.

  1. Create a metric monitor.
  2. Enter datadog.estimated_usage.apm.ingested_bytesfor the metric query.
  3. Define the monitor’s evaluation window to current month (MTD). This ensures that the monitor is looking at the month-to-date usage. Read more about cumulative time windows in the monitors documentation.
  4. Define the Alert threshold and an optional Warning threshold to alert when the ingested volume reaches 80% or 90% of your allotment.
  5. Enter a name for the monitor. Define the notification to send an alert to your team when the ingested volumes are too high.
A metric monitor configuration page showing the datadog.estimated_usage.apm.ingested_bytes as the metric query

To effectively reduce your ingested volumes, see this guide or the ingestion mechanisms documentation.

Set alerts on indexed spans

Similarly, you can set alerts to ensure that your budget for you indexed spans remains within certain limits. Create a metric monitor using the datadog.estimated_usage.apm.indexed_spans metric to get alerted when your month-to-date indexed spans volume goes over a defined threshold.

To reduce the number of indexed spans, check your configuration for retention filters. Read more about retention filters in the trace retention documentation.