Overview
This node interacts with an InfluxDB database, allowing users to perform operations such as querying data using the Flux language. It is useful for retrieving time-series data from InfluxDB for analysis, monitoring, or reporting purposes. For example, a user can run a Flux query to extract measurements from a specific bucket within a defined time range.
Use Case Examples
- Querying sensor data from an InfluxDB bucket to monitor environmental conditions.
- Extracting performance metrics from a time-series database for visualization in a dashboard.
Properties
| Name | Meaning |
|---|---|
| Query (Flux Language) | The Flux query string used to retrieve data from InfluxDB. This is required for the query operation and allows specifying the data selection and filtering logic. |
| Options | Additional optional parameters for the query operation, such as overriding the default organization (workspace) to run the query against. |
Output
JSON
- ``
_time- Timestamp of the data point returned by the query._value- Value of the data point returned by the query._field- Field name associated with the data point._measurement- Measurement name associated with the data point.tags- Tags associated with the data point, if any.
Dependencies
- Requires an InfluxDB instance accessible via URL.
- Needs an API authentication token for InfluxDB credentials.
- Optionally requires organization and bucket names for query context.
Troubleshooting
- Ensure that valid InfluxDB credentials (URL, token) are provided; missing credentials will cause errors.
- Verify that the Flux query syntax is correct and compatible with the InfluxDB version used.
- If the organization or bucket is overridden in options, ensure they exist and are accessible.
- Common error: 'No credentials got returned!' indicates missing or misconfigured credentials.
- If the operation is not 'query' or 'write', an error will be thrown indicating unsupported operation.
Links
- InfluxDB Flux Language Documentation - Official documentation for writing Flux queries in InfluxDB.
- InfluxDB Cloud Documentation - General documentation for InfluxDB Cloud, including authentication and API usage.