البنية
يعمل 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 عند الطلب وتُتابَع حتى تكتمل |
كيف يتحول القياس إلى تنبيه
- ينفّذ المُجمِّع الفحص عند حلول موعده ويرسل النتيجة إلى API عبر الشبكة الداخلية للخادم. أما المصدر فيبلّغ عبر الاستطلاع أو webhook بدلًا من ذلك.
- تُحفظ النتيجة أولًا حتى لا يضيع شيء إذا فشلت خطوة لاحقة. وتُكتب قيمها في سجل المقاييس.
- يقارن محرك التنبيهات القيمة بالحدود الفعلية لذلك الفحص على ذلك المورد. وعندما يتحقق الشرط طوال مدة
forكاملة، يفتح تنبيهًا أو يحدّث التنبيه المفتوح بالفعل للشرط نفسه. - يُعاد حساب حالة المورد، ويعرضها تطبيق الويب عند التحديث التالي.
- تقرر خطوة الإشعارات ما إذا كان التغيير يستحق رسالة، وتجد القنوات عبر شجرة الكيانات، وتسجّل كل رسالة في الخط الزمني للتنبيه.
تشرح مقالة التنبيهات والإشعارات الخطوات من 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 | تخدم تطبيق الويب |
backend | API والمُطبِّع ومحرك التنبيهات والإشعارات وJira وصفحة الحالة العامة |
collector | المُجمِّع واستطلاع المصادر. لا تفتح أي منفذ، ولا تتلقى إلا رمزها وإعداداتها، ولا تتلقى كلمة مرور قاعدة البيانات أو المفتاح الذي يشفّر الأسرار المخزنة أبدًا |
certs | تصدر شهادة TLS وتجدّدها: Let's Encrypt أو شهادة موقّعة ذاتيًا أو شهادتك الخاصة |
db | PostgreSQL 16 مع TimescaleDB |
يتحدث المُجمِّع إلى API عبر الشبكة الداخلية للخادم فقط: يرفض proxy مسارات المُجمِّع القادمة من الخارج. وللاتصال الصادر، يحتاج الخادم إلى HTTPS نحو Slack وJira وواجهات API لمصادرك. وتقرأ وحدة التحديثات أيضًا موجزات عامة للإصدارات والإشعارات الاستشارية، وتعود إلى النسخ المرفقة مع الإصدار عندما يتعذر على الخادم الوصول إليها. وفي Azure، امنح الهوية المُدارة للخادم أدوارًا للقراءة فقط، مثل Reader وMonitoring Reader، ليقرأ المُجمِّع Azure دون سر مخزَّن.
وجّه أداة مراقبة وقت التشغيل الخارجية إلى https://<your host>/heartbeat. يردّ بـ ok ما دام الخادم يعمل، فتعرف عندما يتعطل Excubius نفسه.
ما الذي يُخزَّن وأين
| البيانات | المكان | المدة |
|---|---|---|
| الكيانات والموارد والفحوص والحدود والمستخدمون والأدوار | قاعدة البيانات | حتى تغيّرها |
| المقاييس | قاعدة البيانات، في جدول hypertable من TimescaleDB | 90 يومًا |
| التنبيهات والاكتشافات وخطوطها الزمنية ومن اطّلع عليها والتعيينات | قاعدة البيانات | تُحفظ كسجل تاريخي |
| حمولات 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 المرسلة في أثناء ذلك. وتستردّها المصادر ذات الوضع المختلط عند المطابقة التالية |