chmonitor: мониторинг ClickHouse с AI-рекомендациями по оптимизации

22.09.2026 chmonitor/chmonitor TypeScript ★ 296 Self-hosted 4 мин

chmonitor — это open-source инструмент для мониторинга ClickHouse с рекомендациями по улучшению производительности на основе AI. Он позволяет отслеживать состояние кластера в реальном времени, показывая активные запросы, процессы слияния и состояние репликации, после чего предлагает изменения, например, по индексам или материализованным видам.

Этот проект отличается от традиционных мониторинговых систем тем, что он использует данные из системных таблиц и предоставляет AI-советы, а не только визуализирует метрики. Его могут использовать как разработчики, так и администраторы баз данных, которым нужен подробный анализ и рекомендации по оптимизации работы ClickHouse.

Запускать chmonitor можно через Docker, что упрощает процесс развертывания. Имей в виду, что инструмент еще находится в стадии активной разработки, так что могут быть недоработки или недоступные функции. Также не забывай: chmonitor не применяет изменения сам, а только предлагает, что в итоге делает его безопаснее в использовании.

**chmonitor** — это инструмент, разработанный для мониторинга и улучшения работы кластеров ClickHouse. Он предоставляет пользователям дашборд, который делает доступной информацию о работе кластера, включая выполнение запросов, слияние данных, репликацию, состояние хранилища и общую здоровье системы. При этом chmonitor предлагает рекомендации по настройкам, хотя и не применяет изменения автоматически.

Проект можно развернуть в различных средах, включая Docker, Kubernetes и на физических серверах. При этом доступна и бесплатная версия с лицензией GPL-3.0, а также платные возможности для предприятий.

Что умеет chmonitor

Отображение состояния кластера с помощью инфографиков и диаграмм.
Мониторинг запросов — активные, медленные и исторические.
Анализ хранимых данных: размеры таблиц, части, сжатие и настройки времени жизни данных (TTL).
Обеспечение здоровья реплик — управление слиянием, мутациями и очередями репликации.
Интеллектуальные рекомендации по использованию: проекции, индексы и прочие оптимизации.
Взаимодействие с помощью встроенного AI-агента, который позволяет задавать вопросы на естественном языке.
Работа с командной строки через интерфейс [`chm` CLI].

Установка и запуск

Чтобы быстро начать, нужно развернуть лишь один контейнер, указав доступ к запущенному ClickHouse:

docker run -d --name chmonitor -p 3000:3000 \
  -e CLICKHOUSE_HOST=https://clickhouse.example.com:8443 \
  -e CLICKHOUSE_USER=default \
  -e CLICKHOUSE_PASSWORD=change-me \
  ghcr.io/chmonitor/chmonitor:v0.3.0

После запуска открой в браузере http://localhost:3000. Рекомендуется использовать фиксированную версию в продуктиве, в то время как `:latest` стоит применять только для тестирования.

Чтобы установить CLI, нужно выполнить следующие команды:

curl -sSf https://chmonitor.dev/install.sh | bash
chm doctor

Развёртывание

Настройки подключения к ClickHouse (HOST, USER, PASSWORD) остаются одинаковыми для всех сред развертывания. Возможности по развёртыванию включают:

Docker
Kubernetes (Helm)
Cloudflare Workers
Railway / Render / Fly (один клик)
Локальная разработка

Редакции

Существует две версии: Community (бесплатная) и Enterprise (платная). Обе версии основаны на одной кодовой базе:

Community: бесплатная, с открытым исходным кодом (GPL-3.0).
Enterprise: платная версия с дополнительными функциями и поддержкой, цена зависит от количества хостов.

Дополнительные детали можно найти в документации по [редакциям](https://docs.chmonitor.dev/operate/advanced/editions).

Документация и поддержка

Документация по проекту доступна на [официальном сайте](https://docs.chmonitor.dev), где можно найти информацию о первых шагах, установке, а также о работе с AI-агентом и командой.

Открыть на GitHub: chmonitor/chmonitor →

Что нового на GitHub — короткие обзоры на русском Новые обзоры приходят в Telegram. Без спама, по делу.