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)

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 فأضف --add-host=host.docker.internal:host-gateway إلى أمر docker run حتى يُحلّ الاسم. زر "الاتصال بالنسخة المحلية" بنقرة واحدة في لوحة التحكم يكتشف ذلك تلقائيًا ويملأ المضيف الصحيح نيابةً عنك.

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

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

راجع نشر Docker للإنتاج للتخزين الدائم والمنافذ المخصصة والترخيص وإعدادات البيئات المعزولة (air-gapped).

البدء السريع (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 الخاص بالـ chart. السجل المدعوم بـ PostgreSQL، واستخدام Secrets الخاصة بك، والترخيص في البيئات المعزولة (air-gapped) كلها مشمولة في دليل Kubernetes وREADME الخاص بالـ chart.

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

شغّل BetterDB Monitor دون Docker:

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 وتوزيع المفاتيح لكل slot.
• التسجيل التلقائي للعنقود - يمكن لاتصال عنقود أن يسجّل تلقائيًا كل عقدة كاتصال مراقب خاص بها، ويبقى متزامنًا مع توسّع العنقود. راجع docs/cluster-auto-registration.md.
• مقاييس خيوط CPU وI/O - رؤية لكل خيط لا يمكن لأي أداة Redis توفيرها.
• تحليلات العملاء - اعرف بالضبط أي خدمة مسؤولة عن ماذا، منسوبة حسب اسم العميل والنمط.
• سجل تدقيق ACL - تتبّع من وصل إلى ماذا، محفوظ للامتثال وتصحيح الأخطاء بعد الحوادث.

افهم وتصرّف

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

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

• مراقبة البحث المتجهي - عمليات/ثانية وزمن استجابة FT.SEARCH مع صحة لكل فهرس لـ valkey-search وRediSearch. راجع docs/vector-ai.
• زمن استجابة الاستدلال - p50/p95/p99 لكل فهرس، مع تنبيهات خرق SLA (Pro، مجانية في الوصول المبكر).
• ذكاء التخزين المؤقت الدلالي (Pro، مجانية في الوصول المبكر) - صحة معدل الإصابة، وتوصيات عتبة التشابه، وسير عمل اقتراح بالقبول/الرفض. تتضمن مراقبة ذاكرة الوكيل.
• تتبعات الذكاء الاصطناعي - شلالات spans عبر OTLP من تطبيق الذكاء الاصطناعي الخاص بك، مترابطة مع حالة Valkey المباشرة تحت كل طلب. راجع docs/opentelemetry.md.

يتصل بكل شيء