
monitor v0.41.0
Monitoramento em tempo real e análise de slowlog para bancos de dados Valkey e Redis com detecção de anomalias, auditoria de ACL e exportação de métricas do Prometheus.
BetterDB Monitor
A camada de monitoramento que o Valkey merece.
O BetterDB persiste aquilo que o Valkey descarta - slowlogs, padrões de comandos, atividade de clientes, sinais de anomalia - para que você possa depurar o que aconteceu às 3 da manhã, e não apenas o que está acontecendo agora. Construído para o Valkey 8.x com suporte nativo a COMMANDLOG, CLUSTER SLOT-STATS e métricas de I/O por thread. Compatível com Redis 6+ para todo o resto.
Website | Docker Hub | npm | Documentation | Blog
O BetterDB é desenvolvido pela BetterDB Inc., uma empresa de benefício público que opera sob a OCV Open Charter.

Início Rápido (Docker)
docker run -d --name betterdb -p 3001:3001 betterdb/monitor:latest
Aponte seu navegador para http://localhost:3001. Para monitorar uma instância específica:
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
Conectando a um banco de dados na sua máquina host? Dentro do contêiner,
localhosté o próprio contêiner, não o seu host — portanto, usehost.docker.internalcomo host do banco de dados. No Docker Desktop (macOS/Windows) funciona sem configuração adicional; no Linux, adicione--add-host=host.docker.internal:host-gatewayao comandodocker runpara que o nome seja resolvido. O botão de um clique "conectar à instância local" do dashboard detecta isso automaticamente e pré-preenche o host correto para você.
Duas variantes de imagem são publicadas, ambas multi-arch (linux/amd64, linux/arm64):
| Tag | O que é |
|---|---|
latest, X.Y.Z-no-ai | Imagem padrão - todos os recursos de monitoramento incluídos, sem as dependências do experimental AI Helper de LLM local |
X.Y.Z | Adiciona o experimental AI Helper (traga seu próprio Ollama; desativado por padrão via AI_ENABLED) |
Consulte Docker Production Deployment para armazenamento persistente, portas personalizadas, licenciamento e configurações air-gapped.
Quick Start (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
Em seguida, execute kubectl port-forward -n betterdb svc/betterdb-monitor 3001:3001 e abra http://localhost:3001, ou habilite o ingress do chart. Histórico com backend PostgreSQL, bring-your-own Secrets e licenciamento em ambientes air-gapped estão todos cobertos no guia do Kubernetes e no README do chart.
Início Rápido (CLI)
Execute o BetterDB Monitor sem Docker:
npx @betterdb/monitor
Na primeira execução, um assistente de configuração interativo orienta você pela conexão com o banco de dados, pelo backend de armazenamento (SQLite, PostgreSQL ou em memória) e pelas configurações do servidor. A configuração é salva em ~/.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
Requer Node.js >= 20.0.0 e uma instância Valkey ou Redis para monitorar. Para armazenamento SQLite, também npm install -g better-sqlite3.
O que você obtém
Veja tudo, mantenha tudo
- Análises históricas - consulte slowlogs, padrões de comandos, atividade de clientes e latência em qualquer intervalo de tempo. Os dados que costumavam desaparecer após uma rotação de logs.
- Suporte a COMMANDLOG - exclusivo do Valkey 8.1+. Requisições grandes e respostas grandes, não apenas as lentas.
- Sessões de captura MONITOR - registre tráfego real sob demanda: live tail, filtro, replay, exportação para JSON/CSV e referência cruzada com o histórico de conexões.
- Rastreamento de hot keys - principais chaves por frequência de acesso com movimentação de ranking ao longo do tempo. O Key Analytics (Pro, gratuito em acesso antecipado) adiciona distribuições de tipo, TTL e tamanho a partir de amostragem ao vivo.
- Visibilidade de cluster - grafos de topologia, heatmaps SLOT-STATS, CPU por slot e distribuição de chaves.
- Auto-registro de cluster - uma conexão de cluster pode registrar automaticamente cada nó como sua própria conexão monitorada, mantida em sincronia conforme o cluster escala. Veja docs/cluster-auto-registration.md.
- Métricas de threads de CPU e I/O - visibilidade por thread que nenhuma ferramenta Redis consegue fornecer.
- Análises de clientes - veja exatamente qual serviço é responsável pelo quê, atribuído por nome e padrão de cliente.
- Trilha de auditoria ACL - rastreie quem acessou o quê, persistido para conformidade e depuração pós-incidente.