ClickHouse data source

The ClickHouse data source allows you to query and visualize ClickHouse data in Grafana. Use the raw SQL editor or query builder to create dashboards, time series, tables, logs, and traces.

Supported features

Feature	Supported
Metrics	Yes
Logs	Yes
Traces	Yes
Alerting	Yes
Annotations	Yes

Requirements

Grafana version	Plugin version
9.x and later	v4
8.x	v2.2.0

Note
Ad hoc filters require ClickHouse 22.7 or later (from plugin v2.0 onward).

Get started

The following documents help you get started:

Additional features

After configuring the data source, you can:

Use Explore to query data without building a dashboard
Add Transformations to manipulate query results
Set up Alerting rules

Pre-built dashboards

The plugin includes the following pre-built dashboards:

ClickHouse - Query Analysis — Query performance, time distribution, top users, and memory usage.
ClickHouse - Data Analysis — Disk usage, table and database summary, parts over time, and dictionaries.
ClickHouse - Cluster Analysis — Cluster overview, merges, mutations, and replicated table delay.
Simple ClickHouse OTel Dashboard — Traces, logs, and service performance for OpenTelemetry data in ClickHouse.
Advanced ClickHouse Monitoring Dashboard — System metrics (CPU, queries/sec, IO, memory) similar to ClickHouse built-in monitoring.

To import a pre-built dashboard:

Go to Connections > Data sources.
Select your ClickHouse data source.
Click the Dashboards tab.
Click Import next to the dashboard you want to use.

Plugin updates

Always ensure that your plugin version is up-to-date so you have access to all current features and improvements. Navigate to Plugins and data > Plugins to check for updates. Grafana recommends upgrading to the latest Grafana version, and this applies to plugins as well.