BetterDB Monitor

A camada de monitoramento que o Valkey merece.

O BetterDB persiste o 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ã, não apenas o que está acontecendo agora. Criado 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.

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

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 — então use host.docker.internal como host do banco de dados. No Docker Desktop (macOS/Windows) funciona imediatamente; no Linux adicione --add-host=host.docker.internal:host-gateway ao comando docker run para que o nome seja resolvido. O botão de "conectar à instância local" com um clique 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 para o AI Helper experimental de LLM local
`X.Y.Z`	Adiciona o AI Helper experimental (traga seu próprio Ollama; desabilitado 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, kubectl port-forward -n betterdb svc/betterdb-monitor 3001:3001 e abra http://localhost:3001, ou ative o ingress do chart. Histórico com backend PostgreSQL, bring-your-own Secrets e licenciamento air-gapped estão todos documentados 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ê através da conexão com o banco de dados, do backend de armazenamento (SQLite, PostgreSQL ou em memória) e das 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 - grave tráfego real a pedido: live tail, filtro, replay, exportação para JSON/CSV e referência cruzada com o histórico de conexões.
Rastreio de hot keys - principais chaves por frequência de acesso com movimento de posição ao longo do tempo. O Key Analytics (Pro, gratuito em acesso antecipado) adiciona tipo, TTL e distribuições de 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.
Auto-registo de cluster - uma conexão de cluster pode auto-registar cada nó como a sua própria conexão monitorizada, mantida em sincronia à medida que o cluster escala. Ver docs/cluster-auto-registration.md.
Métricas de threads de CPU e I/O - visibilidade por thread que nenhuma ferramenta Redis consegue fornecer.
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

Deteção de anomalias (Pro, gratuito em acesso antecipado) - aprendizagem automática de baseline com eventos correlacionados e diagnósticos em linguagem simples. Mais de 20 detetores, sem limiares manuais.
Previsão de capacidade - tempo projetado até ao limite para memória, ops/sec, CPU e fragmentação.
Webhooks - entregas de alertas assinadas com HMAC com retries e um registo completo de entregas.
Migração ao vivo - mova entre Redis e Valkey com um fluxo de trabalho de três fases: análise, execução e validação.

monitor v0.41.0