BetterDB Monitor

Il layer di monitoraggio che Valkey merita.

BetterDB conserva ciò che Valkey getta via - slowlog, pattern dei comandi, attività dei client, segnali di anomalia - così puoi fare debug di ciò che è accaduto alle 3 del mattino, non solo di ciò che sta accadendo ora. Progettato per Valkey 8.x con supporto nativo per COMMANDLOG, CLUSTER SLOT-STATS e metriche I/O per thread. Compatibile con Redis 6+ per tutto il resto.

Sito web | Docker Hub | npm | Documentazione | Blog

BetterDB è sviluppato da BetterDB Inc., una public benefit company che opera secondo la OCV Open Charter.

Avvio rapido (Docker)```bash

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

Apri il browser all'indirizzo `http://localhost:3001`. Per monitorare un'istanza specifica:```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

Connettersi a un database sulla propria macchina host? All'interno del container localhost è il container stesso, non il vostro host — quindi usate host.docker.internal come host del database. Su Docker Desktop (macOS/Windows) funziona immediatamente; su Linux aggiungete --add-host=host.docker.internal:host-gateway al comando docker run affinché il nome venga risolto. Il pulsante "connect to local instance" con un solo clic della dashboard rileva automaticamente questa configurazione e precompila l'host corretto per voi.

Sono pubblicate due varianti di immagine, entrambe multi-arch (linux/amd64, linux/arm64):

Tag	Cos'è
latest, X.Y.Z-no-ai	Immagine predefinita - include tutte le funzionalità di monitoraggio, senza le dipendenze per l'AI Helper sperimentale basato su LLM locale
X.Y.Z	Aggiunge l'AI Helper sperimentale (portate il vostro Ollama; disabilitato per impostazione predefinita tramite AI_ENABLED)

Consultate Docker Production Deployment per storage persistente, porte personalizzate, licenze e configurazioni air-gapped.

Avvio rapido (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

Poi `kubectl port-forward -n betterdb svc/betterdb-monitor 3001:3001` e apri `http://localhost:3001`, oppure abilita l'ingress del chart. La cronologia basata su PostgreSQL, i Secrets personalizzati e le licenze air-gapped sono tutti trattati nella [guida Kubernetes](https://docs.betterdb.com/kubernetes) e nel [README del chart](https://github.com/betterdb-inc/monitor/blob/master/charts/betterdb-monitor/README.md).

## Avvio rapido (CLI)

Esegui BetterDB Monitor senza Docker:```bash
npx @betterdb/monitor

Al primo avvio, una procedura guidata interattiva di configurazione ti accompagna nella connessione al database, nella scelta del backend di archiviazione (SQLite, PostgreSQL o in-memory) e nelle impostazioni del server. La configurazione viene salvata in ~/.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

Richiede Node.js >= 20.0.0 e un'istanza Valkey o Redis da monitorare. Per l'archiviazione SQLite, anche `npm install -g better-sqlite3`.

## Cosa Ottieni

### Vedi tutto, conserva tutto

- **Analisi storiche** - interroga slowlog, pattern dei comandi, attività dei client e latenza su qualsiasi intervallo temporale. I dati che prima sparivano dopo una rotazione dei log.
- **Supporto COMMANDLOG** - esclusivo di Valkey 8.1+. Richieste e risposte di grandi dimensioni, non solo quelle lente.
- **Sessioni di cattura MONITOR** - registra il traffico reale su richiesta: live tail, filtro, replay, esportazione in JSON/CSV e correlazione incrociata con la cronologia delle connessioni.
- **Tracciamento delle hot key** - chiavi più accedute per frequenza con variazione di posizione nel tempo. Key Analytics (Pro, gratuito in accesso anticipato) aggiunge distribuzioni di tipo, TTL e dimensione dal campionamento live.
- **Visibilità del cluster** - grafici della topologia, heatmap SLOT-STATS, CPU per slot e distribuzione delle chiavi.
- **Metriche dei thread CPU e I/O** - visibilità per thread che nessuno strumento Redis può fornire.
- **Analisi dei client** - vedi esattamente quale servizio è responsabile di cosa, attribuito per nome e pattern del client.
- **Audit trail ACL** - traccia chi ha acceduto a cosa, persistito per conformità e debug post-incidente.

### Comprendi e agisci

- **Rilevamento delle anomalie** (Pro, gratuito in accesso anticipato) - apprendimento automatico della baseline con eventi correlati e diagnosi in linguaggio naturale. Oltre 20 rilevatori, nessuna soglia manuale.
- **Previsione della capacità** - tempo stimato al limite per memoria, ops/sec, CPU e frammentazione.
- **Webhook** - consegne di avvisi firmate HMAC con tentativi ripetuti e un registro completo delle consegne.
- **Migrazione live** - spostati tra Redis e Valkey con un flusso di lavoro in tre fasi: analisi, esecuzione e validazione.

### Costruito per l'era dell'AI

- **Osservabilità della ricerca vettoriale** - ops/sec e latenza di FT.SEARCH con stato per indice per [valkey-search](https://github.com/valkey-io/valkey-search) e RediSearch. Vedi [docs/vector-ai](https://github.com/betterdb-inc/monitor/blob/master/docs/vector-ai/README.md).
- **Latenza di inferenza** - p50/p95/p99 per indice, con avvisi di violazione SLA (Pro, gratuito in accesso anticipato).
- **Intelligenza della cache semantica** (Pro, gratuito in accesso anticipato) - stato dell'hit-rate, raccomandazioni sulla soglia di similarità e un flusso di lavoro di proposta approva/rifiuta. Osservabilità della memoria dell'agente inclusa.
- **Tracce AI** - cascate di span OTLP dalla tua applicazione AI, correlate con lo stato live di Valkey sottostante ogni richiesta. Vedi [docs/opentelemetry.md](https://github.com/betterdb-inc/monitor/blob/master/docs/opentelemetry.md).

### Si integra con tutto