betterdb/monitor repository overview

⁠BetterDB Monitor

By BetterDB⁠ - The monitoring layer that Valkey deserves.

BetterDB persists what Valkey throws away - slowlogs, command patterns, client activity, anomaly signals - so you can debug what happened at 3am, not just what's happening now.

Built for Valkey 8.x with native support for COMMANDLOG, CLUSTER SLOT-STATS, and per-thread I/O metrics. Redis 6.0+ compatible for everything else. And because Valkey is fast becoming the backbone of AI infrastructure, BetterDB now watches that layer too: vector indexes, semantic caches, agent memory, and inference latency - correlated with the live database state underneath them.

Core monitoring is free forever (MIT). Pro and Enterprise add advanced detection, automation, and compliance - and are free during early access.

If you find BetterDB useful, star our repository⁠.

⁠Get Started in 30 Seconds

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

Point your browser to http://localhost:3001. That's it.

⁠Connect to Your Database

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

Standalone or cluster - Valkey vs Redis is auto-detected, and the UI adapts to what your server supports. Add more instances at runtime under Settings → Connections (multi-instance monitoring is Pro, free in early access).

⁠With Persistent Storage (PostgreSQL)

Persist your monitoring data across restarts for full historical analytics, anomaly baselines, MONITOR captures, and audit trail access.

docker run -d \
  --name betterdb \
  -p 3001:3001 \
  -e DB_HOST=your-valkey-host \
  -e DB_PORT=6379 \
  -e DB_PASSWORD=your-password \
  -e STORAGE_TYPE=postgres \
  -e STORAGE_URL=postgresql://user:pass@localhost:5432/betterdb \
  betterdb/monitor:latest

⁠Choose Your Image

All images are multi-arch: linux/amd64 and linux/arm64.

⁠What You Get

⁠See everything, keep everything

• Historical analytics - query slowlogs, command patterns, client activity, and latency across any time range. The data that used to disappear after a log rotation.
• COMMANDLOG support - Valkey 8.1+ exclusive. Large requests and large replies, not just the slow ones.
• MONITOR capture sessions - record real traffic on demand: live tail, filter, replay, export to JSON/CSV, and cross-reference against connection history. Pro adds anomaly-triggered captures, scheduled captures, and capture-vs-capture diff.
• Hot key tracking - top-50 keys by access frequency with rank movement over time. Key Analytics (Pro, free in early access) adds type, TTL, and size distributions from live sampling.
• Cluster visibility - topology graphs, SLOT-STATS heatmaps, per-slot CPU and key distribution.
• CPU & I/O thread metrics - per-thread visibility that no Redis tool can provide.
• Client analytics - see exactly which service is responsible for what. Cache-service, rate-limiter, api-server - attributed by client name and pattern.
• ACL audit trail - track who accessed what, persisted for compliance and post-incident debugging.

⁠Understand and act

• Anomaly detection (Pro, free in early access) - automatic baseline learning with correlated events and plain-English diagnoses. 20+ detectors: eviction storms, replication pressure, failover churn, config drift, fork-OOM risk, and more. No manual thresholds to configure.
• Capacity forecasting - projected time-to-ceiling for memory, ops/sec, CPU, and fragmentation. Know you'll hit maxmemory before you hit it.
• Webhooks - HMAC-signed alert deliveries with retries and a full delivery log. ~20 event types, from instance.down and latency.spike to acl.violation.
• Live migration - move between Redis and Valkey with a three-phase analysis → execution → validation workflow. Analysis is free; execution is Pro (free in early access).

⁠Built for the AI era

• Vector search observability - FT.SEARCH ops/sec and latency with per-index health: docs, records, indexing failures, backfill progress (valkey-search and RediSearch).
• Inference latency - p50/p95/p99 per index, with SLA breach alerts (Pro, free in early access).
• Semantic cache intelligence (Pro, free in early access) - hit-rate health, similarity-threshold recommendations, and an approve/reject proposal workflow for cache tuning. Agent memory observability included.
• AI traces - OTLP span waterfalls from your AI application, correlated with the live Valkey state underneath each request.

⁠Plugs into everything

• MCP server - 60 tools covering diagnostics, cluster, AI observability, and cache governance. Let Claude Code, Cursor, or any MCP client triage a latency spike for you.
• Prometheus endpoint - 100+ betterdb_* metrics, straight into your existing stack.
• OpenTelemetry - mirror metrics and events to any OTLP backend.
• REST API - everything in the UI is an API call, documented via OpenAPI.

⁠Access Your Data Your Way

⁠Configuration

⁠Database Connection

⁠Storage Backend

Note: Docker production images do not include SQLite - that backend is for local development via the CLI⁠.

⁠Licensing & Telemetry

Air-gapped? Offline license tokens are signed JWTs verified locally against keys embedded in the image. With an offline token and no online key, the monitor makes zero outbound requests - no license pings, no telemetry, no update checks.

⁠Other Settings

Full reference, including OTLP export, webhook tuning, and health-gate thresholds: docs.betterdb.com/configuration⁠.

⁠Supported Databases

Managed services work too - guides for AWS ElastiCache, MemoryDB, Redis Cloud, and Upstash are in the docs, and @betterdb/agent⁠ reaches VPC-only instances over an outbound WebSocket.

⁠Resources

• Documentation: docs.betterdb.com⁠
• GitHub: github.com/betterdb-inc/monitor⁠
• Issues: github.com/betterdb-inc/monitor/issues⁠
• Website: betterdb.com⁠

⁠License

Community features are open source under MIT and free forever. Pro and Enterprise features (anomaly detection, key analytics, migration execution, inference SLA alerts, SSO/RBAC, compliance export) are free during early access; they will require a commercial license later - see betterdb.com/pricing⁠.