Changelog

All notable changes to the TraceHouse Grafana plugin will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[0.19.1] - 2026-09-14

Improvements

• Query Details: Redesigned the Overview tab: identity and status on one line, the SQL and any error, one summary block, then the links to the other tabs.
• Overview: Redesigned the main page: a compact vitals row, and uniform destination cards that each lead with the question they answer instead of a per-card mix of sparklines and bars.
• Time Travel: The Operations table now shows a plain User column, and only labels a merge when its reason is notable (TTL, mutation, lightweight delete).

Bug fixes

• X-Ray / Time Travel: Fixed missing labels in the 3D views when TraceHouse is opened from a local file.

[0.19.0] - 2026-09-12

New features

• Query Details: New Flow view on the Distributed tab, showing an execution step by step across initiator and shards.
• Query Details: Overview now splits query time into work and waiting (CPU, queue, disk, network), plus a "Parked" remainder.
• Analytics: New "Wait Breakdown" dashboard: work vs waiting per query shape, over time, and by user.
• Link Sharing: Every page now keeps its state in the URL, so a shared link reopens the same view, filters, and time range.

Improvements

• System Map: Added light mode and more metrics, simplified the map, and refreshed the catalog to ClickHouse 26.8.
• X-Ray: Disk, CPU, and network wait are now shown separately instead of as one figure.
• Time Travel: The separate query, merge, and mutation tables below the timeline are now one Operations list, sortable by memory, CPU, network, or disk.
• Merges: A TTL merge that drops a whole part is now labelled as such, not as no rows removed.
• Query Details: The time breakdown now names the thread time and thread count behind it, giving the "Parked" share context.

Bug fixes

• Queries: Sorting by a column other than start time now ranks running and completed queries as one list.
• Copying SQL, links, and tables now works when TraceHouse is served over plain HTTP.

Security

• Updated the js-cookie and uuid dependencies to address npm audit findings.

[0.18.6] - 2026-08-17

Improvements

• Monitoring Capabilities: Unavailable features now indicate whether they require a newer ClickHouse version or simply need to be enabled.
• Analytics: Renamed the "App Query Cost" dashboard to "TraceHouse Query Cost".
• Analytics: Cosmetic fixes to Dashboard Focus mode.

Bug fixes

• Grafana: Fixed the navigation menu and breadcrumb staying on the previous page.

[0.18.5] - 2026-08-05

Improvements

• Time Travel: Added a link to the Analytics "Workload Breakdown" dashboard for a precise view of the sampled totals.

Bug fixes

• Database, table, and column names are now escaped in queries, fixing identifiers that contain backticks or backslashes.

[0.18.4] - 2026-07-31

Improvements

• Merges: Failed merges and mutations can now be filtered by one or more ClickHouse error codes, with suggestions based on the current results.
• Events: Added a Merges lane for failed merges, mutations, and MergeTree part operations.

Bug fixes

• Merges: Fixed a bug where filters ran after the result limit, causing failed merges to be missed.
• Merges: Fixed failed details being replaced by another replica's successful merge.
• Queries / Merges: Fixed running activity outside the selected time range.

[0.18.3] - 2026-07-31

Improvements

• Queries / Merges: You can now select multiple values for the same filter and use quick presets for running, recent, failed, and slow activity.
• Queries: Failed queries can now be filtered by one or more ClickHouse error codes, with suggestions based on the current results.
• Time Travel: Enhanced the timeline navigator with Average, Maximum, and Change views, adaptive scales, and smooth navigation through historical data.
• Events: Reduced initial collection to 100 events per source and added a visible truncation indicator.
• Analytics Dashboards: Panels that require a newer ClickHouse version now show a clear compatibility message instead of failing.

Bug fixes

• Events: Fixed event lists failing to load on ClickHouse versions earlier than 24.1 by using a compatible query when distributed LIMIT BY is unavailable.
• Queries: Query history now includes ClickHouse ExceptionBeforeStart errors, and server filters use the server's actual hostName() instead of connection aliases. Query details now also load on ClickHouse 23.8.
• Mutations: Fixed the Mutations view on ClickHouse 23.8. Active and completed mutations now load, with a warning that this version cannot identify killed mutations.
• Distributed Query Analysis: The query topology view now works on ClickHouse 23.8 through 24.8. These versions provide less processor detail than ClickHouse 25.3+, so TraceHouse uses the available query data and explains the limitation.
• Grafana: Preserved repeated URL parameters so multi-value filters survive navigation and reloads.
• Cluster Connections: Feature availability is now rechecked after connecting to or switching clusters, preventing stale results and unnecessary errors in ClickHouse logs.

Security

• Updated DOMPurify and Immutable dependencies to address npm audit findings.

[0.18.2] - 2026-07-29

Improvements

• Time Travel: Added Overall and Per server views with multi-server selection.
• Time Travel: Overall CPU and memory now use total usage and capacity across selected servers.

[0.18.1] - 2026-07-27

Bug fixes

• Fixed time-range handling across Events, Analytics, Queries, Merges, and Time Travel by normalizing custom ranges and generated ClickHouse timestamps to explicit UTC, preventing time shifts when the browser and ClickHouse server use different time zones.

[0.18.0] - 2026-07-27

New features

• Events: New view for investigating errors, failures, restarts, and related ClickHouse activity.
• Time Travel: Added event correlation to the Timeline.
• Query Analysis: Added EXPLAIN ANALYZE.
• Analytics / Dashboards: Added Focus mode for exploring large dashboards one panel at a time.

Improvements

• Reorganized the top navigation and grouped additional functionality under More.
• Queries / Merges: Unified running and historical activity in a consistent view.

Bug fixes

• Fixed a CSS issue affecting the Running and History tabs on the Queries and Merges pages.

[0.10.0] - 2026-02-17

Features

• Analytics page with 3D surface visualizations for query and merge patterns
• Merge tracker with real-time progress, throughput, and X-ray drill-down
• Time Travel replay for parts, merges, and table evolution over any time window
• Query analysis with breakdowns by user, query kind, and status
• Cluster topology view with shard/replica status and resource utilization
• Engine Internals browser for MergeTree parts, partitions, and storage policies
• Database Explorer for browsing tables, columns, and storage details
• Replication monitoring with queue depth, log lag, and sync status
• Overview dashboard with cluster health: CPU, memory, queries, merges, replication lag
• Configurable refresh rates with admin controls to limit aggressive polling