Basic Statistics Aggregator Plugin

This plugin computes basic statistics such as counts, differences, minima, maxima, mean values, non-negative differences etc. for a set of metrics and emits these statistical values every period.

Introduced in: Telegraf v1.5.0 Tags: statistics OS support: all

Global configuration options

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

# Keep the aggregate basicstats of each metric passing through.
[[aggregators.basicstats]]
  ## 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

  ## Configures which basic stats to push as fields
  # stats = ["count","min","max","mean","variance","stdev"]

• stats
  • If not specified, then count, min, max, mean, stdev, and s2 are aggregated and pushed as fields. Other fields are not aggregated by default to maintain backwards compatibility.
  • If empty array, no stats are aggregated

Measurements & Fields

• measurement1
  • field1_count
  • field1_diff (difference)
  • field1_rate (rate per second)
  • field1_max
  • field1_min
  • field1_mean
  • field1_non_negative_diff (non-negative difference)
  • field1_non_negative_rate (non-negative rate per second)
  • field1_percent_change
  • field1_sum
  • field1_s2 (variance)
  • field1_stdev (standard deviation)
  • field1_interval (interval in nanoseconds)
  • field1_last (last aggregated value)
  • field1_first (first aggregated value)

Tags

No tags are applied by this aggregator.

Example Output

system,host=tars load1=1 1475583980000000000
system,host=tars load1=1 1475583990000000000
system,host=tars load1_count=2,load1_diff=0,load1_rate=0,load1_max=1,load1_min=1,load1_mean=1,load1_sum=2,load1_s2=0,load1_stdev=0,load1_interval=10000000000i,load1_last=1 1475584010000000000
system,host=tars load1=1 1475584020000000000
system,host=tars load1=3 1475584030000000000
system,host=tars load1_count=2,load1_diff=2,load1_rate=0.2,load1_max=3,load1_min=1,load1_mean=2,load1_sum=4,load1_s2=2,load1_stdev=1.414162,load1_interval=10000000000i,load1_last=3,load1_first=3 1475584010000000000