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

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

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 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 para o AI Helper local-LLM experimental
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)```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

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 abordados no [guia do Kubernetes](https://docs.betterdb.com/kubernetes) e no [README do chart](https://github.com/betterdb-inc/monitor/blob/master/charts/betterdb-monitor/README.md).

## Início Rápido (CLI)

Execute o BetterDB Monitor sem Docker:```bash
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.```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

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 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.
- **Rastreamento de hot keys** - principais chaves por frequência de acesso com movimento de ranking 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.
- **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/seg, CPU e fragmentação.
- **Webhooks** - entregas de alertas assinadas com HMAC com tentativas repetidas 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.

### Construído para a era da IA

- **Observabilidade de pesquisa vetorial** - ops/seg e latência de FT.SEARCH com saúde por índice para [valkey-search](https://github.com/valkey-io/valkey-search) e RediSearch. Consulte [docs/vector-ai](https://github.com/betterdb-inc/monitor/blob/master/docs/vector-ai/README.md).
- **Latência de inferência** - p50/p95/p99 por índice, com alertas de violação de SLA (Pro, gratuito em acesso antecipado).
- **Inteligência de cache semântica** (Pro, gratuito em acesso antecipado) - saúde da taxa de acertos, recomendações de limiar de similaridade e um fluxo de trabalho de proposta de aprovação/rejeição. Observabilidade de memória de agentes incluída.
- **Rastreios de IA** - cascatas de spans OTLP da sua aplicação de IA, correlacionadas com o estado Valkey ao vivo subjacente a cada pedido. Consulte [docs/opentelemetry.md](https://github.com/betterdb-inc/monitor/blob/master/docs/opentelemetry.md).

### Liga-se a tudo