Skip to content
Release Radar

ClickHouse Datasource

Monitoring & Observability

Grafana data source plugin for ClickHouse

grafana/clickhouse-datasourceDocumentation
v4.21.314 days after v4.21.2
View on GitHub

Part of Grafana

Release history

v4.21.3

CompareGitHub

4.21.3 (2026-09-15)

🐛 Bug Fixes

  • deps: bump brace-expansion override to 5.0.9 (4d58c70)
  • deps: bump brace-expansion to resolve HIGH severity CVEs (#2166) (4d58c70)
  • deps: update backend dependencies (#2120) (84c172a)
  • trace logs linking with timeframe (#2111) (801725f)

🤖 Continuous Integration

  • forward the bundled pipeline's ref input on manual dispatch (#2148) (3d00b58)

4.21.0 (2026-08-27)

🎉 Features

  • add time series statement macros ($__columns, $__rateColumns, $__perSecondColumns, $__increaseColumns, $__lttb) (#2019) (d90dbb1)
  • auth: add Forward OAuth Identity authentication (#1987) (769e1bd)
  • dashboards: add JSON-schema OTel logs dashboard (#2084) (39c6261)

🐛 Bug Fixes

  • adhoc: single-table sources, stateless Map keys, and pre-24.3 discovery (#2079) (b915269)
  • config: v1/v2 editor validation, Map keys switch, and feature toggle fixes (#2076) (9b087dd)
  • dashboards: annotation presets, free-text search, and datasource ref fixes (#2077) (8225d94)
  • deps: update backend dependencies (#2089) (afa6962)
  • logs: apply log message search to logs volume and sample queries (#2092) (d95e79b)
  • macros: preserve backtick identifiers and dollar-quoted literals (#2045) (6a565ed)
  • queryBuilder: compact editor, filter popover, and column auto-detection fixes (#2073) (431359a)
  • query: surface frontend query processing errors instead of hanging panels (#2090) (c003a5d)
  • schema: honour the plugin cache settings in schema resource responses (#2063) (13e8b3b)
  • traces: trace-ID lookup, companion-table validation, and span-link fixes (#2075) (83f8d10)
  • variables: forward scoped variables and filter missing Map keys (#2074) (8370829)

📝 Documentation

✅ Tests

  • e2e: default Playwright video off (#2129) (923183e)
  • e2e: raise cloud-run timeouts to fix nightly cron flakiness (#2121) (1327901)

🤖 Continuous Integration

  • add a dispatch-only caller for the bundled image pipeline (#2134) (1d04063)
  • cron: notify Slack on Cloud E2E failure (#2117) (0ec6744)
  • cron: pass run-stage to the Cloud E2E workflow for DER labelling (#2107) (03f906f)
  • enforce conventional commit pr titles and adopt release-please (#2015) (df673cc)
  • ship every merge to dev0 through the bundled pipeline (#2140) (d092bee)
  • trigger the full bundled rollout when a release is published (#2143) (511324d)
  • use shared reusable add-to-project workflow (#2088) (2be5f6a)
  • use shared reusable stale workflow (#2087) (bfbea5e)

4.20.0

Features

  • Add 1.3.0 OTel schema version to support opentelemetry-collector-contrib clickhouseexporter v0.151.0+, which removed the TimestampTime column from otel_logs. The latest selector now points to this schema; existing data sources continue to use 1.2.9 until manually updated (#1882)
  • Auto-detect the OTel logs schema version from the table's columns when the version selector is on auto (latest), removing the manual version pick for the common case. Pinned versions are unchanged (#1900)
  • Add optional Row Capacity Hint setting for large query responses (#2014)

Fixes

  • Fix dashboard query variables that return numeric or numeric-looking string values (for example toString(toUnixTimestamp(...))) failing to resolve with "Couldn't find any field of type string in the results" (#2021)
  • Expand macros nested inside another macro's arguments (#2043)
  • Don't break variable loading when version() returns no rows (#2023)
  • Correct and align attribute filters added from the log view (#2020)
  • Handle NaN/Inf in Tuple, Map and Nested JSON conversion (#2002)
  • Dependency updates (#2012, #2013)

Refactors

  • Expand macros via the sqlds Interpolator extension point (#2008)
  • Unify the converter type registry behind generic builders (#1990)

4.19.0

Features

  • Compact query mode for single-table data sources (#1841)
  • Pre-built OpenTelemetry dashboards for logs, traces, and per-service deep dives (#1869)
  • Guided variable editor with column values and Map-key support (#1868)
  • Preset-driven annotation editor with change detection (#1922)
  • SchemaPicker for cascading schema navigation in the query builder (#1828)
  • Group OTel attributes in log details (#1829)
  • Native type support for SimpleAggregateFunction numeric/bool/date columns (#1928)
  • Implement DataSourceWithToggleableQueryFiltersSupport interface (#1824)

Fixes

  • Ad-hoc: stop Map-key filters colliding across columns; bound free-form Map-key probe (#1993)
  • Traces: recover OTel columns on schema-fetch failure and guard compact SQL switch (#1992)
  • Traces: only apply the trace-ID timestamp optimization when the companion has Start/End/TraceId columns (#1994)
  • Traces: prevent crash when running Traces queries on older Grafana (#1937)
  • Traces: preserve trace-ID link optimization on cold cache (#1919)
  • Traces: prevent crash on raw-SQL queries with a trace_id column (#1920)
  • Macros: preserve macros in queries with backslash-escaped string literals (#1991)
  • Config: restore inline required-field validation for host/port on default installs (#1995)
  • Render SimpleAggregateFunction string columns correctly (#1927)
  • Fix datasource variable refs in Data Analysis dashboard (#1896)

Refactors

  • Config: migrate the ClickHouse config page design to OpenFeature (#1921)
  • Macros: adopt grafana/macropro as the macro engine (#1802)

4.18.0

Features

  • Introduce single-table mode for logs and traces configuration (#1832)
  • Auto-detect log/trace column roles by conventional names (#1791)
  • Add JSON attributes (tags) support (#1866)

Performance

  • Decouple trace ID lookup optimization from OTel mode (#1786)

Fixes

  • Bound Map-key probe to avoid full-column scans in ad-hoc filters (#1885)
  • Open the linked trace when following a span link (#1890)
  • Default trace optimization to true (#1853)
  • Support Map-typed columns in ad-hoc filters (#1793)
  • Support scope variables in the datasource (#1840)
  • Support JSON column filters and JSON-typed trace tags (#1792)
  • Preserve grafanaDependency compatibility with Grafana prereleases (#1892)
  • Remove Grafana 13 hard-break call sites (#1861)
  • Trim whitespace from host setting (#1830, #1831)
  • Dependency updates

4.17.0

Features

  • Allow $__adhocFilters macro to work with multiple tables (#1757)

Performance

  • Hold a single *sql.DB on SchemaProvider and dispose it with the instance (#1819)

Fixes

  • Dedupe autocomplete suggestions and dispose Monaco providers on unmount (#1820)
  • Map adhoc regex operators to REGEXP instead of ILIKE (#1794)
  • Close *sql.DB after each schema introspection query (#1818)
  • Dependency updates

4.16.0

Features

  • Explain column roles in logs/traces/timeseries query builders (#1790)
  • Cache system.tables/columns schema introspection with single flight (#1787)

Fixes

  • Drop LIMIT from single-trace span query (#1795)
  • Forward X-Grafana-User header to ClickHouse when enabled (#1797)
  • Fix slow traceId lookup (#1705)
  • Replace js-sql-parser with existing ClickHouse lexer for SQL validation (#1778)
  • Match column suggestions case-insensitively in autocomplete (#1779)
  • Dependency updates

4.15.0

Features

  • Add LogsSample supplemental query, remove deprecated getDataProvider (#1744)
  • Add Grafana query metadata support (#1743)
  • Allow disabling logs and trace links (#1754)
  • Improve query modification (#1738)
  • Add initial support for SQL abstractions (dsAbstraction) (#1756)
  • Add OpenTelemetry instrumentation (#1734)
  • Add field config to trace search results for better default display (#1733)
  • Add filterQuery method to datasource (#1732)
  • Support grouping orderBy columns by their column hint values (#1695)
  • Bump Grafana minimum version to v11.6.0 (#1753)

Fixes

  • Fix log context field returning labels (#1737)
  • Fix additional settings config bug (#1630)
  • Dependency updates

4.14.1

Features

  • Extract Map value type for mapKey filter in getFilters (#1694)

Fixes

  • Dependency updates

4.14.0

Features

  • Add FilterTime hint to enable multi-timestamp log filtering/sorting (#1642)
  • Skip OTel trace time range optimization when trace timestamp table does not exist (#1663)

Fixes

  • Dependency updates
  • Add separate columns for Resource/Scope/Log Attributes (#1560)
  • Fix panic when configuring datasource with numeric timeout values (#1559)

4.13.0

Features

  • Support for hiding table names in ad-hoc filters (#1493)
  • Allow manual placement of ad-hoc filters (#1488)
  • Add support for Nullable(Enum8/16) column types (#1523)
  • Add dashboard variable to control AdHoc filter syntax (#1464)

Fixes

  • Fix generating query with column names containing colons (#1538)
  • Update config HTTPS language (#1537)
  • Dependency updates

4.12.0

Features

  • Support log volume queries for the SQL editor. Note that this will only work for Grafana versions >= 12.4.0 (#1475)
  • Support columns with . in ad-hoc filters (#1481)

Fixes

  • Dependency updates