🔭 تثبيت HyperDX — مراقبة مفتوحة المصدر بالسجلات والتتبعات وإعادة تشغيل الجلسات

انشر HyperDX على Ubuntu باستخدام Docker — منصة مراقبة مفتوحة المصدر للسجلات والتتبعات والمقاييس وإعادة تشغيل الجلسات في واجهة واحدة، مبنية على ClickHouse وOpenTelemetry، مع التطبيق على المنفذ 8310.

⚠️ راجع أي سكريبت دائمًا قبل تشغيله على سيرفرك، واختبره في بيئة تجريبية أولاً.

📦 الملفات والأكواد المطلوبة

قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.

سكريبت تثبيت آلي — أمر واحد ينشر صورة HyperDX الشاملة على المنفذ 8310 مع ClickHouse مدمج. أرسل بيانات OpenTelemetry واستكشف السجلات والتتبعات والمقاييس وإعادة تشغيل الجلسات معاً في مكان واحد.
عرض على GitHub

التثبيت السريع:

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/monitoring/hyperdx/hyperdx-ubuntu.sh
chmod +x hyperdx-ubuntu.sh
./hyperdx-ubuntu.sh

خطوات التنفيذ

1 تحميل السكريبت

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/monitoring/hyperdx/hyperdx-ubuntu.sh

2 منحه صلاحية التنفيذ

chmod +x hyperdx-ubuntu.sh

3 تشغيل المثبت

./hyperdx-ubuntu.sh

4 فتح HyperDX وإرسال بيانات القياس عن بُعد

http://your-server-ip:8310

المنافذ المستخدمة

المنفذالغرض
8310HyperDX app UI (mapped from container port 8080)
8311HyperDX API (mapped from container port 8000)
4320OpenTelemetry OTLP over HTTP ingest (mapped from container port 4318)
4321OpenTelemetry OTLP over gRPC ingest (mapped from container port 4317)

نظرة عامة

HyperDX منصة مراقبة مفتوحة المصدر توحّد السجلات والتتبعات والمقاييس وإعادة تشغيل جلسات الواجهة الأمامية في واجهة واحدة، بحيث يستطيع المهندسون ربط الإشارات ببعضها أثناء تصحيح الأخطاء بدلاً من التنقل بين أدوات منفصلة. مبني على ClickHouse لاستعلامات سريعة عبر كميات ضخمة من بيانات القياس، ومتوافق بشكل أصلي مع OpenTelemetry، أنشأه فريق HyperDX ويُصان الآن من قبل ClickHouse ضمن مشروع ClickStack. صورة Docker الشاملة هذه تجمع تطبيق HyperDX مع ClickHouse معاً، فلا حاجة لتوفير قاعدة بيانات منفصلة — تحصل على مكدس مراقبة كامل في حاوية واحدة.

لماذا تستخدمه

تتطلب إعدادات المراقبة التقليدية تشغيل وربط عدة أدوات منفصلة معاً — مجمّع سجلات، وخلفية تتبع، وقاعدة بيانات مقاييس، وطبقة لوحات معلومات — لكل منها لغة استعلام خاصة ومكان مستقل تنظر فيه عند تصحيح مشكلة إنتاج. يدمج HyperDX كل ذلك في منصة واحدة: تعيش السجلات والتتبعات الموزعة والمقاييس وإعادة تشغيل الجلسات معاً ويمكن ربطها بحسب الطلب أو الجلسة أو النطاق الزمني في واجهة واحدة. ولأنه يتحدث OpenTelemetry بشكل أصلي، فإنك تُجهّز تطبيقاتك مرة واحدة باستخدام المعيار المفتوح ولا ترتبط بعميل احتكاري. ولأنه مفتوح المصدر وذاتي الاستضافة، تحتفظ بملكية كاملة لبيانات القياس الحساسة المحتملة بدلاً من إرسالها لمزوّد مراقبة SaaS خارجي.

متى تحتاجه

  • فريقك يصحّح مشكلات الإنتاج بالتنقل بين أدوات سجلات وتتبعات ومقاييس منفصلة ويخسر وقتاً في ربطها يدوياً
  • تُجهّز تطبيقاتك بالفعل بـ OpenTelemetry وتريد خلفية تستقبل بيانات OTLP أصلياً دون طبقات ترجمة
  • تريد إعادة تشغيل جلسات الواجهة الأمامية مرتبطة بنفس تتبعات وسجلات الخلفية، لرؤية ما فعله المستخدم بالضبط قبل حدوث خطأ
  • تتجاوز عارض سجلات بسيط وتحتاج استعلامات سريعة عبر كميات كبيرة من بيانات القياس المهيكلة وغير المهيكلة
  • تريد تجنب التكاليف المتكررة لمنصات مراقبة SaaS تجارية تفرض رسوماً لكل جيجابايت من البيانات المُستقبلة
  • تحتاج منصة واحدة ذاتية الاستضافة بدلاً من صيانة نشرات Prometheus وLoki وTempo وGrafana منفصلة

