إنتقل إلى المحتوى الرئيسي
الإصدار: 0.4 · الحالي

البنية

مفهومتمت المراجعة في 11 أكتوبر 2026
ينطبق على:Excubius 0.4الأدوار: مسؤول الكيان, المسؤول الأعلى, القائم بالتثبيت (مسؤول Linux)
الخططFree · Core · Pro · Enterpriseالنشراستضافة ذاتية

يعمل Excubius في مجموعة صغيرة من الحاويات على خادم Linux واحد تتحكم فيه. يغذّي مُجمِّع للقراءة فقط، وأدوات المراقبة التي تملكها بالفعل، مسارًا واحدًا يحوّل كل شيء إلى موارد وحالات وتنبيهات، ثم يخزّنها في قاعدة بيانات واحدة ويقدّمها لتطبيق الويب وSlack وJira وصفحة حالة عامة. تشرح هذه المقالة كل مكوّن، وكيف يتحول القياس إلى تنبيه، وكيف يُنظَّم الخادم، وما الذي يُخزَّن وأين.

المكونات وكيف ترتبط​

المكوّنوظيفته
المُجمِّعينفّذ فحوص الكتالوج على أنظمتك: T-SQL لـ SQL Server، وHTTP وDNS لنقاط النهاية والشهادات والنطاقات، وواجهات Azure وMicrosoft Graph، وعمليات بحث Wazuh. ودعم Windows عبر WinRM وLinux عبر SSH تجريبي. ويستطلع أيضًا الأدوات التي تملكها. يتصل ببيانات اعتماد لا تملك أي إذن كتابة، ويحتفظ بنتائجه في مخزن مؤقت أثناء انشغال الخادم أو إعادة تشغيله
المصادرNew Relic وNinjaOne وAzure Monitor، ويُقرأ كل منها بالاستطلاع أو بـ webhook أو بالاثنين معًا. وما تبلّغ عنه ينضم إلى المسار نفسه الذي تدخله نتائج المُجمِّع، فتصل تنبيهاتها إلى صندوق الوارد نفسه وإلى القنوات نفسها
المُطبِّعيحوّل كل مُدخَل إلى الأشكال الثلاثة نفسها: مورد أو نتيجة فحص أو تنبيه. وتُطابَق الموارد بين المصادر بمعرّفات مثل معرّف مورد Azure واسم المضيف وFQDN، فيكون الخادم الواحد الذي تراه ثلاث أدوات موردًا واحدًا
محرك التنبيهاتيقارن كل نتيجة بحدودها الفعلية، ويفتح التنبيهات ويصعّدها ويحلّها، ويزيل تكرارها، ويجمعها تحت سبب جذري، ويحتجز الإشعارات أثناء الكتم ونوافذ الصيانة، ويحدد حالة كل مورد
قاعدة البياناتتحتفظ PostgreSQL 16 مع TimescaleDB بكل شيء: الإعدادات والموارد والمقاييس والتنبيهات مع خطوطها الزمنية والاكتشافات وسجل التدقيق
API وتطبيق الويبتخدم API تطبيق الويب وتتحقق من كل طلب بحسب دورك في الكيان المعني به. ويعمل تطبيق الويب في أي متصفح حديث ويمكن تثبيته على الهاتف أو الجهاز اللوحي. وتُبنى صفحة الحالة العامة مما اختار المسؤولون نشره فقط
الإشعاراتتُرسَل رسائل Slack بعد حفظ النتائج مباشرة، وتُرسل عملية مسح في الخلفية كل 15 ثانية ما اضطر إلى الانتظار. ولا يؤخر بطء Slack أو عدم توفره المراقبة أبدًا. وتُنشأ مشكلات Jira عند الطلب وتُتابَع حتى تكتمل

