Back to Telegraf

Minimum-Maximum Aggregator Plugin

plugins/aggregators/minmax/README.md

1.38.31.6 KB
Original Source

Minimum-Maximum Aggregator Plugin

This plugin aggregates the minimum and maximum values of each field it sees, emitting the aggrate every period seconds with field names suffixed by _min and _max respectively.

⭐ Telegraf v1.1.0 🏷️ statistics 💻 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 for more details.

Configuration

toml
# Keep the aggregate min/max of each metric passing through.
[[aggregators.minmax]]
  ## General Aggregator Arguments:
  ## The period on which to flush & clear the aggregator.
  # period = "30s"

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

Measurements & Fields

  • measurement1
    • field1_max
    • field1_min

Tags

No tags are applied by this aggregator.

Example Output

text
system,host=tars load1=1.72 1475583980000000000
system,host=tars load1=1.6 1475583990000000000
system,host=tars load1=1.66 1475584000000000000
system,host=tars load1=1.63 1475584010000000000
system,host=tars load1_max=1.72,load1_min=1.6 1475584010000000000
system,host=tars load1=1.46 1475584020000000000
system,host=tars load1=1.39 1475584030000000000
system,host=tars load1=1.41 1475584040000000000
system,host=tars load1_max=1.46,load1_min=1.39 1475584040000000000