For AI agents: A markdown version of this page is available at https://docs.datadoghq.com/observability_pipelines/processors/aggregate.md. A documentation index is available at /llms.txt.

Aggregate Processor

This product is not supported for your selected Datadog site. ().
Available for:

Metrics

Overview

The Aggregate processor combines multiple metrics with the same tag values into a single sample based on the selected aggregation mode. Aggregating metrics can help reduce your metric volume and costs.

Setup

To set up the Aggregate processor:

  1. Define a filter query. See Metrics Search Syntax for information on creating queries.
    • Only metrics matching the filter are processed.
    • All metrics, regardless of whether they match the filter query, are sent to the next step in the pipeline.
  2. In the Mode dropdown menu, select the aggregation function to use. See the Modes section for details.
  3. In the Interval field, enter the time window in seconds for aggregating metrics. The maximum value is 60 seconds.

Modes

The Aggregate processor can combine metrics into a single metric based on the following modes. Some modes are available only for specific metric kinds, incremental or absolute.

ModeDescriptionIncremental metricsAbsolute metrics
AutoDefault mode. Sums incremental metrics and uses the latest value for absolute metrics.
SumSums the metric values.
CountCounts the number of times the metric is received.
LatestReturns the latest metric value.
MaxReturns the maximum metric value.
MeanReturns the mean metric value.
MinReturns the minimum metric value.