BetterDB Monitor

La capa de monitorización que Valkey merece.

BetterDB persiste lo que Valkey descarta: slowlogs, patrones de comandos, actividad de clientes, señales de anomalías, para que puedas depurar lo que ocurrió a las 3 de la madrugada, no solo lo que está pasando ahora. Diseñado para Valkey 8.x con soporte nativo para COMMANDLOG, CLUSTER SLOT-STATS y métricas de E/S por hilo. Compatible con Redis 6+ para todo lo demás.

Website | Docker Hub | npm | Documentation | Blog

BetterDB está desarrollado por BetterDB Inc., una empresa de beneficio público que opera bajo la OCV Open Charter.

Inicio rápido (Docker)```bash

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

Apunta tu navegador a `http://localhost:3001`. Para monitorear una instancia específica:```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

¿Te conectas a una base de datos en tu máquina host? Dentro del contenedor localhost es el propio contenedor, no tu host — así que usa host.docker.internal como host de la base de datos. En Docker Desktop (macOS/Windows) funciona sin configuración adicional; en Linux añade --add-host=host.docker.internal:host-gateway al comando docker run para que el nombre se resuelva. El botón de "conectar a instancia local" con un solo clic del dashboard lo detecta automáticamente y rellena el host correcto por ti.

Se publican dos variantes de imagen, ambas multi-arquitectura (linux/amd64, linux/arm64):

Etiqueta	Qué es
latest, X.Y.Z-no-ai	Imagen por defecto - incluye todas las funciones de monitorización, sin las dependencias para el AI Helper experimental de LLM local
X.Y.Z	Añade el AI Helper experimental (trae tu propio Ollama; deshabilitado por defecto mediante AI_ENABLED)

Consulta Docker Production Deployment para almacenamiento persistente, puertos personalizados, licencias y configuraciones air-gapped.

Inicio rápido (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

Luego `kubectl port-forward -n betterdb svc/betterdb-monitor 3001:3001` y abre `http://localhost:3001`, o habilita el ingress del chart. El historial respaldado por PostgreSQL, el uso de tus propios Secrets y las licencias en entornos aislados se cubren en la [guía de Kubernetes](https://docs.betterdb.com/kubernetes) y el [README del chart](https://github.com/betterdb-inc/monitor/blob/master/charts/betterdb-monitor/README.md).

## Inicio rápido (CLI)

Ejecuta BetterDB Monitor sin Docker:```bash
npx @betterdb/monitor

En la primera ejecución, un asistente de configuración interactivo te guía a través de la conexión a la base de datos, el backend de almacenamiento (SQLite, PostgreSQL o en memoria) y la configuración del servidor. La configuración se guarda en ~/.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

Requiere Node.js >= 20.0.0 y una instancia de Valkey o Redis que monitorizar. Para almacenamiento SQLite, también `npm install -g better-sqlite3`.

## Lo que obtienes

### Verlo todo, conservarlo todo

- **Analíticas históricas** - consulta slowlogs, patrones de comandos, actividad de clientes y latencia en cualquier rango temporal. Los datos que solían desaparecer tras una rotación de logs.
- **Soporte de COMMANDLOG** - exclusivo de Valkey 8.1+. Solicitudes y respuestas grandes, no solo las lentas.
- **Sesiones de captura MONITOR** - graba tráfico real bajo demanda: tail en vivo, filtrado, replay, exportación a JSON/CSV y referencias cruzadas con el historial de conexiones.
- **Seguimiento de hot keys** - claves más accedidas por frecuencia con movimiento de ranking a lo largo del tiempo. Key Analytics (Pro, gratis en acceso anticipado) añade distribuciones de tipo, TTL y tamaño a partir de muestreo en vivo.
- **Visibilidad de clúster** - grafos de topología, mapas de calor SLOT-STATS, CPU por slot y distribución de claves.
- **Métricas de hilos de CPU y E/S** - visibilidad por hilo que ninguna herramienta de Redis puede ofrecer.
- **Analíticas de clientes** - ve exactamente qué servicio es responsable de qué, atribuido por nombre y patrón de cliente.
- **Registro de auditoría ACL** - rastrea quién accedió a qué, persistido para cumplimiento y depuración posterior a incidentes.

### Entender y actuar

- **Detección de anomalías** (Pro, gratis en acceso anticipado) - aprendizaje automático de líneas base con eventos correlacionados y diagnósticos en lenguaje natural. Más de 20 detectores, sin umbrales manuales.
- **Previsión de capacidad** - tiempo proyectado hasta el límite para memoria, ops/seg, CPU y fragmentación.
- **Webhooks** - entregas de alertas firmadas con HMAC con reintentos y un registro completo de entregas.
- **Migración en vivo** - muévete entre Redis y Valkey con un flujo de trabajo de análisis, ejecución y validación en tres fases.

### Diseñado para la era de la IA