BetterDB Monitor

La couche de supervision que Valkey mérite.

BetterDB conserve ce que Valkey jette - slowlogs, motifs de commandes, activité des clients, signaux d'anomalie - afin que vous puissiez déboguer ce qui s'est passé à 3h du matin, et pas seulement ce qui se passe maintenant. Conçu pour Valkey 8.x avec prise en charge native de COMMANDLOG, CLUSTER SLOT-STATS et des métriques d'E/S par thread. Compatible avec Redis 6+ pour tout le reste.

Site web | Docker Hub | npm | Documentation | Blog

BetterDB est développé par BetterDB Inc., une société à mission d'intérêt public opérant sous la OCV Open Charter.

BetterDB Monitor - Key Analytics with per-type key size distribution histograms

Démarrage rapide (Docker)

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

Pointez votre navigateur vers http://localhost:3001. Pour surveiller une instance spécifique :

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

Vous connectez-vous à une base de données sur votre machine hôte ? À l'intérieur du conteneur, localhost désigne le conteneur lui-même, pas votre hôte — utilisez donc host.docker.internal comme hôte de la base de données. Sur Docker Desktop (macOS/Windows), cela fonctionne d'emblée ; sur Linux, ajoutez --add-host=host.docker.internal:host-gateway à la commande docker run pour que le nom soit résolu. Le bouton « se connecter à l'instance locale » en un clic du tableau de bord détecte cela automatiquement et pré-remplit le bon hôte pour vous.

Deux variantes d'image sont publiées, toutes deux multi-arch (linux/amd64, linux/arm64) :

Tag	Ce que c'est
`latest`, `X.Y.Z-no-ai`	Image par défaut - toutes les fonctionnalités de surveillance incluses, sans les dépendances pour l'AI Helper local-LLM expérimental
`X.Y.Z`	Ajoute l'AI Helper expérimental (apportez votre propre Ollama ; désactivé par défaut via `AI_ENABLED`)

Voir Docker Production Deployment pour le stockage persistant, les ports personnalisés, les licences et les configurations en environnement isolé.

Démarrage rapide (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

Puis kubectl port-forward -n betterdb svc/betterdb-monitor 3001:3001 et ouvrez http://localhost:3001, ou activez l'ingress du chart. L'historique basé sur PostgreSQL, l'apport de vos propres Secrets et la licence en environnement isolé sont tous couverts dans le guide Kubernetes et le README du chart.

Démarrage rapide (CLI)

Exécutez BetterDB Monitor sans Docker :

npx @betterdb/monitor

Lors de la première exécution, un assistant de configuration interactif vous guide à travers la connexion à la base de données, le backend de stockage (SQLite, PostgreSQL ou en mémoire) et les paramètres du serveur. La configuration est enregistrée dans ~/.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

Nécessite Node.js >= 20.0.0 et une instance Valkey ou Redis à surveiller. Pour le stockage SQLite, exécutez également npm install -g better-sqlite3.

Ce que vous obtenez

Tout voir, tout conserver

Analyses historiques - interrogez les slowlogs, les schémas de commandes, l'activité des clients et la latence sur n'importe quelle plage temporelle. Les données qui disparaissaient auparavant après une rotation des logs.
Prise en charge de COMMANDLOG - exclusivité Valkey 8.1+. Les requêtes volumineuses et les réponses volumineuses, pas seulement les plus lentes.
Sessions de capture MONITOR - enregistrez le trafic réel à la demande : suivi en direct, filtrage, rejeu, export vers JSON/CSV et recoupement avec l'historique des connexions.
Suivi des hot keys - principales clés par fréquence d'accès avec évolution du classement dans le temps. Key Analytics (Pro, gratuit en accès anticipé) ajoute les distributions de type, TTL et taille à partir d'un échantillonnage en direct.
Visibilité du cluster - graphiques de topologie, heatmaps SLOT-STATS, CPU par slot et distribution des clés.
Auto-enregistrement du cluster - une connexion de cluster peut enregistrer automatiquement chaque nœud comme sa propre connexion surveillée, maintenue en synchronisation à mesure que le cluster évolue. Voir docs/cluster-auto-registration.md.
Métriques CPU et threads d'E/S - visibilité par thread qu'aucun outil Redis ne peut fournir.
Analyses des clients - voyez exactement quel service est responsable de quoi, attribué par nom et motif de client.
Piste d'audit ACL - suivez qui a accédé à quoi, conservé pour la conformité et le débogage post-incident.

Comprendre et agir

Détection d'anomalies (Pro, gratuit en accès anticipé) - apprentissage automatique de la ligne de base avec événements corrélés et diagnostics en langage clair. Plus de 20 détecteurs, sans seuils manuels.
Prévision de capacité - temps projeté avant saturation pour la mémoire, les ops/sec, le CPU et la fragmentation.
Webhooks - livraisons d'alertes signées HMAC avec nouvelles tentatives et un journal de livraison complet.
Migration à chaud - passez de Redis à Valkey avec un workflow en trois phases : analyse, exécution et validation.

monitor v0.41.0