من يحتاجه

  • مهندسو الخلفية والمنصة الذين يحتاجون تصحيح حوادث الإنتاج بربط السجلات والتتبعات والمقاييس بسرعة
  • فرق الواجهة الأمامية التي تريد إعادة تشغيل جلسات مرتبطة بأخطاء الخلفية لإعادة إنتاج وفهم الأخطاء المُبلَّغة من المستخدمين
  • فرق DevOps وSRE التي توحّد المراقبة حول معيار OpenTelemetry عبر خدمات متعددة
  • الشركات الناشئة والفرق الصغيرة التي تريد مراقبة بمستوى المؤسسات دون تسعير المنصات التجارية لكل جيجابايت
  • عشاق الاستضافة الذاتية والمنظمات المهتمة بالخصوصية التي لا تريد مغادرة بيانات القياس لبنيتها التحتية
  • الفرق التي تُشغّل ClickHouse بالفعل في مكان آخر وتريد طبقة مراقبة تندمج طبيعياً مع مكدسها الحالي

حالات الاستخدام الشائعة

  • ربط طلب API بطيء عبر سجلاته وامتدادات تتبعه الموزع ومقاييسه ذات الصلة في بحث واحد
  • إعادة تشغيل جلسة متصفح مستخدم قبل حدوث خطأ JavaScript لرؤية ما تسبب فيه بالضبط
  • ضبط تنبيهات على معدل الأخطاء أو ارتفاعات زمن الاستجابة والحصول على إشعار قبل أن يُبلّغ العملاء عن مشكلة
  • البحث وتصفية سجلات التطبيق عالية الحجم باستعلامات SQL أو بأسلوب Lucene بدلاً من grep على ملفات السجل
  • بناء لوحات معلومات تجمع المقاييس والنسب المئوية لزمن استجابة التتبع وحجم السجلات لنظرة عامة على صحة الخدمة
  • تتبع طلب عبر خدمات مصغّرة متعددة لتحديد أي خدمة أضافت زمن استجابة إضافياً

الميزات الرئيسية

  • واجهة موحدة للسجلات والتتبعات الموزعة والمقاييس وإعادة تشغيل جلسات الواجهة الأمامية مع ربط عبر الإشارات
  • استقبال أصلي لـ OpenTelemetry عبر OTLP/HTTP وOTLP/gRPC، بحيث يعمل أي تطبيق مُجهّز بـ OTel دون عميل احتكاري
  • مدعوم بـ ClickHouse لاستعلامات سريعة بدون مخطط ثابت عبر كميات كبيرة من بيانات القياس
  • يدعم كلاً من صيغة بحث بأسلوب Lucene واستعلامات SQL الخام لاستكشاف مرن للسجلات والتتبعات
  • لوحات معلومات تفاعلية لبناء تصورات مخصصة من سجلاتك ومقاييسك وتتبعاتك المُستقبلة
  • تنبيهات على عمليات البحث المحفوظة والمقاييس بحيث تُخطر عندما يتجاوز معدل الأخطاء أو زمن الاستجابة عتبة معينة
  • إعادة تشغيل الجلسات التي تعيد بناء ما رآه المستخدم وفعله في المتصفح، مرتبطة بأخطاء الخلفية
  • نموذج مفتوح النواة — النسخة ذاتية الاستضافة برخصة MIT تغطي ميزات المراقبة الأساسية

كيفية الاستخدام بعد التثبيت

  • افتح واجهة HyperDX على http://your-server-ip:8310 وأنشئ حسابك ومساحة عملك الأولى
  • جهّز تطبيقاتك بحزمة OpenTelemetry SDK للغتك واضبط مُصدِّر OTLP ليشير إلى منافذ الاستقبال (4320 لـ HTTP و4321 لـ gRPC)
  • تأكد من وصول بيانات القياس بفحص عرضي Logs وTraces بحثاً عن أحداث من خدماتك المُجهّزة
  • أضف حزمة HyperDX SDK للمتصفح إلى تطبيق الواجهة الأمامية إذا أردت إعادة تشغيل جلسات مرتبطة بأخطاء الخلفية
  • ابنِ لوحة معلومات تجمع المقاييس والسجلات والتتبعات الأكثر صلة بصحة خدمتك
  • اضبط تنبيهات على إشارات رئيسية مثل معدل الأخطاء أو زمن استجابة p95 حتى يُخطَر فريقك استباقياً
  • خطّط لسياسة احتفاظ بالبيانات في ClickHouse، لأن حجم بيانات القياس ينمو بسرعة والاحتفاظ غير المحدود سيستهلك مساحة القرص

