업데이트로 돌아가기
New releaseJul 23, 2026

monitor semantic-cache-v0.12.0

Valkey 및 Redis 데이터베이스에 대한 실시간 모니터링 및 slowlog 분석, 이상 탐지, ACL 감사, Prometheus 메트릭 내보내기 기능을 제공합니다.

공유

BetterDB Monitor

Docker Pulls Docker Image Version Artifact Hub npm npm downloads API Tests License Valkey Redis

Valkey에 걸맞은 모니터링 계층.

BetterDB는 Valkey가 버려버리는 것들 - 슬로우로그, 명령 패턴, 클라이언트 활동, 이상 징후 신호 - 을 영속화하여, 지금 무슨 일이 일어나고 있는지만이 아니라 새벽 3시에 무슨 일이 있었는지 디버깅할 수 있게 해줍니다. COMMANDLOG, CLUSTER SLOT-STATS, 스레드별 I/O 메트릭을 기본 지원하며 Valkey 8.x를 위해 만들어졌습니다. 그 외의 모든 기능은 Redis 6+와 호환됩니다.

웹사이트 | Docker Hub | npm | 문서 | 블로그

BetterDB는 OCV Open Charter에 따라 운영되는 공익 기업인 BetterDB Inc.가 만들었습니다.

BetterDB Monitor - 유형별 키 크기 분포 히스토그램이 포함된 키 분석

빠른 시작 (Docker)

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

브라우저에서 http://localhost:3001로 접속하세요. 특정 인스턴스를 모니터링하려면:

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

호스트 머신의 데이터베이스에 연결하시나요? 컨테이너 내부에서 localhost는 호스트가 아니라 컨테이너 자체를 가리킵니다. 따라서 데이터베이스 호스트로 host.docker.internal을 사용하세요. Docker Desktop (macOS/Windows) 에서는 별도 설정 없이 작동합니다. Linux에서는 docker run 명령에 --add-host=host.docker.internal:host-gateway를 추가하여 해당 이름이 확인되도록 하세요. 대시보드의 원클릭 "로컬 인스턴스에 연결" 버튼은 이를 자동으로 감지하여 올바른 호스트를 미리 채워 줍니다.

두 가지 이미지 변형이 게시되며, 둘 다 멀티 아키텍처(linux/amd64, linux/arm64)를 지원합니다:

태그설명
latest, X.Y.Z-no-ai기본 이미지 - 실험적 로컬 LLM AI Helper의 종속성 없이 모든 모니터링 기능 포함
X.Y.Z실험적 AI Helper 추가 (자체 Ollama 사용; AI_ENABLED를 통해 기본적으로 비활성화됨)

영구 저장소, 사용자 지정 포트, 라이선스 및 에어갭 환경 설정은 Docker 프로덕션 배포를 참조하세요.

