Telegraf aggregator plugins

Warning! This page documents an earlier version of Telegraf, which is no longer actively developed. Telegraf v1.7 is the most recent stable version of Telegraf.

Aggregators emit new aggregate metrics based on the metrics collected by the input plugins.

Note: Telegraf plugins added in the current release are noted with -- NEW in v1.6. The Release notes and changelog has a list of new plugins and updates for other plugins. See the plugin README files for more details.

Supported Telegraf aggregator plugins

BasicStats (basicstats)

The BasicStats (basicstats) aggregator plugin gives count, max, min, mean, s2(variance), and stdev for a set of values, emitting the aggregate every period seconds.

Histogram (histogram)

The Histogram (histogram) aggregator plugin creates histograms containing the counts of field values within a range.

Values added to a bucket are also added to the larger buckets in the distribution. This creates a cumulative histogram.

Like other Telegraf aggregators, the metric is emitted every period seconds. Bucket counts however are not reset between periods and will be non-strictly increasing while Telegraf is running.

MinMax (minmax)

The MinMax (minmax) aggregator plugin aggregates min and max values of each field it sees, emitting the aggegrate every period seconds.