chmonitor/chmonitor

chmonitor – ClickHouse 用オペレーショナルアドバイザー

概要 – 1つ以上のClickHouseサーバーに接続し、組み込みのsystem.*テーブルを読み取り、クラスターの健全性、クエリアクティビティ、ストレージ使用量、レプリケーションステータスなどのライブビューを表示するWebベースのダッシュボード（およびターミナルUI）です。また、プロジェクション、スキップインデックス、PREWHERE句、マテリアライズドビューなどのスキーマやクエリの最適化を提案できるAI搭載の「アドバイザー」も含まれています。

主な機能

機能	内容
クラスター概要	トポロジーマップ、ヘルスチェック、クエリ量、レイテンシ、書き込みデータ、マージなどを示す30以上のリアルタイムチャート
クエリインサイト	実行中、低速、失敗、履歴クエリのリスト表示。履歴とEXPLAINを備えた読み取り専用SQLコンソール
ストレージとデータ	テーブルサイズ、パーツ、圧縮率、TTL設定のエクスプローラー
レプリケーション健全性	マージ、ミューテーション、レプリケーションキュー、ClickHouse Keeperクォーラムのビュー
AIアドバイザー	スキーマ、パフォーマンスに関する英語の質問に答え、最適化を提案できる組み込みのチャットスタイルエージェント（MCP経由のClaude / Cursor）
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チャート、Cloudflare Workers、Railway/Render/Fly用のワンクリックスクリプト。ローカル開発手順はドキュメントに記載されています。
• CLI: curl -sSf https://chmonitor.dev/install.sh | bash && chm doctor でターミナルビューを表示します。

AI統合 ダッシュボードには、MCPプロトコルを介してClaudeまたはCursorと通信する「AIエージェント」が同梱されています。ユーザーは自然言語の質問（例：「このクエリを高速化するにはどうすればよいですか？」）を入力でき、具体的な提案（プロジェクションの追加、スキップインデックスの作成など）を受け取れます。エージェントはローカルで実行され、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から直接取得したものです。