BetterDB Monitor

Die Monitoring-Schicht, die Valkey verdient.

BetterDB persistiert, was Valkey verwirft – Slowlogs, Befehlsmuster, Client-Aktivität, Anomaliesignale –, damit du debuggen kannst, was um 3 Uhr morgens passiert ist, und nicht nur, was gerade passiert. Entwickelt für Valkey 8.x mit nativer Unterstützung für COMMANDLOG, CLUSTER SLOT-STATS und I/O-Metriken pro Thread. Für alles andere kompatibel mit Redis 6+.

Website | Docker Hub | npm | Dokumentation | Blog

BetterDB wird von BetterDB Inc. entwickelt, einem gemeinnützigen Unternehmen, das unter der OCV Open Charter operiert.

BetterDB Monitor – Key-Analysen mit Histogrammen zur Schlüsselgrößenverteilung pro Typ

Schnellstart (Docker)

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

Richten Sie Ihren Browser auf http://localhost:3001. Um eine bestimmte Instanz zu überwachen:

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

Verbindung zu einer Datenbank auf Ihrem Host-Rechner herstellen? Innerhalb des Containers ist localhost der Container selbst, nicht Ihr Host — verwenden Sie daher host.docker.internal als Datenbank-Host. Unter Docker Desktop (macOS/Windows) funktioniert dies ohne weitere Konfiguration; unter Linux fügen Sie --add-host=host.docker.internal:host-gateway zum docker run-Befehl hinzu, damit der Name aufgelöst wird. Die Ein-Klick-Schaltfläche „Mit lokaler Instanz verbinden“ im Dashboard erkennt dies automatisch und füllt den richtigen Host für Sie vor.

Es werden zwei Image-Varianten veröffentlicht, beide Multi-Arch (linux/amd64, linux/arm64):

Tag	Was es ist
`latest`, `X.Y.Z-no-ai`	Standard-Image – alle Monitoring-Funktionen enthalten, ohne die Abhängigkeiten für den experimentellen lokalen LLM AI Helper
`X.Y.Z`	Fügt den experimentellen AI Helper hinzu (eigenes Ollama mitbringen; standardmäßig deaktiviert über `AI_ENABLED`)

Siehe Docker Production Deployment für persistente Speicherung, benutzerdefinierte Ports, Lizenzierung und Air-Gapped-Setups.

Schnellstart (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

Führen Sie dann kubectl port-forward -n betterdb svc/betterdb-monitor 3001:3001 aus und öffnen Sie http://localhost:3001, oder aktivieren Sie das Ingress des Charts. PostgreSQL-gestützte Historie, eigene Secrets (Bring-your-own) und Lizenzierung für air-gapped Umgebungen werden alle im Kubernetes-Leitfaden und in der Chart-README behandelt.

Schnellstart (CLI)

Führen Sie BetterDB Monitor ohne Docker aus:

npx @betterdb/monitor

Beim ersten Start führt Sie ein interaktiver Einrichtungsassistent durch die Datenbankverbindung, das Speicher-Backend (SQLite, PostgreSQL oder In-Memory) und die Servereinstellungen. Die Konfiguration wird in ~/.betterdb/config.json gespeichert.

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

Erfordert Node.js >= 20.0.0 und eine zu überwachende Valkey- oder Redis-Instanz. Für SQLite-Speicherung zusätzlich npm install -g better-sqlite3.

Was Sie erhalten

Alles sehen, alles behalten

Historische Analysen – Slowlogs, Befehlsmuster, Client-Aktivität und Latenz über jeden Zeitraum hinweg abfragen. Die Daten, die früher nach einer Log-Rotation verschwunden sind.
COMMANDLOG-Unterstützung – exklusiv für Valkey 8.1+. Große Anfragen und große Antworten, nicht nur die langsamen.
MONITOR-Aufzeichnungssitzungen – echten Datenverkehr bei Bedarf aufzeichnen: Live-Tail, Filtern, Replay, Export nach JSON/CSV und Abgleich mit der Verbindungshistorie.
Hot-Key-Tracking – Top-Keys nach Zugriffshäufigkeit mit Rangverschiebung im Zeitverlauf. Key Analytics (Pro, in der Early-Access-Phase kostenlos) ergänzt Typ-, TTL- und Größenverteilungen aus Live-Sampling.
Cluster-Sichtbarkeit – Topologie-Graphen, SLOT-STATS-Heatmaps, CPU- und Key-Verteilung pro Slot.
Automatische Cluster-Registrierung – eine Cluster-Verbindung kann jeden Knoten automatisch als eigene überwachte Verbindung registrieren und bleibt synchron, während der Cluster skaliert. Siehe docs/cluster-auto-registration.md.
CPU- & I/O-Thread-Metriken – Sichtbarkeit pro Thread, die kein Redis-Tool bieten kann.
Client-Analysen – genau sehen, welcher Dienst wofür verantwortlich ist, zugeordnet nach Client-Name und -Muster.
ACL-Audit-Trail – nachverfolgen, wer worauf zugegriffen hat, persistiert für Compliance und Debugging nach Vorfällen.

monitor v0.44.0