integral() function

The integral() function computes the area under the curve per unit of time of subsequent non-null records. The curve is defined using _time as the domain and record values as the range.

Function type: Aggregate
Output data type: Float

integral(unit: 10s, columns: ["_value"])



The time duration used when computing the integral.

Data type: Duration


A list of columns on which to operate. Defaults to ["_value"].

Data type: Array of strings


from(bucket: "telegraf/autogen")
  |> range(start: -5m)
  |> filter(fn: (r) =>
    r._measurement == "cpu" and
    r._field == "usage_system"
  |> integral(unit:10s)


This documentation is open source. See a typo? Please, open an issue.

Need help getting up and running? Get Support