Documentation

Flux data scripting language

This page documents an earlier version of InfluxDB. InfluxDB v1.8 is the latest stable version. View this page in the v1.8 documentation.

See the equivalent InfluxDB v2.0 documentation: Get started with Flux.

Flux is a functional data scripting language designed for querying, analyzing, and acting on time series data. Its takes the power of InfluxQL and the functionality of TICKscript and combines them into a single, unified syntax.

Flux v0.50 is a technical preview included with InfluxDB v1.7. It is still in active development and many functions provided by InfluxQL and TICKscript have yet to be implemented.

Flux design principles

Flux is designed to be usable, readable, flexible, composable, testable, contributable, and shareable. Its syntax is largely inspired by 2018’s most popular scripting language, Javascript, and takes a functional approach to data exploration and processing.

The following example illustrates pulling data from a bucket (similar to an InfluxQL database) for the last five minutes, filtering that data by the cpu measurement and the cpu=cpu-total tag, windowing the data in 1 minute intervals, and calculating the average of each window:

from(bucket:"telegraf/autogen")
  |> range(start:-1h)
  |> filter(fn:(r) =>
    r._measurement == "cpu" and
    r.cpu == "cpu-total"
  )
  |> aggregateWindow(every: 1m, fn: mean)

New! Cloud or OSS?