BetterDB Monitor

طبقة المراقبة التي يستحقها Valkey.

يحتفظ BetterDB بما يتخلص منه Valkey - السجلات البطيئة، وأنماط الأوامر، ونشاط العملاء، وإشارات الشذوذ - حتى تتمكن من تصحيح ما حدث في الساعة 3 صباحًا، وليس فقط ما يحدث الآن. مصمم لـ Valkey 8.x مع دعم أصلي لـ COMMANDLOG وCLUSTER SLOT-STATS ومقاييس الإدخال/الإخراج لكل خيط. متوافق مع Redis 6+ لكل ما عدا ذلك.

الموقع الإلكتروني | Docker Hub | npm | التوثيق | المدونة

تم بناء BetterDB بواسطة BetterDB Inc.، وهي شركة ذات منفعة عامة تعمل بموجب OCV Open Charter.

البدء السريع (Docker)```bash

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

وجّه متصفحك إلى `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

هل تتصل بقاعدة بيانات على جهازك المضيف؟ داخل الحاوية localhost هي الحاوية نفسها، وليس جهازك المضيف — لذا استخدم host.docker.internal كمضيف قاعدة البيانات. على Docker Desktop (macOS/Windows) يعمل هذا مباشرةً؛ وعلى Linux أضف --add-host=host.docker.internal:host-gateway إلى أمر docker run حتى يُترجم الاسم. زر "الاتصال بالنسخة المحلية" بنقرة واحدة في لوحة التحكم يكتشف هذا تلقائيًا ويملأ المضيف الصحيح نيابةً عنك.

يتم نشر نسختين من الصورة، وكلتاهما متعددة المعماريات (linux/amd64، linux/arm64):

الوسم	ما هو
latest، X.Y.Z-no-ai	الصورة الافتراضية - تتضمن كل ميزات المراقبة، دون التبعيات الخاصة بمساعد الذكاء الاصطناعي المحلي التجريبي (AI Helper)
X.Y.Z	تضيف مساعد الذكاء الاصطناعي التجريبي (أحضر Ollama الخاص بك؛ معطّل افتراضيًا عبر AI_ENABLED)

راجع نشر Docker للإنتاج للتخزين الدائم، والمنافذ المخصصة، والترخيص، والإعدادات المعزولة عن الشبكة.

البدء السريع (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

ثم `kubectl port-forward -n betterdb svc/betterdb-monitor 3001:3001` وافتح `http://localhost:3001`، أو فعّل ingress الخاص بالـ chart. السجل المدعوم بـ PostgreSQL، وإحضار Secrets الخاصة بك، والترخيص في البيئات المعزولة (air-gapped) كلها مشروحة في [دليل Kubernetes](https://docs.betterdb.com/kubernetes) و[README الخاص بالـ chart](https://github.com/betterdb-inc/monitor/blob/master/charts/betterdb-monitor/README.md).

## البدء السريع (CLI)

شغّل BetterDB Monitor بدون Docker:```bash
npx @betterdb/monitor

عند التشغيل الأول، يرشدك معالج إعداد تفاعلي عبر اتصال قاعدة البيانات، وخلفية التخزين (SQLite أو PostgreSQL أو في الذاكرة)، وإعدادات الخادم. يتم حفظ الإعدادات في ~/.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

يتطلب 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 و I/O** - رؤية لكل خيط لا يمكن لأي أداة Redis توفيرها.
- **تحليلات العملاء** - شاهد بالضبط أي خدمة مسؤولة عن ماذا، منسوبة حسب اسم العميل والنمط.
- **سجل تدقيق ACL** - تتبع من وصل إلى ماذا، محفوظ للامتثال وتصحيح الأخطاء بعد الحوادث.

### افهم وتصرف

- **كشف الشذوذ** (Pro، مجاني في الوصول المبكر) - تعلم تلقائي لخط الأساس مع أحداث مترابطة وتشخيصات بلغة واضحة. أكثر من 20 كاشفاً، بدون عتبات يدوية.
- **التنبؤ بالسعة** - الوقت المتوقع للوصول إلى السقف للذاكرة، والعمليات/ثانية، وCPU، والتجزئة.
- **Webhooks** - تسليمات تنبيه موقعة بـ HMAC مع إعادة المحاولات وسجل تسليم كامل.
- **الترحيل المباشر** - التنقل بين Redis وValkey مع سير عمل من ثلاث مراحل: التحليل والتنفيذ والتحقق.

### مصمم لعصر الذكاء الاصطناعي

- **مراقبة البحث المتجهي** - عمليات FT.SEARCH/ثانية وزمن الاستجابة مع صحة لكل فهرس لـ [valkey-search](https://github.com/valkey-io/valkey-search) وRediSearch. راجع [docs/vector-ai](https://github.com/betterdb-inc/monitor/blob/master/docs/vector-ai/README.md).
- **زمن استجابة الاستدلال** - p50/p95/p99 لكل فهرس، مع تنبيهات خرق SLA (Pro، مجاني في الوصول المبكر).
- **ذكاء التخزين المؤقت الدلالي** (Pro، مجاني في الوصول المبكر) - صحة معدل الإصابة، وتوصيات عتبة التشابه، وسير عمل اقتراح الموافقة/الرفض. مراقبة ذاكرة الوكيل مضمنة.
- **تتبعات الذكاء الاصطناعي** - شلالات OTLP span من تطبيق الذكاء الاصطناعي الخاص بك، مترابطة مع حالة Valkey المباشرة تحت كل طلب. راجع [docs/opentelemetry.md](https://github.com/betterdb-inc/monitor/blob/master/docs/opentelemetry.md).

### يتصل بكل شيء

- **خادم MCP** - 60 أداة لـ Claude Code أو Cursor أو أي عميل MCP عبر [`@betterdb/mcp`](https://github.com/betterdb-inc/monitor/blob/master/packages/mcp).
- **نقطة نهاية 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** - كل شيء في واجهة المستخدم هو استدعاء API، موثق عبر OpenAPI.

## الوصول إلى بياناتك بطريقتك