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, nicht nur, was gerade passiert. Entwickelt für Valkey 8.x mit nativer Unterstützung für COMMANDLOG, CLUSTER SLOT-STATS und Per-Thread-I/O-Metriken. 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.

Schnellstart (Docker)```bash

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:```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

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 „connect to local instance“ des Dashboards 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 (bring your own Ollama; standardmäßig deaktiviert über AI_ENABLED)

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

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

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](https://docs.betterdb.com/kubernetes) und der [Chart-README](https://github.com/betterdb-inc/monitor/blob/master/charts/betterdb-monitor/README.md) behandelt.

## Schnellstart (CLI)

Führe BetterDB Monitor ohne Docker aus:```bash
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.```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

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** - Abfragen von Slowlogs, Befehlsmustern, Client-Aktivität und Latenz über jeden Zeitraum. Die Daten, die früher nach einer Log-Rotation verschwanden.
- **COMMANDLOG-Unterstützung** - exklusiv für Valkey 8.1+. Große Anfragen und große Antworten, nicht nur die langsamen.
- **MONITOR-Aufzeichnungssitzungen** - zeichnen Sie echten Datenverkehr bei Bedarf auf: Live-Tail, Filter, 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.
- **CPU- und I/O-Thread-Metriken** - Sichtbarkeit pro Thread, die kein Redis-Tool bieten kann.
- **Client-Analysen** - sehen Sie genau, welcher Dienst wofür verantwortlich ist, zugeordnet nach Client-Name und -Muster.
- **ACL-Audit-Trail** - verfolgen Sie, 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 verständlichen Diagnosen. Ü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 Alarmzustellungen mit Wiederholungsversuchen und vollständigem Zustellungsprotokoll.
- **Live-Migration** - Wechsel zwischen Redis und Valkey mit einem dreiphasigen Workflow aus Analyse, Ausführung und Validierung.

### Gebaut für die KI-Ära

- **Vektorsuche-Observability** - FT.SEARCH Ops/Sek. und Latenz mit Index-Health pro Index für [valkey-search](https://github.com/valkey-io/valkey-search) und RediSearch. Siehe [docs/vector-ai](https://github.com/betterdb-inc/monitor/blob/master/docs/vector-ai/README.md).
- **Inferenzlatenz** - p50/p95/p99 pro Index, mit SLA-Verletzungsalarmen (Pro, in der Early-Access-Phase kostenlos).
- **Semantische Cache-Intelligenz** (Pro, in der Early-Access-Phase kostenlos) - Hit-Rate-Health, Empfehlungen für Ähnlichkeitsschwellenwerte und ein Genehmigungs-/Ablehnungs-Workflow für Vorschläge. Agent-Memory-Observability inklusive.
- **KI-Traces** - OTLP-Span-Wasserfälle aus Ihrer KI-Anwendung, korreliert mit dem Live-Valkey-Zustand unter jeder Anfrage. Siehe [docs/opentelemetry.md](https://github.com/betterdb-inc/monitor/blob/master/docs/opentelemetry.md).

### Lässt sich überall integrieren