أفضل ممارسات الأمان

  • أنشئ كلمة مرور أولية قوية عند إعداد مساحة عمل HyperDX وتجنّب مشاركة تسجيل دخول واحد مشترك
  • ضع واجهة HyperDX (المنفذ 8310) وواجهة API (المنفذ 8311) خلف وكيل عكسي مع HTTPS قبل السماح بأي وصول خارج شبكتك المحلية
  • قيّد منافذ استقبال OTLP (4320، 4321) في جدار الحماية على المضيفين والخدمات التي ترسل بيانات القياس فعلياً فقط
  • لا تكشف منافذ ClickHouse نفسها مباشرة للإنترنت أبداً — يجب أن تبقى قابلة للوصول فقط من تطبيق HyperDX ضمن شبكة Docker
  • انتبه أن إعادة تشغيل الجلسات قد تلتقط إدخال مستخدم حساس — اضبط إخفاء الحقول لحقول كلمة المرور والدفع في حزمة SDK للمتصفح
  • حافظ على تحديث صورة Docker لـ HyperDX، لأن أداة مراقبة تستقبل بيانات غير موثوقة تُشكّل جزءاً مهماً من سطح هجومك
  • راجع من يملك وصولاً لمساحة عمل HyperDX، لأن التتبعات والسجلات غالباً ما تحتوي بيانات طلبات حساسة وترويسات ومعرّفات مستخدمين

المنافذ وإعدادات جدار الحماية

تكشف صورة HyperDX الشاملة أربعة منافذ: 8310 لواجهة التطبيق (معيّن من منفذ الحاوية 8080)، و8311 لواجهة API (معيّن من 8000)، و4320 لاستقبال OpenTelemetry OTLP عبر HTTP (معيّن من 4318)، و4321 لاستقبال OTLP عبر gRPC (معيّن من 4317). يجب أن تكون منفذا الواجهة وAPI خلف وكيل عكسي مع TLS إذا وُصل إليهما خارج شبكتك المحلية، لأنهما يحملان مصادقة وبيانات قياس حساسة محتملة. تحتاج منافذ استقبال OTLP أن تكون قابلة للوصول من كل خدمة تُجهّزها، لكن يجب أن تبقى مقيّدة في جدار الحماية على مضيفي تطبيقاتك المعروفين بدلاً من فتحها للإنترنت العام — نقطة استقبال OTLP مفتوحة وغير مصادَق عليها يمكن استخدامها لحقن بيانات قياس مزيفة أو استنزاف مساحة التخزين. يعمل ClickHouse نفسه داخلياً ويجب ألا يُنشر مباشرة للمضيف أو الإنترنت أبداً.

النسخ الاحتياطي والصيانة

  • احفظ نسخة احتياطية من حجم بيانات ClickHouse، الذي يخزن كل السجلات والتتبعات والمقاييس وتسجيلات إعادة تشغيل الجلسات المُستقبلة
  • احفظ نسخة احتياطية من حجم قاعدة بيانات/إعدادات تطبيق HyperDX بشكل منفصل، لأنه يحتفظ بلوحات المعلومات والتنبيهات وعمليات البحث المحفوظة وحسابات المستخدمين
  • احفظ docker-compose.yml وأي متغيرات بيئة حتى يمكن إعادة إنشاء المكدس — بما في ذلك إعدادات ClickHouse — بشكل مطابق
  • جدول نسخاً احتياطية تلقائية لـ ClickHouse بدلاً من الاعتماد على لقطات يدوية، لأن حجم بيانات القياس وقيمتها ينموان باستمرار
  • حدّد ووثّق سياسة احتفاظ بحيث تُحذف بيانات القياس القديمة تلقائياً بدلاً من نمو استخدام القرص إلى ما لا نهاية
  • اختبر استعادة نسخة احتياطية من ClickHouse دورياً للتأكد أن لوحات المعلومات والتنبيهات والبيانات التاريخية تعود جميعها بشكل صحيح

