BetterDB Monitor

La couche de supervision que Valkey mérite.

BetterDB conserve ce que Valkey jette - slowlogs, schémas 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.

Démarrage rapide (Docker)```bash

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

Pointez votre navigateur vers `http://localhost:3001`. Pour surveiller une instance spécifique :```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

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

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](https://docs.betterdb.com/kubernetes) et le [README du chart](https://github.com/betterdb-inc/monitor/blob/master/charts/betterdb-monitor/README.md).

## Démarrage rapide (CLI)

Exécutez BetterDB Monitor sans Docker :```bash
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.```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

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 modèles 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 lentes.
- **Sessions de capture MONITOR** - enregistrez le trafic réel à la demande : suivi en direct, filtrage, rejeu, export au format 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.
- **Métriques des threads CPU et I/O** - 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 modèle 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 journal complet des livraisons.
- **Migration à chaud** - passez de Redis à Valkey avec un workflow en trois phases : analyse, exécution et validation.

### Conçu pour l'ère de l'IA