chmonitor/chmonitor

chmonitor – ClickHouse 운영 어드바이저

개요 – 하나 이상의 ClickHouse 서버에 연결하여 내장된 system.* 테이블을 읽고 클러스터 상태, 쿼리 활동, 스토리지 사용량, 복제 상태 등의 실시간 뷰를 제공하는 웹 기반 대시보드(및 터미널 UI)입니다. 또한 프로젝션, 스킵 인덱스, PREWHERE 절, 구체화된 뷰와 같은 스키마 또는 쿼리 최적화를 제안할 수 있는 AI 기반 "어드바이저"도 포함합니다.

주요 기능

기능	제공 내용
클러스터 개요	토폴로지 맵, 상태 점검, 쿼리 볼륨, 지연 시간, 기록된 데이터, 병합 등을 보여주는 30개 이상의 실시간 차트
쿼리 인사이트	실행 중, 느린, 실패한, 과거 쿼리 목록; 기록 및 EXPLAIN을 지원하는 읽기 전용 SQL 콘솔
스토리지 및 데이터	테이블 크기, 파트, 압축 비율, TTL 설정 탐색기
복제 상태	병합, 변형, 복제 큐 및 ClickHouse Keeper 쿼럼 뷰
AI 어드바이저	스키마, 성능에 대한 영어 질문에 답하고 최적화를 제안할 수 있는 내장 채팅형 에이전트(Claude / Cursor via MCP)
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에서 직접 가져온 것입니다.