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 for more details.
Configuration
## 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 = falseExample
The example below uses these settings:
[[processors.batch]]
## The tag key to use for batching
batch_tag = "batch"
## The number of batches to create
batches = 3- 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
Was this page helpful?
Thank you for your feedback!
Support and feedback
Thank you for being part of our community! We welcome and encourage your feedback and bug reports for Telegraf and this documentation. To find support, use the following resources:
Customers with an annual or support contract can contact InfluxData Support.