Plugins 〉TraceHouse
TraceHouse
TraceHouse for Grafana
Monitor ClickHouse merges, queries, parts, replication, and storage from Grafana.
What is TraceHouse?
TraceHouse queries ClickHouse system.* tables (parts, merges, queries, replication queue, etc.) through the Grafana ClickHouse datasource. No external agents needed.
Features
Database Explorer
Browse databases, tables, columns, and storage details.
Time Travel
Replay how tables, parts, and merges evolved over any time window. See when parts were created, merged, or moved.
Query History
Query breakdown by user, query kind, and status. Identify slow queries, see normalized query patterns, and link from query history to time-travel views.
3D Analytics
3D surface visualizations for query and merge patterns over time.
Grafana Panel Export
Export TraceHouse analytics views as native Grafana panels for dashboards and ongoing monitoring.
Learn more about Grafana panel export
System Map
Visual overview of table sizes, part counts, and storage distribution across your cluster.
Overview Dashboard
Cluster health at a glance: CPU, memory, active queries, running merges, and replication lag across all nodes.
Merge Tracker
Real-time merge monitoring with per-merge progress bars, throughput, elapsed/remaining time, and X-ray detail view.
Engine Internals
Inspect MergeTree parts, partitions, storage policies, and data distribution.
Cluster Topology
Multi-node view with shard/replica status and per-node resource utilization.
Replication
Replication queue depth, log lag, and inter-replica sync status.
Requirements
- Grafana >= 11.6.11 <12, >=12.0.10 <12.1, >=12.1.7 <12.2, or >=12.2.5
- ClickHouse 21.8+ with
system.*tables accessible - Grafana ClickHouse datasource plugin installed and configured
Getting Started
- Install the plugin from the Grafana plugin catalog or side-load the signed zip
- Enable the plugin under Administration > Plugins > TraceHouse
- Ensure you have a ClickHouse datasource configured pointing to your cluster
- Open TraceHouse from the sidebar and start exploring
Configuration
Go to the TraceHouse Configuration page to set:
- Allowed Refresh Rates — Control which auto-refresh intervals are available. Disabling aggressive rates (1s, 2s) reduces load on your ClickHouse cluster.
- Default Refresh Rate — The refresh interval applied when a user first opens any TraceHouse page.
Documentation
License
Apache 2.0 — see LICENSE for details.
Grafana Cloud Free
- Free tier: Limited to 3 users
- Paid plans: $55 / user / month above included usage
- Access to all Enterprise Plugins
- Fully managed service (not available to self-manage)
Self-hosted Grafana Enterprise
- Access to all Enterprise plugins
- All Grafana Enterprise features
- Self-manage on your own infrastructure
Grafana Cloud Free
- Free tier: Limited to 3 users
- Paid plans: $55 / user / month above included usage
- Access to all Enterprise Plugins
- Fully managed service (not available to self-manage)
Self-hosted Grafana Enterprise
- Access to all Enterprise plugins
- All Grafana Enterprise features
- Self-manage on your own infrastructure
Grafana Cloud Free
- Free tier: Limited to 3 users
- Paid plans: $55 / user / month above included usage
- Access to all Enterprise Plugins
- Fully managed service (not available to self-manage)
Self-hosted Grafana Enterprise
- Access to all Enterprise plugins
- All Grafana Enterprise features
- Self-manage on your own infrastructure
Grafana Cloud Free
- Free tier: Limited to 3 users
- Paid plans: $55 / user / month above included usage
- Access to all Enterprise Plugins
- Fully managed service (not available to self-manage)
Self-hosted Grafana Enterprise
- Access to all Enterprise plugins
- All Grafana Enterprise features
- Self-manage on your own infrastructure
Grafana Cloud Free
- Free tier: Limited to 3 users
- Paid plans: $55 / user / month above included usage
- Access to all Enterprise Plugins
- Fully managed service (not available to self-manage)
Self-hosted Grafana Enterprise
- Access to all Enterprise plugins
- All Grafana Enterprise features
- Self-manage on your own infrastructure
Install on Grafana Cloud
Plugins can be installed directly from within your Grafana instance or automated using the Cloud API or Terraform.
Learn more about plugin installationMarketplace plugins
This is a paid plugin developed by a marketplace partner. To purchase an entitlement, sign in first, then fill out the contact form.
Get this plugin
This is a paid for plugin developed by a marketplace partner. To purchase entitlement please fill out the contact us form.
What to expect:
- Grafana Labs will reach out to discuss your needs
- Payment will be taken by Grafana Labs
- Once purchased the plugin will be available for you to install (cloud) or a signed version will be provided (on-premise)
Thank you! We will be in touch.
For more information, visit the docs on plugin installation.
Installing on a local Grafana:
For local instances, plugins are installed and updated via a simple CLI command. Plugins are not updated automatically, however you will be notified when updates are available right within your Grafana.
1. Install the Application
Use the grafana-cli tool to install TraceHouse from the commandline:
grafana-cli plugins install The plugin will be installed into your grafana plugins directory; the default is /var/lib/grafana/plugins. More information on the cli tool.
Alternatively, you can manually download the .zip file for your architecture below and unpack it into your grafana plugins directory.
Alternatively, you can manually download the .zip file and unpack it into your grafana plugins directory.
2. Enable it
Next, log into your Grafana instance. Navigate to the Plugins section, found in your Grafana main menu.
Click the Apps tabs in the Plugins section and select the newly installed app.
To enable the app, click the Config tab. Follow the instructions provided with the application and click Enable. The app and any new UI pages are now accessible from within the main menu, as designed by the app creator.
If dashboards have been included with the application, they will attempt to be automatically installed. To view the dashboards, re-import or delete individual dashboards, click the Dashboards tab within the app page.
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.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
