BetterDB Monitor

Слой мониторинга, которого заслуживает Valkey.

BetterDB сохраняет то, что Valkey выбрасывает — slowlog, шаблоны команд, активность клиентов, сигналы аномалий — чтобы вы могли разобраться, что произошло в 3 часа ночи, а не только в том, что происходит сейчас. Создан для Valkey 8.x с нативной поддержкой COMMANDLOG, CLUSTER SLOT-STATS и метрик ввода-вывода по потокам. Совместим с Redis 6+ для всего остального.

Website | Docker Hub | npm | Documentation | Blog

BetterDB создан компанией BetterDB Inc. — public benefit company, работающей в соответствии с OCV Open Charter.

BetterDB Monitor - Key Analytics with per-type key size distribution histograms

Быстрый старт (Docker)

docker run -d --name betterdb -p 3001:3001 betterdb/monitor:latest

Откройте в браузере http://localhost:3001. Чтобы отслеживать конкретный экземпляр:

docker run -d \
  --name betterdb \
  -p 3001:3001 \
  -e DB_HOST=your-valkey-host \
  -e DB_PORT=6379 \
  -e DB_PASSWORD=your-password \
  betterdb/monitor:latest

Подключение к базе данных на вашей хост-машине? Внутри контейнера localhost — это сам контейнер, а не ваш хост, поэтому используйте host.docker.internal в качестве хоста базы данных. В Docker Desktop (macOS/Windows) это работает из коробки; в Linux добавьте --add-host=host.docker.internal:host-gateway в команду docker run, чтобы это имя разрешалось. Кнопка «подключиться к локальному экземпляру» в дашборде автоматически определяет это и подставляет нужный хост за вас.

Публикуются два варианта образа, оба мультиархитектурные (linux/amd64, linux/arm64):

Тег	Что это
`latest`, `X.Y.Z-no-ai`	Образ по умолчанию — все функции мониторинга включены, без зависимостей для экспериментального локального LLM AI Helper
`X.Y.Z`	Добавляет экспериментальный AI Helper (используйте свой Ollama; отключён по умолчанию через `AI_ENABLED`)

См. Docker Production Deployment для постоянного хранилища, пользовательских портов, лицензирования и настроек для изолированных сред.

Быстрый старт (Kubernetes / Helm)

helm repo add betterdb https://docs.betterdb.com/charts
helm repo update
helm install betterdb-monitor betterdb/betterdb-monitor \
  --namespace betterdb --create-namespace \
  --set db.host=my-valkey.default.svc.cluster.local \
  --set db.password=yourpassword

Затем kubectl port-forward -n betterdb svc/betterdb-monitor 3001:3001 и откройте http://localhost:3001, или включите ingress в чарте. История на базе PostgreSQL, использование собственных Secrets и лицензирование в изолированных средах описаны в руководстве по Kubernetes и README чарта.

Быстрый старт (CLI)

Запустите BetterDB Monitor без Docker:

npx @betterdb/monitor

При первом запуске интерактивный мастер настройки проведёт вас через подключение к базе данных, выбор хранилища (SQLite, PostgreSQL или in-memory) и настройку сервера. Конфигурация сохраняется в ~/.betterdb/config.json.

npm install -g @betterdb/monitor   # global install
betterdb --setup                   # re-run setup wizard
betterdb --port 8080               # override server port
betterdb --db-host 1.2.3.4         # override database host
betterdb --help                    # all options

Требуется Node.js >= 20.0.0 и экземпляр Valkey или Redis для мониторинга. Для хранения в SQLite также npm install -g better-sqlite3.

Что вы получаете

Видеть всё, сохранять всё

Историческая аналитика — запрашивайте slowlog, шаблоны команд, активность клиентов и задержки за любой период времени. Данные, которые раньше исчезали после ротации логов.
Поддержка COMMANDLOG — эксклюзивно для Valkey 8.1+. Большие запросы и большие ответы, а не только медленные.
Сессии захвата MONITOR — запись реального трафика по требованию: живой просмотр, фильтрация, воспроизведение, экспорт в JSON/CSV и сопоставление с историей подключений.
Отслеживание горячих ключей — топ ключей по частоте обращений с изменением ранга во времени. Key Analytics (Pro, бесплатно в раннем доступе) добавляет распределения по типу, TTL и размеру на основе живой выборки.
Видимость кластера — графы топологии, тепловые карты SLOT-STATS, распределение CPU и ключей по слотам.
Авторегистрация кластера — подключение к кластеру может автоматически регистрировать каждый узел как отдельное отслеживаемое подключение, синхронизируясь по мере масштабирования кластера. См. docs/cluster-auto-registration.md.
Метрики потоков CPU и I/O — видимость по потокам, которую не может предоставить ни один инструмент Redis.
Аналитика клиентов — точно видно, какой сервис за что отвечает, с атрибуцией по имени и шаблону клиента.
Журнал аудита ACL — отслеживание, кто к чему обращался, с сохранением для соответствия требованиям и отладки после инцидентов.

Понимать и действовать

Обнаружение аномалий (Pro, бесплатно в раннем доступе) — автоматическое изучение базовой линии с коррелированными событиями и диагнозами на простом языке. Более 20 детекторов, без ручных порогов.
Прогнозирование ёмкости — прогнозируемое время до достижения предела для памяти, операций/сек, CPU и фрагментации.
Вебхуки — доставка оповещений с подписью HMAC, с повторными попытками и полным журналом доставки.
Живая миграция — переключение между Redis и Valkey с трёхфазным рабочим процессом анализа, выполнения и валидации.

monitor v0.41.0