الأخطاء الشائعة

  • كشف منافذ استقبال OTLP مباشرة للإنترنت العام بدون أي تقييد شبكي، مما يسمح لأي شخص بحقن بيانات قياس مزيفة
  • عدم ضبط سياسة احتفاظ أو TTL في ClickHouse أبداً، مما يترك استخدام القرص ينمو بلا حدود مع تراكم بيانات القياس
  • تجهيز التطبيقات بدون أخذ عينات في الخدمات عالية الحركة جداً، مما قد يُغرق الاستقبال ويضخّم تكاليف التخزين
  • نسيان إخفاء الحقول الحساسة في إعادة تشغيل الجلسات، مما يلتقط كلمات المرور أو تفاصيل الدفع في الجلسات المسجلة
  • تشغيل الصورة التجريبية الشاملة في بيئة إنتاج دون مراجعة حدود مواردها وخصائص التوسع أولاً
  • عدم تقييد من يستطيع الوصول لمساحة عمل HyperDX، رغم أن التتبعات والسجلات غالباً ما تحتوي بيانات طلبات حساسة

استكشاف الأخطاء وإصلاحها

  • لا تظهر بيانات القياس في الواجهة — تحقق أن نقطة نهاية مُصدِّر OTLP لتطبيقك تطابق منفذ الاستقبال الصحيح (4320 لـ HTTP و4321 لـ gRPC) وأن جدار الحماية يسمح بالاتصال
  • واجهة HyperDX لا تُحمّل — تأكد أن الحاوية تعمل بأمر docker ps وأن المنفذ 8310 غير محظور بجدار حماية المضيف
  • التتبعات تظهر لكن الامتدادات لا تتصل في تتبع واحد — تحقق أن ترويسات نشر سياق التتبع مضبوطة بشكل صحيح عبر حدود الخدمات في إعداد OpenTelemetry SDK لديك
  • الاستعلامات بطيئة على مجموعات بيانات كبيرة — تحقق من تخصيص موارد ClickHouse (المعالج/الذاكرة) وتأكد من وجود سياسة احتفاظ/TTL معقولة للحد من حجم الجداول
  • إعادة تشغيل الجلسات لا تُسجّل — تأكد أن حزمة SDK للمتصفح مُهيّأة بشكل صحيح وأن سياسة أمان المحتوى لا تحظر نصها البرمجي
  • استخدام القرص يرتفع بسرعة — راجع إعدادات الاحتفاظ في ClickHouse وقلّل حجم سجلات مستوى التصحيح المُستقبلة

البدائل

SigNoz منصة مراقبة شاملة مفتوحة المصدر مشابهة جداً، مبنية أيضاً على ClickHouse وOpenTelemetry، وهي أحد أقرب منافسي HyperDX المباشرين في مجال الاستضافة الذاتية. Grafana مع Prometheus وLoki وTempo هو مكدس المراقبة الكلاسيكي المفتوح المصدر — أكثر مرونة ونمطية لأن كل مكون قابل للاستبدال بشكل مستقل، لكنه يتطلب تشغيل ودمج عدة أنظمة منفصلة بدلاً من نظام واحد. OpenObserve بديل آخر خفيف قريب من ClickHouse يركز أساساً على السجلات مع دعم متنامٍ للتتبعات والمقاييس. منصات SaaS تجارية مثل Datadog وNew Relic وHoneycomb تقدّم تجارب متطورة ومُدارة بالكامل بحد أدنى من العبء التشغيلي، لكنها تفرض رسوماً متكررة كبيرة، غالباً بحسب الجيجابايت المُستقبل، وتتطلب إرسال بيانات القياس لسحابة طرف ثالث.

متى لا تستخدمه

HyperDX ليس الخيار المناسب إذا كان فريقك يمتلك بالفعل مكدس Prometheus/Grafana/Loki يعمل بشكل جيد ولا يحتاج إعادة تشغيل جلسات أو واجهة موحدة واحدة — ترحيل إعداد مراقبة يعمل له تكلفة حقيقية بعائد غير مؤكد. كما يفترض بعض الارتياح لعمليات ClickHouse؛ إذا لم تكن مستعداً لتخطيط سياسات الاحتفاظ ومراقبة استخدام موارد ClickHouse، يمكن لحجم بيانات القياس أن يستهلك مساحة القرص بصمت أو يُضعف أداء الاستعلامات. للمشاريع الصغيرة جداً ذات الحركة المحدودة، قد يكفيك ملف سجل بسيط بالإضافة لمراقبة توفر أساسية، مما يجعل منصة مراقبة كاملة عبئاً غير ضروري. وإذا كانت مؤسستك تتطلب حلاً مُداراً بالكامل بدون صيانة وبضمانات مستوى خدمة، فمنصة مراقبة SaaS تجارية ستناسب هذا المتطلب أفضل من نشر ذاتي الاستضافة أنت المسؤول عن تشغيله.

