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, use host.docker.internal como host do banco de dados. No Docker Desktop (macOS/Windows) funciona sem configuração adicional; no Linux, adicione --add-host=host.docker.internal:host-gateway ao comando docker run para 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 monitorizar. Para armazenamento SQLite, também npm install -g better-sqlite3.

O Que Obtém

Veja tudo, guarde tudo

• Análise histórica - 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+. Pedidos grandes e respostas grandes, não apenas os lentos.
• Sessões de captura MONITOR - registe tráfego real a pedido: live tail, filtragem, replay, exportação para JSON/CSV e referência cruzada com o histórico de ligações.
• Rastreio de hot keys - principais chaves por frequência de acesso com evolução de posição ao longo do tempo. O Key Analytics (Pro, gratuito em acesso antecipado) acrescenta distribuições de tipo, TTL e tamanho a partir de amostragem em tempo real.
• Visibilidade de cluster - grafos de topologia, heatmaps SLOT-STATS, CPU por slot e distribuição de chaves.
• Registo automático de cluster - uma ligação de cluster pode registar automaticamente cada nó como a sua própria ligação monitorizada, mantida em sincronia à medida que o cluster escala. Ver docs/cluster-auto-registration.md.
• Métricas de CPU e threads de I/O - visibilidade por thread que nenhuma ferramenta Redis consegue proporcionar.
• Análise de clientes - veja exatamente qual serviço é responsável pelo quê, atribuído por nome e padrão de cliente.
• Trilha de auditoria ACL - acompanhe quem acedeu ao quê, persistido para conformidade e depuração pós-incidente.

Compreenda e aja