chmonitor — ClickHouse Monitoring Dashboard

Answers to common questions about connection errors, missing system tables, authentication, multi-host setup, and the AI agent.

Quick answers to the questions that come up most often when you run chmonitor: connection failures, empty pages, authentication, multi-host setup, the AI agent, and deployment. Expand any question below.

Common questions

Enable system tables

Turn on the ClickHouse logs and system tables the dashboard reads.

Authentication

Require login and gate features with Clerk or per-feature access rules.

Install & Configure

Platform-specific deployment guides for Docker, Kubernetes, and Cloudflare.

Environment variables

Every CHM_ and CLICKHOUSE_ setting the dashboard reads.

FAQ

Common questions

Enable system tables

Authentication

Install & Configure

Environment variables

On this page

FAQ

Common questions

The dashboard shows a connection error.

I changed ClickHouse credentials but the dashboard still fails.

Some pages are empty or show "table not found".

The query thread analysis page is empty.

ZooKeeper / Keeper pages are missing.

How do I require login before anyone can use the dashboard?

I want to protect specific features but not the whole dashboard.

The AI agent is accessible without login. Is that safe?

How do I monitor multiple ClickHouse clusters?

The agent returns errors or doesn't respond.

The agent can't kill queries or run OPTIMIZE.

Agent conversation history disappears after I close the browser.

The dashboard shows stale data.

Which deployment should I use?

Related

Enable system tables

Authentication

Install & Configure

Environment variables

On this page