ToolJet/docs/versioned_docs/version-3.16.0-LTS/data-sources/influxdb.md

id	title
influxdb	InfluxDB

ToolJet can connect to InfluxDB databases to read and write data. Use the Token authentication scheme to authenticate to the InfluxDB API. For more info visit InfluxDB docs.

Connection

ToolJet connects to InfluxDB using :

• API Token
• Host
• Port
• Protocol (HTTP/HTTPS)

:::info For generating API Token visit InfluxDB docs. :::

Supported Queries

• Write data
• Query data
• Generate an Abstract Syntax Tree (AST) from a query
• Retrieve query suggestions
• Retrieve query suggestions for a branching suggestion
• Analyze a Flux query
• List buckets
• Create a bucket
• Retrieve a bucket
• Update a bucket
• Delete a bucket

<img className="screenshot-full img-full" src="/img/datasource-reference/influxdb/listops-v4.png" alt="influx operations" style={{marginBottom:'15px'}}/>

Write Data

This operation writes data to a bucket.

Required Parameters:

• Bucket
• Organization name or ID
• Data

Optional Parameters:

• Precision

<img className="screenshot-full img-full" src="/img/datasource-reference/influxdb/write-query.png" alt="write query operations" style={{marginBottom:'15px'}}/>

Example

temperature, location = office value = 23.5

Query Data

Retrieves data from InfluxDB buckets.

Required Parameters:

• Organization name or ID
• Flux query

<img className="screenshot-full img-full" src="/img/datasource-reference/influxdb/query-data.png" alt="query data operations" style={{marginBottom:'15px'}}/>

Example

from(bucket: "sensor_data") 
|> range(start: -1h) 
|> filter(fn: (r) => r["_measurement"] == "temperature")

Generate an Abstract Syntax Tree (AST) from a Query

This operation analyzes flux query and generates a query specification.

Required Parameters:

• Query

<img className="screenshot-full img-full" src="/img/datasource-reference/influxdb/generate-ast-query.png" alt="generate query operations" style={{marginBottom:'15px'}}/>

Example

from(bucket: "website_metrics")
  |> range(start: -7d)
  |> filter(fn: (r) => r["_measurement"] == "page_views")
  |> group(columns: ["url"])
  |> sum(column: "_value")
  |> sort(columns: ["_value"], desc: true)

Retrieve Query Suggestions

This query retrieve query suggestions.

<img className="screenshot-full img-full" src="/img/datasource-reference/influxdb/retrieve-query.png" alt="retrieve operations" style={{marginBottom:'15px'}}/>

Retrieve Query Suggestions for a Branching Suggestion

This operation retrieve query suggestions for a branching suggestion.

Required Parameters:

• Name

<img className="screenshot-full img-full" src="/img/datasource-reference/influxdb/retrieve-branching.png" alt="retrieve operations" style={{marginBottom:'15px'}}/>

Analyze a Flux Query

This Analyzes a Flux query.

Required Parameters:

• Query

<img className="screenshot-full img-full" src="/img/datasource-reference/influxdb/analyze-flux.png" alt="analyze query operations" style={{marginBottom:'15px'}}/>

Example

from(bucket: "sensor_data")
  |> range(start: -1d)
  |> filter(fn: (r) => r["_measurement"] == "humidity")
  |> mean(column: "_value")

List Buckets

This operation lists all the buckets in a database.

<img className="screenshot-full img-full" src="/img/datasource-reference/influxdb/list-bucket.png" alt="list operations" style={{marginBottom:'15px'}}/>

Create a Bucket

This operation creates a bucket in database.

Required Parameters:

• Query

<img className="screenshot-full img-full" src="/img/datasource-reference/influxdb/create-bucket.png" alt="create operations" style={{marginBottom:'15px'}}/>

Example

POST http://localhost:8086/api/v2/buckets
Content-Type: application/json
Authorization: Token your_auth_token

{
  "name": "new_bucket",
  "orgID": "your_org_id",
  "retentionRules": [
    {
      "everySeconds": 3600
    }
  ]
}

Retrieve a Bucket

This operation retrieve a bucket in a database.

Required Parameters:

• Bucket ID

<img className="screenshot-full img-full" src="/img/datasource-reference/influxdb/retrieve-bucket.png" alt="retrieve operations" style={{marginBottom:'15px'}}/>

Update a Bucket

This operaition updates the bucket in database.

Required Parameters:

• Bucket ID
• Query

<img className="screenshot-full img-full" src="/img/datasource-reference/influxdb/update-bucket.png" alt="update operations" style={{marginBottom:'15px'}}/>

Example

{
  "name": "updated_bucket_name",
  "retentionRules": [
    {
      "everySeconds": 7200
    }
  ]
}

Delete a Bucket

This operation delete the bucket in database.

Required Parameters:

• Bucket ID

<img className="screenshot-full img-full" src="/img/datasource-reference/influxdb/delete-bucket.png" alt="delete operations" style={{marginBottom:'15px'}}/>