كيف يتحول القياس إلى تنبيه​

  1. ينفّذ المُجمِّع الفحص عند حلول موعده ويرسل النتيجة إلى API عبر الشبكة الداخلية للخادم. أما المصدر فيبلّغ عبر الاستطلاع أو webhook بدلًا من ذلك.
  2. تُحفظ النتيجة أولًا حتى لا يضيع شيء إذا فشلت خطوة لاحقة. وتُكتب قيمها في سجل المقاييس.
  3. يقارن محرك التنبيهات القيمة بالحدود الفعلية لذلك الفحص على ذلك المورد. وعندما يتحقق الشرط طوال مدة for كاملة، يفتح تنبيهًا أو يحدّث التنبيه المفتوح بالفعل للشرط نفسه.
  4. يُعاد حساب حالة المورد، ويعرضها تطبيق الويب عند التحديث التالي.
  5. تقرر خطوة الإشعارات ما إذا كان التغيير يستحق رسالة، وتجد القنوات عبر شجرة الكيانات، وتسجّل كل رسالة في الخط الزمني للتنبيه.

تشرح مقالة التنبيهات والإشعارات الخطوات من 3 إلى 5 بالتفصيل، وتشرح مقالة الحدود وخطوط الأساس مصدر الحدود الفعلية.

خادم واحد وست حاويات​

يعمل كل شيء على خادم واحد بنظام Rocky Linux 9 أو 10، أو نظام آخر من عائلة Red Hat Enterprise Linux، على معمارية x86_64. الحد الأدنى هو معالجان افتراضيان (vCPU) و4 GiB من الذاكرة و20 GiB من المساحة الحرة على القرص. تعمل الحاويات بلا صلاحيات الجذر (rootless) مع Podman تحت حساب خدمة، هو excubius افتراضيًا، وتبدأ مع الخادم. لا توجد شيفرة مصدرية على الخادم: الإصدار هو مجموعة من صور الحاويات مع حزمة نشر، ويثبّتها برنامج التثبيت ويرقّيها.

الحاويةدورها
proxyالحاوية الوحيدة ذات المنافذ المفتوحة، 80 و443. تنهي TLS، وتوجّه الطلبات إلى تطبيق الويب أو API، وتحدّ من معدل webhooks
frontendتخدم تطبيق الويب
backendAPI والمُطبِّع ومحرك التنبيهات والإشعارات وJira وصفحة الحالة العامة
collectorالمُجمِّع واستطلاع المصادر. لا تفتح أي منفذ، ولا تتلقى إلا رمزها وإعداداتها، ولا تتلقى كلمة مرور قاعدة البيانات أو المفتاح الذي يشفّر الأسرار المخزنة أبدًا
certsتصدر شهادة TLS وتجدّدها: Let's Encrypt أو شهادة موقّعة ذاتيًا أو شهادتك الخاصة
dbPostgreSQL 16 مع TimescaleDB

يتحدث المُجمِّع إلى API عبر الشبكة الداخلية للخادم فقط: يرفض proxy مسارات المُجمِّع القادمة من الخارج. وللاتصال الصادر، يحتاج الخادم إلى HTTPS نحو Slack وJira وواجهات API لمصادرك. وتقرأ وحدة التحديثات أيضًا موجزات عامة للإصدارات والإشعارات الاستشارية، وتعود إلى النسخ المرفقة مع الإصدار عندما يتعذر على الخادم الوصول إليها. وفي Azure، امنح الهوية المُدارة للخادم أدوارًا للقراءة فقط، مثل Reader وMonitoring Reader، ليقرأ المُجمِّع Azure دون سر مخزَّن.

تلميح

وجّه أداة مراقبة وقت التشغيل الخارجية إلى https://<your host>/heartbeat. يردّ بـ ok ما دام الخادم يعمل، فتعرف عندما يتعطل Excubius نفسه.

ما الذي يُخزَّن وأين​

