अपने ब्राउज़र को `http://localhost:3001` पर इंगित करें। किसी विशिष्ट इंस्टेंस की निगरानी करने के लिए:```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

फिर `kubectl port-forward -n betterdb svc/betterdb-monitor 3001:3001` और `http://localhost:3001` खोलें, या चार्ट का ingress सक्षम करें। PostgreSQL-आधारित history, bring-your-own Secrets, और air-gapped licensing सभी [Kubernetes guide](https://docs.betterdb.com/kubernetes) और [chart README](https://github.com/betterdb-inc/monitor/blob/master/charts/betterdb-monitor/README.md) में शामिल हैं।

## Quick Start (CLI)

Docker के बिना BetterDB Monitor चलाएँ:```bash
npx @betterdb/monitor

Node.js >= 20.0.0 और निगरानी के लिए एक Valkey या Redis इंस्टेंस की आवश्यकता होती है। SQLite स्टोरेज के लिए, `npm install -g better-sqlite3` भी आवश्यक है।

## आपको क्या मिलता है

### सब कुछ देखें, सब कुछ रखें

- **ऐतिहासिक एनालिटिक्स** - किसी भी समय सीमा में slowlogs, कमांड पैटर्न, क्लाइंट गतिविधि और लेटेंसी क्वेरी करें। वह डेटा जो पहले लॉग रोटेशन के बाद गायब हो जाता था।
- **COMMANDLOG समर्थन** - Valkey 8.1+ विशेष। बड़े अनुरोध और बड़े उत्तर, केवल धीमे वाले ही नहीं।
- **MONITOR कैप्चर सेशन** - मांग पर वास्तविक ट्रैफ़िक रिकॉर्ड करें: लाइव टेल, फ़िल्टर, रीप्ले, JSON/CSV में एक्सपोर्ट, और कनेक्शन इतिहास के साथ क्रॉस-रेफ़रेंस करें।
- **हॉट की ट्रैकिंग** - समय के साथ रैंक मूवमेंट के साथ एक्सेस फ़्रीक्वेंसी के अनुसार शीर्ष कीज़। Key Analytics (Pro, अर्ली एक्सेस में मुफ़्त) लाइव सैंपलिंग से टाइप, TTL, और साइज़ डिस्ट्रिब्यूशन जोड़ता है।
- **क्लस्टर विज़िबिलिटी** - टोपोलॉजी ग्राफ़, SLOT-STATS हीटमैप, प्रति-स्लॉट CPU और की डिस्ट्रिब्यूशन।
- **CPU और I/O थ्रेड मेट्रिक्स** - प्रति-थ्रेड विज़िबिलिटी जो कोई भी Redis टूल प्रदान नहीं कर सकता।
- **क्लाइंट एनालिटिक्स** - देखें कि कौन सी सेवा किसके लिए ज़िम्मेदार है, क्लाइंट नाम और पैटर्न द्वारा एट्रिब्यूटेड।
- **ACL ऑडिट ट्रेल** - ट्रैक करें कि किसने क्या एक्सेस किया, अनुपालन और पोस्ट-इंसिडेंट डिबगिंग के लिए सुरक्षित।

### समझें और कार्य करें

- **एनोमली डिटेक्शन** (Pro, अर्ली एक्सेस में मुफ़्त) - सहसंबंधित इवेंट्स और सरल-भाषा निदान के साथ स्वचालित बेसलाइन लर्निंग। 20+ डिटेक्टर, कोई मैनुअल थ्रेशोल्ड नहीं।
- **क्षमता पूर्वानुमान** - मेमोरी, ops/sec, CPU, और फ्रैगमेंटेशन के लिए अनुमानित समय-से-सीमा।
- **वेबहुक** - रिट्री और पूर्ण डिलीवरी लॉग के साथ HMAC-हस्ताक्षरित अलर्ट डिलीवरी।
- **लाइव माइग्रेशन** - तीन-चरणीय विश्लेषण, निष्पादन, और सत्यापन वर्कफ़्लो के साथ Redis और Valkey के बीच स्थानांतरित करें।

### AI युग के लिए निर्मित

- **वेक्टर सर्च ऑब्ज़र्वेबिलिटी** - [valkey-search](https://github.com/valkey-io/valkey-search) और RediSearch के लिए प्रति-इंडेक्स हेल्थ के साथ FT.SEARCH ops/sec और लेटेंसी। देखें [docs/vector-ai](https://github.com/betterdb-inc/monitor/blob/master/docs/vector-ai/README.md)।
- **इन्फरेंस लेटेंसी** - प्रति इंडेक्स p50/p95/p99, SLA उल्लंघन अलर्ट के साथ (Pro, अर्ली एक्सेस में मुफ़्त)।
- **सेमांटिक कैश इंटेलिजेंस** (Pro, अर्ली एक्सेस में मुफ़्त) - हिट-रेट हेल्थ, सिमिलैरिटी-थ्रेशोल्ड सिफ़ारिशें, और एक approve/reject प्रस्ताव वर्कफ़्लो। एजेंट मेमोरी ऑब्ज़र्वेबिलिटी शामिल।
- **AI ट्रेस** - आपके AI एप्लिकेशन से OTLP स्पैन वॉटरफ़ॉल, प्रत्येक अनुरोध के नीचे लाइव Valkey स्थिति के साथ सहसंबंधित। देखें [docs/opentelemetry.md](https://github.com/betterdb-inc/monitor/blob/master/docs/opentelemetry.md)।

### हर चीज़ में प्लग होता है

- **MCP सर्वर** - [`@betterdb/mcp`](https://github.com/betterdb-inc/monitor/blob/master/packages/mcp) के माध्यम से Claude Code, Cursor, या किसी भी MCP क्लाइंट के लिए 60 टूल।
- **Prometheus एंडपॉइंट** - 100+ `betterdb_*` मेट्रिक्स। देखें [docs/prometheus-metrics.md](https://github.com/betterdb-inc/monitor/blob/master/docs/prometheus-metrics.md)।
- **OpenTelemetry** - OTLP ट्रेस इनजेस्ट करें, और किसी भी OTLP बैकएंड में मेट्रिक्स और इवेंट्स मिरर करें। देखें [docs/opentelemetry.md](https://github.com/betterdb-inc/monitor/blob/master/docs/opentelemetry.md)।
- **REST API** - UI में सब कुछ एक API कॉल है, OpenAPI के माध्यम से प्रलेखित।

## अपने डेटा तक अपने तरीके से पहुँचें

| इंटरफ़ेस | विवरण |
|-----------|---------|
| Web UI | `http://localhost:3001` |
| MCP सर्वर | `npx @betterdb/mcp` (stdio) - Settings → MCP Tokens के अंतर्गत एक टोकन बनाएँ (क्लाउड पर आवश्यक, सेल्फ-होस्टेड पर वैकल्पिक) |
| Prometheus | `http://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`।

