---
title: Telegraf Documentation
description: Telegraf plugin for transforming metrics using Cumulative Sum
url: https://docs.influxdata.com/telegraf/v1/processor-plugins/cumulative_sum/
estimated_tokens: 967
product: Telegraf
version: v1
---

-   Telegraf v1.35.0+

# Cumulative Sum Processor Plugin

This plugin accumulates field values per-metric over time and emit metrics with cumulative sums whenever a metric is updated. This is useful when using outputs relying on monotonically increasing values

Metrics within a series are accumulated in the **order of arrival** and not in order of their timestamps!

**Introduced in:** Telegraf v1.35.0 **Tags:** transformation **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
# Compute the cumulative sum of the given fields
[[processors.cumulative_sum]]
  ## Numerical fields to be processed (accepting wildcards)
  # fields = ["*"]

  ## Interval after which metrics are evicted from the cache and the
  ## sum values are reset to zero. A zero or unset value will keep the
  ## metric forever.
  ## It is strongly recommended to set an expiry interval to avoid
  ## growing memory usage when varying metric series are processed.
  # expiry_interval = "0s"
```

## Example

```diff
- net,host=server01 bytes_sent=1000,bytes_received=500
- net,host=server01 bytes_sent=2500,bytes_received=1500
- net,host=server01 bytes_sent=3000,bytes_received=2500
+ net,host=server01 bytes_sent=1000,bytes_sent_sum=1000,bytes_received=500,bytes_received_sum=500
+ net,host=server01 bytes_sent=2500,bytes_sent_sum=3500,bytes_received=1500,bytes_received_sum=2000
+ net,host=server01 bytes_sent=3000,bytes_sent_sum=6500,bytes_received=2500,bytes_received_sum=4500

```

#### Related

-   [Configure plugins](/telegraf/v1/configure_plugins/)
-   [Cumulative Sum Plugin Source](https://github.com/influxdata/telegraf/tree/v1.38.4/plugins/processors/cumulative_sum/README.md)