---
title: Telegraf Documentation
description: Telegraf plugin for aggregating metrics using Final
url: https://docs.influxdata.com/telegraf/v1/aggregator-plugins/final/
estimated_tokens: 1504
product: Telegraf
version: v1
---

-   Telegraf v1.11.0+

# Final Aggregator Plugin

This plugin emits the last metric of a contiguous series, defined as a series which receives updates within the time period in `series_timeout`. The contiguous series may be longer than the time interval defined by `period`. When a series has not been updated within the `series_timeout`, the last metric is emitted.

Alternatively, the plugin emits the last metric in the `period` for the `periodic` output strategy.

This is useful for getting the final value for data sources that produce discrete time series such as procstat, cgroup, kubernetes etc. or to downsample metrics collected at a higher frequency.

All emited metrics do have fields with `_final` appended to the field-name by default.

**Introduced in:** Telegraf v1.11.0 **Tags:** sampling **OS support:** all

## Global configuration options

Plugins support additional global and plugin configuration settings for tasks such as modifying metrics, tags, and fields, creating aliases, and configuring plugin ordering. See [CONFIGURATION.md](/telegraf/v1/configuration/#plugins) for more details.

## Configuration

```toml
# Report the final metric of a series
[[aggregators.final]]
  ## The period on which to flush & clear the aggregator.
  # period = "30s"

  ## If true, the original metric will be dropped by the
  ## aggregator and will not get sent to the output plugins.
  # drop_original = false

  ## If false, _final is added to every field name
  # keep_original_field_names = false

  ## The time that a series is not updated until considering it final. Ignored
  ## when output_strategy is "periodic".
  # series_timeout = "5m"

  ## Output strategy, supported values:
  ##   timeout  -- output a metric if no new input arrived for `series_timeout`
  ##   periodic -- output the last received metric every `period`
  # output_strategy = "timeout"
```

### Output strategy

By default (`output_strategy = "timeout"`) the plugin will only emit a metric for the period if the last received one is older than the series\_timeout. This will not guarantee a regular output of a `final` metric e.g. if the series-timeout is a multiple of the gathering interval for an input. In this case metric sporadically arrive in the timeout phase of the period and emitting the `final` metric is suppressed.

Contrary to this, `output_strategy = "periodic"` will always output a `final` metric at the end of the period irrespectively of when the last metric arrived, the `series_timeout` is ignored.

## Metrics

Measurement and tags are unchanged, fields are emitted with the suffix `_final`.

## Example Output

```text
counter,host=bar i_final=3,j_final=6 1554281635115090133
counter,host=foo i_final=3,j_final=6 1554281635112992012
```

Original input:

```text
counter,host=bar i=1,j=4 1554281633101153300
counter,host=foo i=1,j=4 1554281633099323601
counter,host=bar i=2,j=5 1554281634107980073
counter,host=foo i=2,j=5 1554281634105931116
counter,host=bar i=3,j=6 1554281635115090133
counter,host=foo i=3,j=6 1554281635112992012
```

#### Related

-   [Configure plugins](/telegraf/v1/configure_plugins/)
-   [Final Plugin Source](https://github.com/influxdata/telegraf/tree/v1.38.4/plugins/aggregators/final/README.md)