telegraf/plugins/processors/clone
Sebastian Spaink d67f75e557
docs: Remove warning not to remove go:embed (#11797)
Co-authored-by: Joshua Powers <powersj@fastmail.com>
2022-09-13 12:47:58 -05:00
..
README.md chore: Fix readme linter errors for processor, aggregator, and parser plugins (#10960) 2022-06-06 17:04:28 -06:00
clone.go docs: Remove warning not to remove go:embed (#11797) 2022-09-13 12:47:58 -05:00
clone_test.go fix: Linter fixes for plugins/processors/[a-z]* (#10161) 2021-11-24 12:38:08 -07:00
sample.conf chore(processors): migrate sample configs into separate files (#11125) 2022-05-18 11:29:43 -05:00

README.md

Clone Processor Plugin

The clone processor plugin create a copy of each metric passing through it, preserving untouched the original metric and allowing modifications in the copied one.

The modifications allowed are the ones supported by input plugins and aggregators:

  • name_override
  • name_prefix
  • name_suffix
  • tags

Select the metrics to modify using the standard metric filtering options.

Values of name_override, name_prefix, name_suffix and already present tags with conflicting keys will be overwritten. Absent tags will be created.

A typical use-case is gathering metrics once and cloning them to simulate having several hosts (modifying host tag).

Configuration

# Apply metric modifications using override semantics.
[[processors.clone]]
  ## All modifications on inputs and aggregators can be overridden:
  # name_override = "new_name"
  # name_prefix = "new_name_prefix"
  # name_suffix = "new_name_suffix"

  ## Tags to be added (all values must be strings)
  # [processors.clone.tags]
  #   additional_tag = "tag_value"