---
title: Telegraf Documentation
description: Telegraf plugin for transforming metrics using Batch
url: https://docs.influxdata.com/telegraf/v1/processor-plugins/batch/
estimated_tokens: 1245
product: Telegraf
version: v1
---

-   Telegraf v1.33.0+

# Batch Processor Plugin

This plugin groups metrics into batches by adding a batch tag. This is useful for parallel processing of metrics where downstream processors, aggregators or outputs can then select a batch using `tagpass` or `metricpass`.

Metrics are distributed across batches using the round-robin scheme.

**Introduced in:** Telegraf v1.33.0 **Tags:** grouping **OS support:** all

## Global configuration options

In addition to the plugin-specific configuration settings, plugins support additional global and plugin configuration settings. These settings are used to modify metrics, tags, and field or create aliases and configure ordering, etc. See the [CONFIGURATION.md](/telegraf/v1/configuration/#plugins) for more details.

## Configuration

```toml
## Batch metrics into separate batches by adding a tag indicating the batch index.
[[processors.batch]]
  ## The name of the tag to use for adding the batch index
  batch_tag = "my_batch"

  ## The number of batches to create
  batches = 16

  ## Do not assign metrics with an existing batch assignment to a
  ## different batch.
  # skip_existing = false
```

## Example

The example below uses these settings:

```toml
[[processors.batch]]
  ## The tag key to use for batching
  batch_tag = "batch"

  ## The number of batches to create
  batches = 3
```

```diff
- temperature cpu=25
- temperature cpu=50
- temperature cpu=75
- temperature cpu=25
- temperature cpu=50
- temperature cpu=75
+ temperature,batch=0 cpu=25
+ temperature,batch=1 cpu=50
+ temperature,batch=2 cpu=75
+ temperature,batch=0 cpu=25
+ temperature,batch=1 cpu=50
+ temperature,batch=2 cpu=75

```

#### Related

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