Moving Average

Use movingAverage() or timedMovingAverage() to return the moving average of data.

data
    |> movingAverage(n: 5)

// OR

data
    |> timedMovingAverage(every: 5m, period: 10m)

movingAverage()

For each row in a table, movingAverage() returns the average of the current value and previous values where n is the total number of values used to calculate the average.

If n = 3:

{{< flex >}} {{% flex-content %}} Given the following input:

|> movingAverage(n: 3)

timedMovingAverage()

For each row in a table, timedMovingAverage() returns the average of the current value and all row values in the previous period (duration). It returns moving averages at a frequency defined by the every parameter.

Each color in the diagram below represents a period of time used to calculate an average and the time a point representing the average is returned. If every = 30m and period = 1h:

{{< svg "/static/svgs/timed-moving-avg.svg" >}}

{{< flex >}} {{% flex-content %}} Given the following input:

|> timedMovingAverage(every: 30m, period: 1h)