빠른 시작 (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

그런 다음 kubectl port-forward -n betterdb svc/betterdb-monitor 3001:3001를 실행하고 http://localhost:3001을 열거나, 차트의 ingress를 활성화하세요. PostgreSQL 기반 이력, 자체 Secrets 사용, 에어갭 라이선싱은 모두 Kubernetes 가이드와 차트 README에서 다룹니다.

빠른 시작 (CLI)

Docker 없이 BetterDB Monitor를 실행하세요:

npx @betterdb/monitor

첫 실행 시 대화형 설정 마법사가 데이터베이스 연결, 스토리지 백엔드(SQLite, PostgreSQL 또는 인메모리), 서버 설정을 안내합니다. 구성은 ~/.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

Node.js >= 20.0.0과 모니터링할 Valkey 또는 Redis 인스턴스가 필요합니다. SQLite 저장소를 사용하려면 npm install -g better-sqlite3도 필요합니다.

제공 기능

모든 것을 보고, 모든 것을 보존

  • 이력 분석 - 모든 시간 범위에 걸쳐 슬로우로그, 명령 패턴, 클라이언트 활동, 지연 시간을 조회합니다. 로그 로테이션 후 사라지던 데이터입니다.
  • COMMANDLOG 지원 - Valkey 8.1+ 전용. 느린 요청뿐 아니라 대형 요청과 대형 응답까지 지원합니다.
  • MONITOR 캡처 세션 - 필요할 때 실제 트래픽을 기록합니다: 라이브 테일, 필터링, 재생, JSON/CSV 내보내기, 연결 이력과의 교차 참조.
  • 핫 키 추적 - 접근 빈도 기준 상위 키와 시간에 따른 순위 변동. Key Analytics(Pro, 얼리 액세스 기간 무료)는 라이브 샘플링을 통한 타입, TTL, 크기 분포를 추가로 제공합니다.
  • 클러스터 가시성 - 토폴로지 그래프, SLOT-STATS 히트맵, 슬롯별 CPU 및 키 분포.
  • 클러스터 자동 등록 - 클러스터 연결이 모든 노드를 자체 모니터링 연결로 자동 등록하며, 클러스터가 확장됨에 따라 동기화 상태를 유지합니다. docs/cluster-auto-registration.md를 참조하세요.
  • CPU 및 I/O 스레드 메트릭 - 어떤 Redis 도구도 제공하지 못하는 스레드별 가시성.
  • 클라이언트 분석 - 클라이언트 이름과 패턴으로 귀속하여 어떤 서비스가 무엇을 담당하는지 정확히 확인합니다.
  • ACL 감사 추적 - 누가 무엇에 접근했는지 추적하고, 규정 준수 및 사후 장애 디버깅을 위해 보존합니다.

이해하고 행동하기

  • 이상 탐지 (Pro, 얼리 액세스 기간 무료) - 상관 이벤트와 쉬운 말로 된 진단을 통한 자동 베이스라인 학습. 수동 임계값 없이 20개 이상의 탐지기.
  • 용량 예측 - 메모리, ops/sec, CPU, 단편화에 대한 한계 도달 예상 시간.
  • 웹훅 - 재시도와 전체 전송 로그를 갖춘 HMAC 서명 알림 전송.
  • 라이브 마이그레이션 - Redis와 Valkey 간 이동, 셀프 호스팅 또는 관리형(ElastiCache 노드 기반 또는 Serverless, MemoryDB, Redis Cloud, Upstash), 독립 실행형 또는 클러스터(클러스터 소스에는 클러스터 대상 필요). 3단계 분석, 실행, 검증 워크플로우와 함께, 소스가 복제 명령을 허용하는 경우 PSYNC 기반 지속적 복제로 거의 무중단 컷오버를 지원합니다. KeyDB, Dragonfly 등 다른 RESP 호환 엔진은 엔진 표에 나열된 모드에서 동작하며, 테스트 스위트에는 포함되지 않습니다. docs/migration.md를 참조하세요.

AI 시대를 위해 설계

  • 벡터 검색 관측성 - valkey-search 및 RediSearch에 대한 FT.SEARCH ops/sec 및 지연 시간과 인덱스별 상태. docs/vector-ai를 참조하세요.
  • 추론 지연 시간 - 인덱스별 p50/p95/p99와 SLA 위반 알림(Pro, 얼리 액세스 기간 무료).
  • 시맨틱 캐시 인텔리전스 (Pro, 얼리 액세스 기간 무료) - 적중률 상태, 유사도 임계값 권장 사항, 승인/거부 제안 워크플로우. 에이전트 메모리 관측성 포함.
  • AI 트레이스 - AI 애플리케이션의 OTLP 스팬 워터폴을 각 요청 아래의 라이브 Valkey 상태와 상관 분석합니다. docs/opentelemetry.md를 참조하세요.

모든 것과 연동

  • MCP 서버 - @betterdb/mcp를 통해 Claude Code, Cursor 또는 모든 MCP 클라이언트용 60개 도구.
  • Prometheus 엔드포인트 - 100개 이상의 betterdb_* 메트릭. docs/prometheus-metrics.md를 참조하세요.
  • OpenTelemetry - OTLP 트레이스를 수집하고, 메트릭과 이벤트를 모든 OTLP 백엔드로 미러링합니다. docs/opentelemetry.md를 참조하세요.
  • REST API - UI의 모든 기능은 API 호출이며, OpenAPI로 문서화되어 있습니다.

원하는 방식으로 데이터에 접근

인터페이스세부 정보
웹 UIhttp://localhost:3001
MCP 서버npx @betterdb/mcp (stdio) - Settings → MCP Tokens에서 토큰 생성 (클라우드에서는 필수, 셀프 호스팅에서는 선택)
Prometheushttp://localhost:3001/api/prometheus/metrics
REST API (OpenAPI)http://localhost:3001/docs
상태 확인http://localhost:3001/api/health

참고: 프로덕션 빌드(Docker, CLI)에서는 API 라우트가 /api 접두사 아래에서 제공됩니다. 로컬 개발(pnpm dev)에서는 접두사가 없습니다 - 예: http://localhost:3001/health.

지원 데이터베이스

데이터베이스최소 버전지원 기능
Valkey8.0+COMMANDLOG(8.1+) 및 CLUSTER SLOT-STATS를 포함한 모든 기능
Redis6+Valkey 전용인 COMMANDLOG 및 CLUSTER SLOT-STATS를 제외한 모든 기능

백엔드는 와이어 호환 iovalkey 클라이언트 위에 통합 어댑터를 사용하며, INFO 응답에서 Valkey와 Redis를 자동 감지합니다(DB_TYPE=auto). COMMANDLOG 및 SLOT-STATS와 같은 기능은 버전별로 감지되며, 기능을 사용할 수 없을 때 UI는 자연스럽게 성능이 저하됩니다.

더 읽기

카테고리

Database SecurityAnomaly DetectionLog Analysis