هل تحتاج مساعدة احترافية؟

توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.

  • التثبيت وتجهيز السيرفر
  • الإعداد المتقدم وإعداد التوجيه
  • تصليب الأمان وتحسين جدار الحماية
  • إعداد شهادات SSL/TLS مع Let's Encrypt
  • ربط النطاق المخصص والوكيل العكسي
  • جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
  • المراقبة الفورية وتنبيهات الجاهزية
  • الترحيل من المنصات القائمة
  • استكشاف مشكلات الاتصال والأداء وإصلاحها
  • سكريبتات أتمتة مخصصة وعقود دعم مستمر
تواصل مع PrismaTechWork

الأسئلة الشائعة

ما هو HyperDX؟

HyperDX منصة مراقبة مفتوحة المصدر توحّد السجلات والتتبعات والمقاييس وإعادة تشغيل جلسات الواجهة الأمامية في واجهة واحدة، بحيث يمكنك ربط الإشارات أثناء تصحيح الأخطاء بدلاً من التنقل بين الأدوات. إنه مبني على ClickHouse لاستعلامات سريعة عبر بيانات كبيرة، وأصلي التوافق مع OpenTelemetry. هذا التثبيت الشامل يجمع ClickHouse ويُشغّل التطبيق على المنفذ 8310، مع استقبال OpenTelemetry على المنفذين 4320 و4321.

ما المنافذ التي يستخدمها؟

أربعة منافذ: واجهة التطبيق على المنفذ 8310 على المضيف (من منفذ الحاوية 8080)، وAPI على 8311، ونقطتا استقبال OpenTelemetry — 4320 لـ OTLP عبر HTTP و4321 لـ OTLP عبر gRPC. تُرسل تطبيقاتك بيانات القياس إلى منفذي OTLP، وتشاهدها عبر الواجهة. ضع الواجهة خلف وكيل عكسي مع TLS، وأبقِ منفذي الاستقبال قابلين للوصول فقط من الخدمات التي تُجهّزها.

كيف يختلف عن Prometheus وGrafana؟

يشكّل Prometheus وGrafana، عادة إلى جانب Loki وTempo، مكدساً من مكونات منفصلة مُنتقاة بعناية تُشغّلها وتربطها معاً — مرن جداً لكن بعدة أجزاء متحركة. يهدف HyperDX ليكون منصة واحدة متكاملة تتعامل مع السجلات والتتبعات والمقاييس وإعادة تشغيل الجلسات معاً بربط مدمج، على ClickHouse. كلاهما خيار صالح؛ يقايض HyperDX مرونة المكدس بنظام موحد واحد، ويضيف إعادة تشغيل الجلسات التي لا يتضمنها المكدس الكلاسيكي.

هل أحتاج OpenTelemetry لاستخدامه؟

عملياً نعم — يستقبل HyperDX بيانات القياس عبر OpenTelemetry، المعيار المحايد للمزوّدين، لذا تُجهّز تطبيقاتك لإصدار بيانات OTLP وتوجيه مُصدِّراتها إلى منافذ استقبال HyperDX. ميزة هذا التصميم أنك لست مرتبطاً بعميل احتكاري: لأن OpenTelemetry معيار مفتوح، يمكنك توجيه نفس التجهيز إلى خلفية مختلفة لاحقاً، مما يتجنب الارتباط الذي تخلقه عملاء المراقبة الاحتكارية.

لماذا يستخدم ClickHouse؟

ClickHouse قاعدة بيانات عمودية مصممة لاستعلامات تحليلية سريعة عبر كميات ضخمة جداً من البيانات، وهذا بالضبط شكل أعباء عمل المراقبة — كميات هائلة من السجلات والتتبعات والمقاييس تحتاج بحثها وتجميعها بسرعة. يخزّن HyperDX كل شيء في ClickHouse لتلك السرعة، وهذه الصورة الشاملة تجمعه فلا شيء منفصل يجب إعداده. التبعة العملية هي أن ClickHouse يحتاج موارد كافية، ويجب أن تخطط للاحتفاظ لأن بيانات القياس تنمو بسرعة.