BetterDB Monitor

Il livello di monitoraggio che Valkey merita.

BetterDB conserva ciò che Valkey scarta - slowlog, pattern dei comandi, attività dei client, segnali di anomalia - così puoi fare debug di ciò che è accaduto alle 3 del mattino, non solo di ciò che sta accadendo ora. Realizzato per Valkey 8.x con supporto nativo per COMMANDLOG, CLUSTER SLOT-STATS e metriche I/O per thread. Compatibile con Redis 6+ per tutto il resto.

Sito web | Docker Hub | npm | Documentazione | Blog

BetterDB è sviluppato da BetterDB Inc., una public benefit company che opera secondo la OCV Open Charter.

Avvio rapido (Docker)

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

Porta il browser su http://localhost:3001. Per monitorare un'istanza specifica:

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

Ti stai connettendo a un database sulla tua macchina host? All'interno del container localhost è il container stesso, non il tuo host — quindi usa host.docker.internal come host del database. Su Docker Desktop (macOS/Windows) funziona subito; su Linux aggiungi --add-host=host.docker.internal:host-gateway al comando docker run così il nome viene risolto. Il pulsante "connect to local instance" con un clic della dashboard lo rileva automaticamente e precompila l'host corretto per te.

Sono pubblicate due varianti dell'immagine, entrambe multi-arch (linux/amd64, linux/arm64):

Tag	Cos'è
latest, X.Y.Z-no-ai	Immagine predefinita - include tutte le funzionalità di monitoraggio, senza le dipendenze per l'AI Helper sperimentale con LLM locale
X.Y.Z	Aggiunge l'AI Helper sperimentale (bring your own Ollama; disabilitato per impostazione predefinita tramite AI_ENABLED)

Vedi Docker Production Deployment per storage persistente, porte personalizzate, licenze e configurazioni air-gapped.

Quick Start (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

Poi kubectl port-forward -n betterdb svc/betterdb-monitor 3001:3001 e apri http://localhost:3001, oppure abilita l'ingress del chart. La cronologia basata su PostgreSQL, i Secrets forniti dall'utente e le licenze air-gapped sono tutti trattati nella guida Kubernetes e nel README del chart.

Avvio rapido (CLI)

Esegui BetterDB Monitor senza Docker:

npx @betterdb/monitor

Al primo avvio, una procedura guidata interattiva ti accompagna nella configurazione della connessione al database, del backend di archiviazione (SQLite, PostgreSQL o in-memory) e delle impostazioni del server. La configurazione viene salvata in ~/.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

Richiede Node.js >= 20.0.0 e un'istanza Valkey o Redis da monitorare. Per l'archiviazione SQLite, eseguire anche npm install -g better-sqlite3.

Cosa Ottieni

Vedi tutto, conserva tutto

• Analisi storiche - interroga slowlog, pattern dei comandi, attività dei client e latenza su qualsiasi intervallo di tempo. I dati che prima scomparivano dopo una rotazione dei log.
• Supporto COMMANDLOG - esclusivo di Valkey 8.1+. Richieste e risposte di grandi dimensioni, non solo quelle lente.
• Sessioni di cattura MONITOR - registra il traffico reale su richiesta: live tail, filtro, replay, esportazione in JSON/CSV e confronto incrociato con la cronologia delle connessioni.
• Tracciamento delle hot key - chiavi più accedute per frequenza con variazione del rank nel tempo. Key Analytics (Pro, gratuito in accesso anticipato) aggiunge distribuzioni di tipo, TTL e dimensione dal campionamento live.
• Visibilità del cluster - grafici della topologia, heatmap SLOT-STATS, CPU per slot e distribuzione delle chiavi.
• Auto-registrazione del cluster - una connessione cluster può registrare automaticamente ogni nodo come connessione monitorata a sé stante, mantenuta sincronizzata man mano che il cluster si espande. Vedi docs/cluster-auto-registration.md.
• Metriche dei thread CPU e I/O - visibilità per thread che nessuno strumento Redis può fornire.
• Analisi dei client - vedi esattamente quale servizio è responsabile di cosa, attribuito per nome e pattern del client.
• Audit trail ACL - traccia chi ha acceduto a cosa, persistito per la conformità e il debug post-incidente.

Comprendi e agisci

• Rilevamento delle anomalie (Pro, gratuito in accesso anticipato) - apprendimento automatico della baseline con eventi correlati e diagnosi in linguaggio naturale. Oltre 20 rilevatori, senza soglie manuali.
• Previsione della capacità - tempo stimato al limite per memoria, ops/sec, CPU e frammentazione.
• Webhook - consegne di avvisi firmate con HMAC con tentativi ripetuti e un log completo delle consegne.
• Migrazione live - spostamento tra Redis e Valkey con un flusso di lavoro in tre fasi: analisi, esecuzione e validazione.

Progettato per l'era dell'AI