Откройте в браузере `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

Затем `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

Требуется 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).

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

- **MCP-сервер** — 60 инструментов для Claude Code, Cursor или любого MCP-клиента через [`@betterdb/mcp`](https://github.com/betterdb-inc/monitor/blob/master/packages/mcp).
- **Эндпоинт Prometheus** — более 100 метрик `betterdb_*`. См. [docs/prometheus-metrics.md](https://github.com/betterdb-inc/monitor/blob/master/docs/prometheus-metrics.md).
- **OpenTelemetry** — приём трассировок OTLP и зеркалирование метрик и событий в любой бэкенд OTLP. См. [docs/opentelemetry.md](https://github.com/betterdb-inc/monitor/blob/master/docs/opentelemetry.md).
- **REST API** — всё в UI является вызовом API, документированным через OpenAPI.

## Доступ к данным на ваших условиях

| Интерфейс | Детали |
|-----------|---------|
| Веб-интерфейс | `http://localhost:3001` |
| MCP-сервер | `npx @betterdb/mcp` (stdio) — создайте токен в разделе Settings → MCP Tokens (обязательно в облаке, опционально при самостоятельном размещении) |
| Prometheus | `http://localhost:3001/api/prometheus/metrics` |
| REST API (OpenAPI) | `http://localhost:3001/docs` |
| Проверка работоспособности | `http://localhost:3001/api/health` |

> **Примечание**: В production-сборках (Docker, CLI) маршруты API обслуживаются с префиксом `/api`. В локальной разработке (`pnpm dev`) префикса нет — например, `http://localhost:3001/health`.

## Поддерживаемые базы данных

| База данных | Минимальная версия | Поддерживаемые возможности |
|----------|----------------|-------------------|
| **Valkey** | 8.0+ | Все возможности, включая COMMANDLOG (8.1+) и CLUSTER SLOT-STATS |
| **Redis** | 6+ | Все возможности, кроме эксклюзивных для Valkey COMMANDLOG и CLUSTER SLOT-STATS |

Бэкенд использует унифицированный адаптер поверх совместимого по протоколу клиента `iovalkey` и автоматически определяет Valkey или Redis по ответу `INFO` (`DB_TYPE=auto`). Такие возможности, как COMMANDLOG и SLOT-STATS, определяются по версии, и UI корректно деградирует, когда возможность недоступна.

Управляемые сервисы также поддерживаются — руководства для AWS ElastiCache, MemoryDB, Redis Cloud и Upstash находятся в [docs/providers](https://github.com/betterdb-inc/monitor/blob/master/docs/providers), а [`@betterdb/agent`](https://github.com/betterdb-inc/monitor/blob/master/packages/agent) достигает экземпляров, доступных только из VPC, через исходящий WebSocket.

## Production-развёртывание в Docker

Docker-образ содержит приложение мониторинга (бэкенд + фронтенд). Требуется:
1. Экземпляр Valkey/Redis для мониторинга
2. Экземпляр PostgreSQL для хранения данных (или используйте хранение в памяти)

### Запуск с хранением в PostgreSQL```bash
docker run -d \
  --name betterdb-monitor \
  -p 3001:3001 \
  -e DB_HOST=your-valkey-host \
  -e DB_PORT=6379 \
  -e DB_PASSWORD=your-password \
  -e STORAGE_TYPE=postgres \
  -e STORAGE_URL=postgresql://user:pass@postgres-host:5432/dbname \
  betterdb/monitor

### Запуск с сетью хоста (доступ к локальным сервисам)

Если ваш Valkey и PostgreSQL работают на одном хосте:```bash
docker run -d \
  --name betterdb-monitor \
  --network host \
  -e DB_HOST=localhost \
  -e DB_PORT=6380 \
  -e DB_PASSWORD=devpassword \
  -e STORAGE_TYPE=postgres \
  -e STORAGE_URL=postgresql://dev:devpass@localhost:5432/postgres \
  betterdb/monitor

Проверьте с помощью `GET /api/license/status` → `source: offline-token`, `mode: offline`,
`airGapped: true`.

> **Сохранение состояния:** смонтируйте доступный для записи том в `/app/data`, чтобы офлайн-лицензия и
> токен онлайн-льготного периода при сбое сохранялись между перезапусками. Контейнер работает от **UID 1001**,
> поэтому только что созданный том необходимо `chown` на этот UID (показано выше) — иначе
> сохранение состояния завершится ошибкой `EACCES … license.jwt`.

Полный порядок действий, приоритет проверки и инструкцию по ротации ключей см. в
**[Офлайн- и air-gapped-лицензии](https://github.com/betterdb-inc/monitor/blob/master/docs/offline-licenses.md)** и
**[Справочнике по конфигурации](https://github.com/betterdb-inc/monitor/blob/master/docs/configuration.md#license-configuration)**.

### Сведения об образе Docker

- **Базовый образ**: `node:20-alpine`
- **Сжатый размер**: ~360MB (`latest` / `-no-ai`) / ~640MB (версионированный образ с локальными LLM-зависимостями экспериментального AI Helper)
- **Платформы**: `linux/amd64`, `linux/arm64`
- **Содержит**: Backend API + статические файлы Frontend (обслуживаются Fastify)
- **Исключено**: поддержка SQLite (используйте PostgreSQL или Memory storage)

### Операции с контейнером```bash
docker logs -f betterdb-monitor        # follow logs
docker stop betterdb-monitor           # stop
docker rm betterdb-monitor             # remove

Полный справочник по метрикам: [docs/prometheus-metrics.md](https://github.com/betterdb-inc/monitor/blob/master/docs/prometheus-metrics.md) и [docs/prometheus-integration.md](https://github.com/betterdb-inc/monitor/blob/master/docs/prometheus-integration.md).

## Разработка

### Структура проекта```
betterdb-monitor/
├── apps/
│   ├── api/                 # NestJS backend (Fastify)
│   └── web/                 # React frontend (Vite)
├── packages/                # Published packages (see below)
├── docs/                    # Documentation site (Jekyll)
├── docker-compose.yml       # Local Valkey (port 6380) and Redis (port 6382) for testing
└── package.json             # Workspace root

Для подключения к Redis вместо Valkey установите `DB_PORT=6382` в `.env`.```bash
pnpm dev:api           # API only
pnpm dev:web           # frontend only
pnpm docker:dev:down   # stop local databases
pnpm build             # production build
pnpm test              # API tests

### Добавление новых функций

1. Добавьте новые эндпоинты в `apps/api/src/`
2. Добавьте соответствующие вызовы API в `apps/web/src/api/`
3. Добавьте общие типы в `packages/shared/src/types/`

### Стиль кода

- TypeScript strict mode, явные возвращаемые типы, без `any`
- Настроены ESLint + Prettier

## Лицензия

- Содержимое в `docs/` лицензировано под CC BY-SA 4.0.
- Содержимое в `proprietary/` покрывается коммерческой лицензией (см. `proprietary/LICENSE`). Эти функции бесплатны в период раннего доступа.
- Всё остальное — [MIT](https://github.com/betterdb-inc/monitor/blob/master/LICENSE).