अपने ब्राउज़र को `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-आधारित इतिहास, अपना खुद का Secrets लाना, और air-gapped लाइसेंसिंग — सब कुछ [Kubernetes गाइड](https://docs.betterdb.com/kubernetes) और [चार्ट README](https://github.com/betterdb-inc/monitor/blob/master/charts/betterdb-monitor/README.md) में शामिल है।

## त्वरित आरंभ (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 में निर्यात, और कनेक्शन इतिहास के साथ क्रॉस-रेफरेंस।
- **हॉट की ट्रैकिंग** - एक्सेस आवृत्ति के आधार पर शीर्ष कुंजियाँ, समय के साथ रैंक आंदोलन के साथ। की एनालिटिक्स (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, प्रारंभिक एक्सेस में मुफ़्त) - हिट-रेट स्वास्थ्य, समानता-थ्रेशोल्ड अनुशंसाएँ, और स्वीकृति/अस्वीकृति प्रस्ताव वर्कफ़्लो। एजेंट मेमोरी अवलोकनीयता शामिल।
- **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 के माध्यम से दस्तावेज़ित।

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

| इंटरफ़ेस | विवरण |
|-----------|---------|
| वेब UI | `http://localhost:3001` |
| MCP सर्वर | `npx @betterdb/mcp` (stdio) - सेटिंग्स → MCP टोकन के तहत एक टोकन बनाएँ |
| 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`।

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

पूर्ण प्रवाह, सत्यापन प्राथमिकता, और कुंजी-रोटेशन रनबुक के लिए देखें
**[ऑफ़लाइन और एयर-गैप्ड लाइसेंस](https://github.com/betterdb-inc/monitor/blob/master/docs/offline-licenses.md)** और
**[कॉन्फ़िगरेशन संदर्भ](https://github.com/betterdb-inc/monitor/blob/master/docs/configuration.md#license-configuration)**।

### डॉकर इमेज विवरण

- **बेस इमेज**: `node:20-alpine`
- **संपीड़ित आकार**: ~360MB (`latest` / `-no-ai`) / ~640MB (प्रायोगिक AI हेल्पर की स्थानीय-LLM निर्भरताओं वाली संस्करणित इमेज)
- **प्लेटफ़ॉर्म**: `linux/amd64`, `linux/arm64`
- **शामिल**: बैकएंड API + फ्रंटएंड स्टैटिक फ़ाइलें (Fastify द्वारा परोसी गईं)
- **बाहर**: SQLite समर्थन (PostgreSQL या मेमोरी स्टोरेज का उपयोग करें)

### कंटेनर संचालन```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

To connect to Redis instead of Valkey, set `DB_PORT=6382` in `.env`.```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/` में नए एंडपॉइंट जोड़ें
2. `apps/web/src/api/` में संबंधित API कॉल जोड़ें
3. `packages/shared/src/types/` में साझा प्रकार जोड़ें

### कोड शैली

- TypeScript सख्त मोड, स्पष्ट रिटर्न प्रकार, कोई `any` नहीं
- ESLint + Prettier कॉन्फ़िगर किया गया

## लाइसेंस

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