chmonitor/chmonitor

chmonitor – ClickHouse 运维顾问

它是什么 – 一个基于 Web 的仪表板（以及终端 UI），可连接一个或多个 ClickHouse 服务器，读取内置的 system.* 表，并实时展示集群健康、查询活动、存储使用、复制状态等。它还包含一个由 AI 驱动的“顾问”，可以建议 schema 或查询优化，例如投影、跳数索引、PREWHERE 子句或物化视图。

主要功能

功能	你获得的内容
集群概览	拓扑图、健康检查、超过 30 个实时图表，显示查询量、延迟、写入数据、合并等。
查询洞察	列出正在运行、慢查询、失败和历史查询；带历史和 EXPLAIN 的只读 SQL 控制台。
存储与数据	表大小、分区、压缩比、TTL 设置的资源管理器。
复制健康	查看合并、变更、复制队列和 ClickHouse Keeper 法定人数。
AI 顾问	内置聊天式代理（通过 MCP 使用 Claude / Cursor），可以回答关于 schema、性能的英文问题，并建议优化。
CLI / TUI	chm 命令提供终端 UI 和 chm doctor 健康检查快捷方式。
多主机支持	从单个仪表板监控多个 ClickHouse 实例。

如何运行

• Docker（最快）：docker run -d -p 3000:3000 -e CLICKHOUSE_HOST=… -e CLICKHOUSE_USER=default -e CLICKHOUSE_PASSWORD=change-me ghcr.io/chmonitor/chmonitor:0.3.7 然后打开 http://localhost:3000。
• 其他部署：Kubernetes 的 Helm chart、Cloudflare Workers，或 Railway/Render/Fly 的一键脚本。本地开发说明在文档中。
• CLI：curl -sSf https://chmonitor.dev/install.sh | bash && chm doctor 提供终端视图。

AI 集成 仪表板附带一个“AI 代理”，通过 MCP 协议与 Claude 或 Cursor 通信。用户可以输入自然语言问题（例如，“如何加速这个查询？”）并获得具体建议（添加投影、创建跳数索引等）。代理在本地运行；它不会自动执行 DDL——建议仅供参考。

许可与版本

• 核心软件是 GPL-3.0，可以免费自托管，主机数量不限。
• 可选商业许可证提供支持合同，并可将购买者列为赞助商；它不会解锁额外功能。
• 定价层级：个人版（免费）、团队版（$499/年）、无限版（$999/年），并提供相应的终身购买选项。

适用对象

• 需要单一视图查看集群性能的 ClickHouse DBA 和开发人员。
• 希望获得 AI 驱动提示，但不想让工具拥有数据库写权限的团队。
• 在本地、Docker/K8s 或 ClickHouse Cloud 上运行 ClickHouse 的任何人。

了解更多

• 实时演示：https://dash.chmonitor.dev/overview?host=0
• 完整文档：https://docs.chmonitor.dev
• 源代码和发布版本在 GitHub 上；Docker 镜像发布在 GitHub Container Registry 上。

---

以上所有信息均直接取自仓库的 README。