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

==========

* Telegraf v1.28.0+

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

# Split Processor Plugin

This plugin splits a metric up into one or more metrics based on a configured
template. The resulting metrics will be timestamped according to the source
metric. Templates can overlap, where a field or tag, is used across templates
and as a result end up in multiple metrics.

> [!Note]
> If drop original is changed to true, then the plugin can result in dropping
> all metrics when no match is found! Please ensure to test templates before
> putting into production *and* use metric filtering to avoid data loss.

**Introduced in:** Telegraf v1.28.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
# Split a metric into one or more metrics with the specified field(s)/tag(s)
[[processors.split]]
  ## Keeps the original metric by default
  # drop_original = false

  ## Template for an output metric
  ## Users can define multiple templates to split the original metric into
  ## multiple, potentially overlapping, metrics.
  [[processors.split.template]]
    ## New metric name
    name = ""

    ## List of tag keys for this metric template, accepts globs, e.g. "*"
    tags = []

    ## List of field keys for this metric template, accepts globs, e.g. "*"
    fields = []
```

> [!Note]
> Some outputs are sensitive to the number of metric series that are produced.
> Multiple metrics of the same series (identical name, tag key-values, and
> field name) with the same timestamp might result in squashing those points
> to the latest metric produced.

## Example

The following takes a single metric with data from two sensors and splits out
each sensor into its own metric. It also copies all tags from the original
metric to the new metric.

```toml
[[processors.split]]
  drop_original = true
  [[processors.split.template]]
    name = "sensor1"
    tags = [ "*" ]
    fields = [ "sensor1*" ]
  [[processors.split.template]]
    name = "sensor2"
    tags = [ "*" ]
    fields = [ "sensor2*" ]
```

```
-metric,status=active sensor1_channel1=4i,sensor1_channel2=2i,sensor2_channel1=1i,sensor2_channel2=2i 1684784689000000000
+sensor1,status=active sensor1_channel1=4i,sensor1_channel2=2i 1684784689000000000
+sensor2,status=active sensor2_channel1=1i,sensor2_channel2=2i 1684784689000000000

```