Documentation

Query the Flux version

InfluxDB Cloud includes specific version of Flux that may or may not support documented Flux functionality. It’s important to know what version of Flux you’re currently using and what functions are supported in that specific version.

To query the version of Flux installed with InfluxDB, use array.from() to create an ad hoc stream of tables and runtime.version() to populate a column with the Flux version.

Because the InfluxDB /api/v2/query endpoint can only return a stream of tables and not single scalar values, you must use array.from() to create a stream of tables.

Run the following query in the InfluxDB user interface, with the influx CLI, or InfluxDB API:

import "array"
import "runtime"

array.from(rows: [{version: runtime.version()}])

To return the version of Flux installed with InfluxDB using the InfluxDB UI:

  1. Click Data Explorer in the left navigation bar.
  1. Click Script Editor to manually create and edit a Flux query.

  2. Enable the View Raw Data toggle or select one of the following visualization types:

  3. Enter and run the following query:

    import "array"
    import "runtime"
    
    array.from(rows: [{version: runtime.version()}])
    

To return the version of Flux installed with InfluxDB using the influx CLI, use the influx query command. Provide the following:

  • InfluxDB host, organization, and API token
    (the example below assumes that a CLI configuration is set up and active)
  • Query to execute
$ influx query \
  'import "array"
   import "runtime"

   array.from(rows: [{version: runtime.version()}])'

# Output
Result: _result
Table: keys: []
        version:string
----------------------
              v0.161.0

To return the version of Flux installed with InfluxDB using the InfluxDB API, use the /api/v2/query endpoint.

POST http://localhost:8086/api/v2/query

Provide the following:

  • InfluxDB Cloud host
  • InfluxDB organization name or ID as a query parameter
  • Authorization header with the Token scheme and your API token
  • Accept: application/csv header
  • Content-type: application/vnd.flux header
  • Query to execute as the request body
curl --request POST \
  http://localhost:8086/api/v2/query?orgID=INFLUX_ORG_ID \
  --header 'Authorization: Token INFLUX_TOKEN' \
  --header 'Accept: application/csv' \
  --header 'Content-type: application/vnd.flux' \
  --data 'import "array"
    import "runtime"

    array.from(rows: [{version: runtime.version()}])'

# Output
,result,table,version
,_result,0,v0.161.0

Flux version in the Flux REPL

When you run runtime.version() in the Flux REPL, the function returns the version of Flux the REPL was built with, not the version of Flux installed in the instance of InfluxDB you’re querying.


Was this page helpful?

Thank you for your feedback!


The future of Flux

Flux is going into maintenance mode. You can continue using it as you currently are without any changes to your code.

Read more

InfluxDB v3 enhancements and InfluxDB Clustered is now generally available

New capabilities, including faster query performance and management tooling advance the InfluxDB v3 product line. InfluxDB Clustered is now generally available.

InfluxDB v3 performance and features

The InfluxDB v3 product line has seen significant enhancements in query performance and has made new management tooling available. These enhancements include an operational dashboard to monitor the health of your InfluxDB cluster, single sign-on (SSO) support in InfluxDB Cloud Dedicated, and new management APIs for tokens and databases.

Learn about the new v3 enhancements


InfluxDB Clustered general availability

InfluxDB Clustered is now generally available and gives you the power of InfluxDB v3 in your self-managed stack.

Talk to us about InfluxDB Clustered

InfluxDB Cloud powered by TSM