Skip to content

feat: Add InfluxDB support#551

Draft
ZPascal wants to merge 3 commits intoperses:mainfrom
ZPascal:add-influxdb-support
Draft

feat: Add InfluxDB support#551
ZPascal wants to merge 3 commits intoperses:mainfrom
ZPascal:add-influxdb-support

Conversation

@ZPascal
Copy link

@ZPascal ZPascal commented Feb 2, 2026

Add InfluxDB Plugin Support for Perses

Summary

This pull request introduces comprehensive support for InfluxDB datasources in Perses. The new plugin enables connections to both InfluxDB v1.8 and v3 instances with full support for direct and proxy-based connections, schema validation, and time series queries. The additional Flux support for InfluxDB 1.8 and InfluxDB 2 is out of the scope and not tested.

Motivation

InfluxDB is a widely-used time series database, and this plugin provides Perses users with seamless integration for building dashboards and exploring metrics stored in InfluxDB. The dual-version support ensures compatibility with both legacy (v1.8) and modern (v3) InfluxDB deployments.

Major Changes

✨ New InfluxDB Plugin Package

A completely new plugin package has been added at influxdb/ with support for:

Datasources

  • InfluxDB v1.8 Datasource (InfluxDBV1Datasource)

    • Query interface: InfluxQL
    • Configuration: Database selection, direct URL or proxy mode
    • Full validation of required fields
  • InfluxDB v3 Datasource (InfluxDBV3Datasource)

    • Query interface: SQL
    • Configuration: Organization and bucket selection, direct URL or proxy mode
    • Full validation of required fields

Queries

  • InfluxDB Time Series Query (InfluxDBTimeSeriesQuery)
    • Supports both InfluxQL (v1.8) and SQL (v3) query languages
    • Automatic response conversion to Perses TimeSeries format
    • Full error handling with descriptive messages

Features

  • ✅ Direct URL and HTTP Proxy support for both versions
  • ✅ Schema validation (CUE and JSON schemas)
  • ✅ Comprehensive test suite with 12+ test cases
  • ✅ Full TypeScript support with strict typing
  • ✅ Datatype conversion for v1 and v3 response formats
  • ✅ React UI components for configuration editors
  • ✅ Go SDK for programmatic dashboard/datasource creation
  • ✅ Configuration examples for both versions

✅ Breaking Changes

None. This is a new feature addition that doesn't affect existing functionality.

Related Issues

Enables InfluxDB support for Perses dashboards and exploration tools

@ZPascal ZPascal force-pushed the add-influxdb-support branch 2 times, most recently from 46ab36f to bbf65b9 Compare February 15, 2026 12:25
Signed-off-by: Pascal Zimmermann <pascal.zimmermann@theiotstudio.com>
@ZPascal ZPascal force-pushed the add-influxdb-support branch from bbf65b9 to 427e1f2 Compare February 15, 2026 12:32
Signed-off-by: Pascal Zimmermann <pascal.zimmermann@theiotstudio.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant