BetterDB Monitor

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

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

Сайт | Docker Hub | npm | Документация | Блог

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

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

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

Откройте в браузере `http://localhost:3001`. Чтобы отслеживать конкретный экземпляр:```bash
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)```bash

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](https://docs.betterdb.com/kubernetes) и [README чарта](https://github.com/betterdb-inc/monitor/blob/master/charts/betterdb-monitor/README.md).

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

Запустите BetterDB Monitor без Docker:```bash
npx @betterdb/monitor

При первом запуске интерактивный мастер настройки проведёт вас через подключение к базе данных, выбор бэкенда хранилища (SQLite, PostgreSQL или in-memory) и настройку сервера. Конфигурация сохраняется в ~/.betterdb/config.json.```bash 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 и ключей по слотам.
- **Метрики потоков CPU и I/O** — видимость по каждому потоку, которую не может предоставить ни один инструмент Redis.
- **Аналитика клиентов** — точно видно, какой сервис за что отвечает, с атрибуцией по имени и шаблону клиента.
- **Журнал аудита ACL** — отслеживание того, кто к чему обращался, с сохранением для соответствия требованиям и отладки после инцидентов.

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

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

### Создано для эпохи ИИ

- **Наблюдаемость векторного поиска** — ops/sec и задержки FT.SEARCH с состоянием каждого индекса для [valkey-search](https://github.com/valkey-io/valkey-search) и RediSearch. См. [docs/vector-ai](https://github.com/betterdb-inc/monitor/blob/master/docs/vector-ai/README.md).
- **Задержка инференса** — p50/p95/p99 по каждому индексу, с оповещениями о нарушении SLA (Pro, бесплатно в раннем доступе).
- **Интеллект семантического кэша** (Pro, бесплатно в раннем доступе) — состояние hit-rate, рекомендации по порогу схожести и рабочий процесс предложений с одобрением/отклонением. Включает наблюдаемость памяти агента.
- **Трассировки ИИ** — водопады спанов OTLP из вашего ИИ-приложения, коррелированные с живым состоянием Valkey под каждым запросом. См. [docs/opentelemetry.md](https://github.com/betterdb-inc/monitor/blob/master/docs/opentelemetry.md).

### Подключается ко всему