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 qué 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.

Sitio web | Docker Hub | npm | Documentación | Blog

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

Inicio rápido (Docker)

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

Apunta tu navegador a http://localhost:3001. Para monitorear una instancia específica:

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 un solo clic "conectar a instancia local" del panel lo detecta automáticamente y rellena el host correcto por ti.

Se publican dos variantes de imagen, ambas multiarquitectura (linux/amd64, linux/arm64):

Etiqueta	Qué es
latest, X.Y.Z-no-ai	Imagen predeterminada - incluye todas las funciones de monitorización, sin las dependencias del AI Helper local-LLM experimental
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 en entornos aislados.

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

Luego kubectl port-forward -n betterdb svc/betterdb-monitor 3001:3001 y abra http://localhost:3001, o habilite el ingress del chart. El historial respaldado por PostgreSQL, el uso de sus propios Secrets y las licencias para entornos aislados (air-gapped) están cubiertos en la guía de Kubernetes y el README del chart.

Inicio rápido (CLI)

Ejecute BetterDB Monitor sin Docker:

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.

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 el almacenamiento en SQLite, también npm install -g better-sqlite3.

Lo que obtienes

Verlo todo, conservarlo todo

• Analítica histórica - consulta slowlogs, patrones de comandos, actividad de clientes y latencia en cualquier rango temporal. Los datos que antes desaparecían 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: seguimiento en vivo, filtrado, reproducción, exportación a JSON/CSV y correlación cruzada con el historial de conexiones.
• Seguimiento de hot keys - claves más accedidas por frecuencia de acceso con evolución del 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 - gráficos de topología, mapas de calor SLOT-STATS, CPU por slot y distribución de claves.
• Autorregistro de clúster - una conexión de clúster puede autorregistrar cada nodo como su propia conexión monitorizada, manteniéndose sincronizada a medida que el clúster escala. Consulta docs/cluster-auto-registration.md.
• Métricas de CPU e hilos de E/S - visibilidad por hilo que ninguna herramienta de Redis puede ofrecer.
• Analítica de clientes - identifica 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.

Comprender 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 claro. 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 - migra entre Redis y Valkey con un flujo de trabajo trifásico de análisis, ejecución y validación.

Diseñado para la era de la IA