---
title: ''
description: Telegraf plugin for transforming metrics using Round
url: https://docs.influxdata.com/telegraf/v1/processor-plugins/round/
estimated_tokens: 584
product: Telegraf Enterprise
version: v1
publisher: InfluxData
canonical: https://docs.influxdata.com/telegraf/v1/processor-plugins/round/
date: '2026-05-21T20:10:18+02:00'
lastmod: '2026-05-21T20:10:18+02:00'
---

==========

* Telegraf v1.36.0+

[Plugin source](https://github.com/influxdata/telegraf/tree/v1.39.1/plugins/processors/round/)[Download configuration](https://raw.githubusercontent.com/influxdata/telegraf/refs/tags/v1.39.1/plugins/processors/round/sample.conf)

# Round Processor Plugin

This plugin allows to round numerical field values to the configured precision.
This is particularly useful in combination with the [dedup processor](/telegraf/v1/plugins/#processor-dedup)to reduce the number of metrics sent to the output if only a lower precision
is required for the values.

**Introduced in:** Telegraf v1.36.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
# Round numerical fields
[[processors.round]]
  ## Precision to round to.
  ## A positive number indicates rounding to the right of the decimal separator (the fractional part).
  ## A negative number indicates rounding to the left of the decimal separator.
  # precision = 0

  ## Round only numeric fields matching the filter criteria below.
  ## Excludes takes precedence over includes.
  # include_fields = ["*"]
  # exclude_fields = []
```

## Example

Round each value the *inputs.cpu* plugin generates, except for the`usage_steal`, `usage_user`, `uptime_format`, `usage_idle` field:

```toml
[[inputs.cpu]]
  percpu = true
  totalcpu = true
  collect_cpu_time = false
  report_active = false

[[processors.round]]
  precision = 1
  include_fields = []
  exclude_fields = ["usage_steal", "usage_user", "uptime_format", "usage_idle" ]
```

Result of rounding the *cpu* metric:

```
- cpu map[cpu:cpu11 host:98d5b8dbad1c] map[usage_guest:0 usage_guest_nice:0 usage_idle:94.3999999994412 usage_iowait:0 usage_irq:0.1999999999998181 usage_nice:0 usage_softirq:0.20000000000209184 usage_steal:0 usage_system:1.2000000000080036 usage_user:4.000000000014552]
+ cpu map[cpu:cpu11 host:98d5b8dbad1c] map[usage_guest:0 usage_guest_nice:0 usage_idle:94.4 usage_iowait:0 usage_irq:0.2 usage_nice:0 usage_softirq:0.2 usage_steal:0 usage_system:1.2 usage_user:4.0]

```