البياناتالمكانالمدة
الكيانات والموارد والفحوص والحدود والمستخدمون والأدوارقاعدة البياناتحتى تغيّرها
المقاييسقاعدة البيانات، في جدول hypertable من TimescaleDB90 يومًا
التنبيهات والاكتشافات وخطوطها الزمنية ومن اطّلع عليها والتعييناتقاعدة البياناتتُحفظ كسجل تاريخي
حمولات webhook الواردة من المصادرقاعدة البيانات30 يومًا
سجل درجة الأمانقاعدة البياناتلقطة واحدة في الساعة لمدة 14 يومًا، ثم لقطة واحدة في اليوم لمدة 400 يوم
سجل التدقيققاعدة البياناتيُحفظ
بيانات الاعتماد وأسرار المصادرقاعدة البيانات، مشفّرة بمفتاح يُخزَّن في ملف إعدادات الخادم فقطحتى تستبدلها أو تزيلها
إعدادات الخادم: كلمة مرور قاعدة البيانات، وسر توقيع الجلسات، ومفتاح التشفير، ورمز المُجمِّعملف .env في مجلد التثبيت، وهو /opt/excubius افتراضيًايولّده برنامج التثبيت مرة واحدة
شهادة TLSوحدة تخزين (volume) في حاوية certsتُجدَّد تلقائيًا عندما يتبقى 30 يومًا أو أقل
النسخ الاحتياطية لقاعدة البياناتمجلد backups في مجلد التثبيت: ملف تفريغ كل يوم في 02:30 بتوقيت الخادمآخر 14 ملف تفريغ

الأسرار للكتابة فقط: بعد حفظها لا يستطيع أحد قراءتها مرة أخرى في تطبيق الويب أو عبر API. ولا يكشف ملف تفريغ قاعدة البيانات وحده أي سر، لأن المفتاح ليس في قاعدة البيانات؛ ولهذا السبب نفسه احتفظ بنسخة من ملف .env مع نسخك الاحتياطية، وإلا وجب إدخال الأسرار المخزنة في قاعدة بيانات مستعادة من جديد. انسخ النسخ الاحتياطية اليومية خارج الخادم ضمن نسخك الاحتياطية المعتادة للخادم؛ وتشرح مقالة الترقية والنسخ الاحتياطي والاستعادة كيفية استعادتها.

للقراءة فقط بحكم التصميم​

يكتشف Excubius ويشرح ويقترح؛ ولا يغيّر نظامًا مراقَبًا أبدًا.

  • تُنشأ حسابات دخول المراقبة وبيانات اعتماد API دون صلاحيات كتابة أو تثبيت. ولا يحتاج حساب دخول SQL Server إلى sysadmin أبدًا.
  • تحمل الاكتشافات الأمنية والإشعارات الاستشارية للتحديثات إجراءً مقترحًا كنص ليتبعه شخص في نافذة تغيير. لا يُنفَّذ شيء ولا يُثبَّت شيء.
  • لا يُكتب شيء في New Relic أو NinjaOne أو Azure أو Microsoft Entra ID أو Wazuh.
  • حذف مورد في Excubius يحذف فحوصه ومقاييسه وتنبيهاته في Excubius فقط. ولا يُمَسّ النظام المراقَب.

عندما يحدث عطل​

العطلما يفعله Excubius
واجهة API لأحد المصادر متوقفةيصبح المصدر متقادمًا ويعرض الخطأ. لا يُحَلّ شيء بناءً على استطلاع فاشل، ولا يُختلَق أي تنبيه
لا يستطيع المُجمِّع الوصول إلى موردبعد ثلاثة إخفاقات متتالية في الاتصال أو تسجيل الدخول أو انتهاء المهلة، تصبح حالة المورد حرج مع تنبيه Cannot reach واحد، وتنتظر تنبيهات المورد الأخرى خلفه
API أو قاعدة البيانات غير متاحة لوقت قصيريحتفظ المُجمِّع بنتائجه ويرسلها لاحقًا. والنتيجة المرسلة مرتين تُخزَّن مرة واحدة
Slack غير متاحتستمر المراقبة. تُسجَّل الرسالة الفاشلة على التنبيه وتُعاد محاولتها، بثلاث محاولات في المجموع
خادم Excubius متوقفتضيع webhooks المرسلة في أثناء ذلك. وتستردّها المصادر ذات الوضع المختلط عند المطابقة التالية