3.6.0 (2026-11-17)
Enhancements:
- add a full-range logs volume histogram for Explore → Logs: the datasource now implements Grafana's supplementary-query contract (
LogsVolume), so Explore runs a separate server-side aggregate over the whole time range ($timeSeriesbuckets × log level, levels detected withmultiSearchAnyon thelevel/severitycolumn,ORDER BY/LIMITof the logs query are not applied) instead of building the histogram from the firstLIMIT-ed rows and showing the "This datasource does not support full-range histograms" warning; queries without a configured timestamp column keep Grafana's old row-based histogram, queries without alevel/severitycolumn get a singlecount()series, fix #782 - add per-field "Advanced logs fields" settings for logs queries: configure how complex ClickHouse columns (
Map,Array,Tuple,JSON,Dynamic,Variant) are rendered in the Logs panel —expand(one label per nested key, with per-field depth 1–4/All for nested types; the default depth is 1, matching previous releases so upgrades do not change label shapes),single(whole value as one label),hide, orraw(appended to the message body); the modal shows a live tree preview built from a sample row, disables Save until something changes, supports reset to defaults and marks modified fields, related to #678 - type-aware label accessors for logs:
Mapcolumns expand with bracket subscripts (col['key'], chained for nested maps),JSON/Tuple/Nestedwith dot paths (col.a.b), so every filter click produces valid ClickHouse SQL - make adhoc filters column/type-aware: introspect
system.columns(cached per datasource) to keep dot-path keys (json.a.b,tuple.field, Nestedattr.key) as column expressions of the current table, quote values by column type (e.g.Map(String, String)values are always quoted, numeric leaves stay unquoted) and emit ClickHouse array literals only forArraycolumns; falls back to the legacy behavior whenever introspection is unavailable - upgrade frontend to
@grafana/data|ui|runtime13.3.0 and refresh JS/Go dependencies (qs,dompurify,zod,handlebars,source-map-js,go.opentelemetry.io/otel/sdk1.47.0,pillow13.0.0 in testflows) to fix security alerts - raise unit test coverage: backend (Go) 56% -> 92%, frontend (Jest) 39% -> 92% — 663 frontend tests (was 310) and ~350 new Go cases, frontend coverage ratchet bumped in
jest.config.js(stmts 32 -> 90, branches 31 -> 88, funcs 21 -> 80, lines 32 -> 90), #930 - test infrastructure: bump testflows to 2.5.1 for Python 3.14 on ubuntu-26.04 runners, drop the host
ffmpegapt install in favor ofopencv-python-headless, and stabilize flaky e2e tests (retry annotations screenshot compare on transient GrafanaSQLITE_BUSY, wait for any dashboard link in the dashboards list, match the panel alert state icon as a link on Grafana 13.3) - preserve big-number precision for
UInt64/Int64above 2^53:output_format_json_quote_64bit_integers=1is applied to logs queries only (no time series regression, see #832), adhoc array literals parse numbers withjson.Numberand format elements by the column's ELEMENT type — string-serializedUInt64elements become bare numerics forArray(UInt64)columns, numeric-looking strings stay quoted forArray(String)columns
Fixes:
- fix Logs panel labels being attributed to the wrong rows when an expand-mode
Map/JSONvalue is empty for some rows - fix adhoc filter values being corrupted: trailing text after a JSON-array prefix is no longer swallowed into an array literal, the legacy passthrough for pre-quoted / IN-list values is restored, and fully-qualified keys addressed to other tables are dropped again even when their first segment collides with a column name
- fix responses being paired with hidden/empty targets in mixed panels (wrong format/refId applied to the visible query)
- fix column-type cache leaking between multiple ClickHouse datasources within one Grafana process
- fix query results being rejected by Grafana SQL expressions / transformations — a result without a time column is now returned as a single table frame with columns in
SELECTorder (instead of one frame per column), and multi-series time results declare thetimeseries-multiframe type, fix #820 - fix ad-hoc filter application stripping commas from multi-value SQL
INlists during AST re-formatting, fix #941 - fix numeric-looking ad-hoc filter values being emitted unquoted when the column type is unknown, fix #794
- fix template variable dropdown rendering empty labels for options whose value is a JSON array/object, fix #781
- fix follow-up issues with the 3.5.0 datasource-level data links: links attached to log rows are now carried through the "Show context" view, incomplete link configurations are skipped at apply time instead of breaking the panel, ClickHouse-target links inherit the source query's database / table / timestamp settings so
$timeFilterand other macros expand as in the source query, and the data-link plumbing is typed instead ofany, closes #432, closes #645, #904 - fix query template variables failing entirely on Grafana >= 13.2 —
templateSrv.replace()threwSceneObject root is not a DashboardScenewhen a query containing the$__dashboardmacro ran from the variable editor modal; the macro is now dropped and the rest interpolated (safeTemplateReplace); also fix stale "Show generated SQL" output caused by out-of-order backendreplace()responses, #935 - add regression e2e coverage for XY chart visualization from
tableformat results (#793); make thexy_chartdocker init schema idempotent
What's Changed
- Improve test coverage: backend 56% -> 92%, frontend 39% -> 92% by @lunaticusgreen in #930
- Add advanced per-field settings for complex log fields by @lunaticusgreen in #909
- Fix Grafana 13.2 variable editor bug and make testflows green on latest without xfails by @Slach in #935
- Datalinks fixed by @lunaticusgreen in #904
- chore(deps-dev): bump baseline-browser-mapping from 2.10.33 to 2.11.21 by @dependabot[bot] in #936
- Full-range logs volume histogram for Explore (#782) by @lunaticusgreen in #940
- chore(deps): bump pillow from 12.3.0 to 13.0.0 in /tests/testflows by @dependabot[bot] in #949
- chore(deps): bump source-map-js from 1.2.1 to 1.2.2 by @dependabot[bot] in #943
- chore(deps-dev): bump handlebars from 4.7.9 to 4.7.10 by @dependabot[bot] in #945
- chore(deps): bump @grafana packages to 13.3, dompurify, zod and dev dependencies by @lunaticusgreen in #956
- ci(testflows): drop host ffmpeg install, use opencv-python-headless by @Slach in #960
- chore(deps): bump qs from 6.15.2 to 6.17.1 by @dependabot[bot] in #959
- add test dashboard for XY + color, table visualization by @Slach in #958
- fix: quote numeric-looking ad-hoc values when the column type is unknown (#794) by @lunaticusgreen in #950
- fix: preserve commas in SQL IN lists by @dajiaohuang in #948
- fix: label array/object variable options as JSON so the dropdown renders (#781) by @lunaticusgreen in #951
- chore(deps): bump go.opentelemetry.io/otel/sdk from 1.46.0 to 1.47.0 by @dependabot[bot] in #962
- fix: make query results usable in Grafana SQL expressions (#820) by @lunaticusgreen in #964
New Contributors
- @dajiaohuang made their first contribution in #948
Full Changelog: v3.5.0...v3.6.0