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 jetzt passiert. Entwickelt für Valkey 8.x mit nativer Unterstützung für COMMANDLOG, CLUSTER SLOT-STATS und I/O-Metriken pro Thread. Redis 6+ kompatibel für alles andere.

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 Analytics mit Verteilungshistogrammen der Schlüsselgröße 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. Auf 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 persistenten Speicher, 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

Dann kubectl port-forward -n betterdb svc/betterdb-monitor 3001:3001 und öffne http://localhost:3001, oder aktiviere das Ingress des Charts. PostgreSQL-gestützte Historie, eigene Secrets und Air-Gapped-Lizenzierung werden im Kubernetes-Leitfaden und der Chart-README behandelt.

Schnellstart (CLI)

Führe 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 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, Filter, Replay, Export nach JSON/CSV und Abgleich mit der Verbindungshistorie.
Hot-Key-Tracking - Top-Keys nach Zugriffshäufigkeit mit Rangverschiebung über die Zeit. 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, synchron gehalten, 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 Post-Incident-Debugging.

Verstehen und handeln

Anomalieerkennung (Pro, in der Early-Access-Phase kostenlos) - automatisches Baseline-Lernen mit korrelierten Ereignissen und Diagnosen in verständlicher Sprache. Über 20 Detektoren, keine manuellen Schwellenwerte.
Kapazitätsprognose - prognostizierte Zeit bis zum Erreichen der Obergrenze für Speicher, Ops/Sek., CPU und Fragmentierung.
Webhooks - HMAC-signierte Alert-Zustellungen mit Wiederholungsversuchen und vollständigem Zustellungsprotokoll.
Live-Migration - Wechsel zwischen Redis und Valkey mit einem dreiphasigen Workflow aus Analyse, Ausführung und Validierung.

monitor v0.41.0