increase() function

Warning! This page documents an earlier version of Flux, which is no longer actively developed. Flux v0.65 is the most recent stable version of Flux.

The increase() function calculates the total non-negative difference between subsequent values. A main use case is tracking changes in counter values which may wrap over time when they hit a threshold or are reset. In the case of a wrap/reset, we can assume that the absolute delta between two points will be at least their non-negative difference.

Function type: Aggregate
Output data type: Float

increase(columns: ["_value"])



The columns to use in the operation. Defaults to ["_value"].

Data type: Array of Strings


from(bucket: "telegraf/autogen")
  |> range(start: -24h)
  |> filter(fn: (r) =>
    r._measurement == "system" and
    r._field == "n_users"
  |> increase()

Given the following input table:

_time _value
00001 1
00002 5
00003 3
00004 4

increase() produces the following table:

_time _value
00002 4
00003 7
00004 8

Function definition

increase = (tables=<-, column="_value") =>
		|> difference(nonNegative: true, column:column)
		|> cumulativeSum()