## समर्थित डेटाबेस

| डेटाबेस | न्यूनतम संस्करण | समर्थित सुविधाएँ |
|----------|----------------|-------------------|
| **Valkey** | 8.0+ | COMMANDLOG (8.1+) और CLUSTER SLOT-STATS सहित सभी सुविधाएँ |
| **Redis** | 6+ | Valkey-विशेष COMMANDLOG और CLUSTER SLOT-STATS को छोड़कर सभी सुविधाएँ |

बैकएंड वायर-संगत `iovalkey` क्लाइंट पर एक एकीकृत एडाप्टर का उपयोग करता है और `INFO` प्रतिक्रिया (`DB_TYPE=auto`) से Valkey बनाम Redis का स्वतः पता लगाता है। COMMANDLOG और SLOT-STATS जैसी क्षमताएँ प्रति संस्करण का पता लगाई जाती हैं, और जब कोई सुविधा उपलब्ध नहीं होती तो UI सुचारू रूप से डिग्रेड हो जाता है।

प्रबंधित सेवाएँ भी समर्थित हैं - AWS ElastiCache, MemoryDB, Redis Cloud, और Upstash के लिए गाइड [docs/providers](https://github.com/betterdb-inc/monitor/blob/master/docs/providers) में हैं, और [`@betterdb/agent`](https://github.com/betterdb-inc/monitor/blob/master/packages/agent) आउटबाउंड WebSocket के माध्यम से केवल-VPC इंस्टेंस तक पहुँचता है।

## Docker प्रोडक्शन डिप्लॉयमेंट

Docker इमेज में मॉनिटरिंग एप्लिकेशन (बैकएंड + फ्रंटएंड) शामिल है। इसके लिए आवश्यक है:
1. निगरानी के लिए एक Valkey/Redis इंस्टेंस
2. डेटा पर्सिस्टेंस के लिए एक PostgreSQL इंस्टेंस (या मेमोरी स्टोरेज का उपयोग करें)

### PostgreSQL स्टोरेज के साथ चलाएँ```bash
docker run -d \
  --name betterdb-monitor \
  -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@postgres-host:5432/dbname \
  betterdb/monitor

### होस्ट नेटवर्क के साथ चलाएँ (localhost सेवाओं तक पहुँचें)

यदि आपके Valkey और PostgreSQL एक ही होस्ट पर चल रहे हैं:```bash
docker run -d \
  --name betterdb-monitor \
  --network host \
  -e DB_HOST=localhost \
  -e DB_PORT=6380 \
  -e DB_PASSWORD=devpassword \
  -e STORAGE_TYPE=postgres \
  -e STORAGE_URL=postgresql://dev:devpass@localhost:5432/postgres \
  betterdb/monitor

`GET /api/license/status` से सत्यापित करें → `source: offline-token`, `mode: offline`,
`airGapped: true`.

> **स्थायित्व:** `/app/data` पर एक लेखन-योग्य वॉल्यूम माउंट करें ताकि ऑफ़लाइन लाइसेंस और
> ऑनलाइन आउटेज-ग्रेस टोकन पुनःआरंभ के बाद भी बने रहें। कंटेनर **UID 1001** के रूप में चलता है,
> इसलिए नए बनाए गए वॉल्यूम को इसी के लिए `chown` किया जाना चाहिए (ऊपर दिखाया गया है) - अन्यथा
> स्थायित्व `EACCES … license.jwt` के साथ विफल हो जाता है।

पूर्ण प्रवाह, सत्यापन प्राथमिकता, और कुंजी-रोटेशन रनबुक के लिए देखें
**[Offline & Air-Gapped Licenses](https://github.com/betterdb-inc/monitor/blob/master/docs/offline-licenses.md)** और
**[Configuration reference](https://github.com/betterdb-inc/monitor/blob/master/docs/configuration.md#license-configuration)**।

### Docker Image Details

- **Base Image**: `node:20-alpine`
- **Compressed size**: ~360MB (`latest` / `-no-ai`) / ~640MB (प्रायोगिक AI Helper की स्थानीय-LLM निर्भरताओं वाली संस्करणित इमेज)
- **Platforms**: `linux/amd64`, `linux/arm64`
- **Contains**: Backend API + Frontend static files (Fastify द्वारा सर्व किए गए)
- **Excluded**: SQLite समर्थन (PostgreSQL या Memory storage का उपयोग करें)

### Container Operations```bash
docker logs -f betterdb-monitor        # follow logs
docker stop betterdb-monitor           # stop
docker rm betterdb-monitor             # remove

पूर्ण मेट्रिक संदर्भ: [docs/prometheus-metrics.md](https://github.com/betterdb-inc/monitor/blob/master/docs/prometheus-metrics.md) और [docs/prometheus-integration.md](https://github.com/betterdb-inc/monitor/blob/master/docs/prometheus-integration.md)।

## विकास

### परियोजना संरचना```
betterdb-monitor/
├── apps/
│   ├── api/                 # NestJS backend (Fastify)
│   └── web/                 # React frontend (Vite)
├── packages/                # Published packages (see below)
├── docs/                    # Documentation site (Jekyll)
├── docker-compose.yml       # Local Valkey (port 6380) and Redis (port 6382) for testing
└── package.json             # Workspace root

Redis से कनेक्ट करने के लिए Valkey के बजाय, `.env` में `DB_PORT=6382` सेट करें।```bash
pnpm dev:api           # API only
pnpm dev:web           # frontend only
pnpm docker:dev:down   # stop local databases
pnpm build             # production build
pnpm test              # API tests

### नई सुविधाएँ जोड़ना

1. `apps/api/src/` में नए endpoints जोड़ें
2. `apps/web/src/api/` में संबंधित API calls जोड़ें
3. `packages/shared/src/types/` में साझा types जोड़ें

### कोड शैली

- TypeScript strict mode, स्पष्ट return types, `any` का प्रयोग नहीं
- ESLint + Prettier कॉन्फ़िगर किया गया

## लाइसेंस

- `docs/` के अंतर्गत सामग्री CC BY-SA 4.0 के अंतर्गत लाइसेंस प्राप्त है।
- `proprietary/` के अंतर्गत सामग्री एक व्यावसायिक लाइसेंस द्वारा कवर की गई है (देखें `proprietary/LICENSE`)। ये सुविधाएँ early access के दौरान निःशुल्क हैं।
- बाकी सब कुछ [MIT](https://github.com/betterdb-inc/monitor/blob/master/LICENSE) है।