---
title: Aggregate Processor
description: Datadog, the leading service for cloud-scale monitoring.
breadcrumbs: Docs > Observability Pipelines > Processors > Aggregate Processor
---

> For the complete documentation index, see [llms.txt](https://docs.datadoghq.com/llms.txt).

# Aggregate Processor

{% callout %}
# Important note for users on the following Datadog sites: app.ddog-gov.com, us2.ddog-gov.com

{% alert level="danger" %}
This product is not supported for your selected [Datadog site](https://docs.datadoghq.com/getting_started/site.md). ({% placeholder "user-datadog-site-name" /%}).
{% /alert %}

{% /callout %}
Available for:
{% icon name="icon-metrics" /%}
 Metrics 
## Overview{% #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{% #setup %}

To set up the Aggregate processor:

1. Define a filter query. See [Metrics Search Syntax](https://docs.datadoghq.com/observability_pipelines/search_syntax/metrics.md) 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.
1. In the **Mode** dropdown menu, select the aggregation function to use. See the Modes section for details.
1. In the **Interval** field, enter the time window in seconds for aggregating metrics. The maximum value is 60 seconds.

## Modes{% #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](https://docs.datadoghq.com/observability_pipelines/configuration.md?tab=metrics#metrics-data), incremental or absolute.

| Mode   | Description                                                                            | Incremental metrics | Absolute metrics |
| ------ | -------------------------------------------------------------------------------------- | ------------------- | ---------------- |
| Auto   | Default mode. Sums incremental metrics and uses the latest value for absolute metrics. | yes                 | yes              |
| Sum    | Sums the metric values.                                                                | yes                 |
| Count  | Counts the number of times the metric is received.                                     | yes                 | yes              |
| Latest | Returns the latest metric value.                                                       | yes                 |
| Max    | Returns the maximum metric value.                                                      | yes                 |
| Mean   | Returns the mean metric value.                                                         | yes                 |
| Min    | Returns the minimum metric value.                                                      | yes                 |