---
description: "Telegraf plugin for transforming metrics using Split"
menu:
  telegraf_v1_ref:
    parent: processor_plugins_reference
    name: Split
    identifier: processor-split
tags: [Split, "processor-plugins", "configuration", "transformation"]
introduced: "v1.28.0"
os_support: "freebsd, linux, macos, solaris, windows"
related:
  - /telegraf/v1/configure_plugins/
  - https://github.com/influxdata/telegraf/tree/v1.38.0/plugins/processors/split/README.md, Split Plugin Source
---

# 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 <!-- @/docs/includes/plugin_config.md -->

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.md]: ../../../docs/CONFIGURATION.md#plugins

## Configuration

```toml @sample.conf
# 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*" ]
```

```diff
-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
```