History

Sven Rebhan d76723d21c docs(aggregators): Add plugin metadata and update description (#16089 )		2024-10-30 09:29:55 -05:00
..
README.md	docs(aggregators): Add plugin metadata and update description (#16089 )	2024-10-30 09:29:55 -05:00
merge.go	feat(aggregators.merge): Allow to round metric timestamps (#15319 )	2024-05-09 10:07:10 -05:00
merge_test.go	feat(aggregators.merge): Allow to round metric timestamps (#15319 )	2024-05-09 10:07:10 -05:00
sample.conf	feat(aggregators.merge): Allow to round metric timestamps (#15319 )	2024-05-09 10:07:10 -05:00

README.md

Merge Aggregator Plugin

This plugin merges metrics of the same series and timestamp into new metrics with the super-set of fields. A series here is defined by the metric name and the tag key-value set.

Use this plugin when fields are split over multiple metrics, with the same measurement, tag set and timestamp.

⭐ Telegraf v1.13.0 💻 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

# Merge metrics into multifield metrics by series key
[[aggregators.merge]]
  ## Precision to round the metric timestamp to
  ## This is useful for cases where metrics to merge arrive within a small
  ## interval and thus vary in timestamp. The timestamp of the resulting metric
  ## is also rounded.
  # round_timestamp_to = "1ns"

  ## If true, the original metric will be dropped by the
  ## aggregator and will not get sent to the output plugins.
  drop_original = true

Example

- cpu,host=localhost usage_time=42 1567562620000000000
- cpu,host=localhost idle_time=42 1567562620000000000
+ cpu,host=localhost idle_time=42,usage_time=42 1567562620000000000