RepoRadar chmonitor: мониторинг ClickHouse с AI-рекомендациями по оптимизации
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-агентом и командой.
Радар проекта: 74 из 100 — крепкий проект
- Импульс 3 ≈ 4 звезды в месяц
- Темп разработки 100 862 коммита за 12 недель
- Зрелость 100 проекту 2 года, больше 100 релизов
- Сообщество 48 13 участников, 49 форков
- Свежесть 96 последний коммит — 7 дней назад
- Быстрый старт 90 есть: команда установки, Docker, сайт/демо
- Готовность к продакшену 85 релиз v0.3.11, автосборка, тесты
- Безопасность и доверие 75 лицензия GPL-3.0, организация
- Документация 89 README 7.5 тыс. знаков, 8 разделов, папка docs
- Экосистема 51 2 подписчика на обновления, 12 тем
Как считаем
Только открытые данные GitHub на 07.11.2026, без оценок нейросети. Каждая ось — от 0 до 100, итог — среднее.
- Импульс — звёзд в день: за время наших замеров, а пока их нет — за всю жизнь проекта; 200 в день — максимум.
- Темп разработки — коммитов за последние 12 недель; 300 — максимум. Пока GitHub не досчитал статистику, ось не учитывается.
- Зрелость — возраст проекта (3 года — максимум) и число релизов (30 — максимум), поровну.
- Сообщество — участников с коммитами (200 — максимум) и форков (5000 — максимум), поровну.
- Свежесть — дней с последнего коммита: сегодня — 100, полгода и больше или архив — 0.
- Быстрый старт — в README есть команда установки, раздел «быстрый старт» или примеры использования, в репозитории — Docker и папка примеров, у проекта есть сайт или демо.
- Готовность к продакшену — релизы, версия 1.0 и выше, автосборка (GitHub Actions), тесты, лицензия, журнал изменений.
- Безопасность и доверие — открытая лицензия (своя — половина балла), политика безопасности (SECURITY.md), проект организации, правила для участников, не в архиве.
- Документация — объём и структура README, папка docs или сайт, оценка «здоровья сообщества» GitHub.
- Экосистема — звёзды (50 тыс. — максимум), подписчики на обновления (1000 — максимум), темы репозитория.
Открыть на GitHub: chmonitor/chmonitor →
