docs-v2/content/v2.0/reference/flux/stdlib/built-in/transformations/movingaverage.md

2.0 KiB

title description aliases menu weight related
movingAverage() function The `movingAverage()` function calculates the mean of values grouped into `n` number of points.
/v2.0/reference/flux/functions/built-in/transformations/aggregates/movingaverage/
/v2.0/reference/flux/functions/built-in/transformations/movingaverage/
v2_0_ref
name parent
movingAverage built-in-transformations
402
/v2.0/query-data/flux/moving-average/
/v2.0/reference/flux/stdlib/built-in/transformations/timedmovingaverage/
/v2.0/reference/flux/stdlib/built-in/transformations/exponentialmovingaverage/
/v2.0/reference/flux/stdlib/built-in/transformations/doubleema/
/v2.0/reference/flux/stdlib/built-in/transformations/tripleema/
https://docs.influxdata.com/influxdb/latest/query_language/functions/#moving-average, InfluxQL MOVING_AVERAGE()

The movingAverage() function calculates the mean of values in the _values column grouped into n number of points.

Function type: Transformation

movingAverage(n: 5)
Moving average rules
  • The average over a period populated by n values is equal to their algebraic mean.
  • The average over a period populated by only null values is null.
  • Moving averages skip null values.
  • If n is less than the number of records in a table, movingAverage returns the average of the available values.

Parameters

n

The number of points to average.

Data type: Integer

Examples

Calculate a five point moving average

from(bucket: "example-bucket"):
  |> range(start: -12h)
  |> movingAverage(n: 5)

Table transformation with a two point moving average

Input table:
_time tag _value
0001 tv null
0002 tv 6
0003 tv 4
Query:
// ...
  |> movingAverage(n: 2 )
Output table:
_time tag _value
0002 tv 6
0003 tv 5