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

كيف يعمل المُجمِّع

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

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

كيف يعمل الفحص​

  1. كل 30 ثانية يسأل المُجمِّع API عمّا يجب تشغيله: تعريفات الفحوص من الكتالوج، والموارد التي تستهدفها، وبيانات الاعتماد التي تستخدمها. وعندما لا يتغير شيء، يكون الرد فارغًا وبالكاد يكلّف شيئًا.
  2. يشغّل كل فحص وفق فاصله عبر وسيلة النقل التي يحددها الكتالوج، مثل T-SQL لمثيل SQL Server أو HTTP لنقطة نهاية ويب.
  3. يرسل النتائج الخام إلى API على دفعات. تقارنها API بالحدود الفعلية، وتفتح التنبيهات وتحلها، وتُشعر القنوات المناسبة.
  4. كل 10 ثوانٍ يلتقط المهام التي تُنفَّذ لمرة واحدة، مثل Test connection وDiscover وTest وSync now الخاصة بمصدر. وكل 60 ثانية يرسل إشارة نبض، تعرضها منطقة Sources في لوحة المعلومات Overview.

يعمل المُجمِّع داخل خادم Excubius، بجوار API. ولا يتلقى إلا الرمز المميز الخاص به وإعداداته؛ ولا يرى أبدًا كلمة مرور قاعدة البيانات ولا المفتاح الذي يشفّر الأسرار المخزنة. وتصل إليه بيانات الاعتماد عبر الشبكة الداخلية، وتبقى في الذاكرة، ولا تُسجَّل في السجلات أبدًا.

وسائل النقل​

وسيلة النقل هي الطريقة التي يتحدث بها المُجمِّع مع نوع واحد من الأنظمة. وكل واحدة منها تقرأ فقط.

وسيلة النقلتصل إلىالمنفذنوع بيانات الاعتمادالحالة
T-SQL (Microsoft ODBC Driver 18)مثيلات SQL Server ومجموعات التوفر والخوادم المرتبطة وسجل التنفيذ في Reporting Services1433 أو منفذ المثيل؛ وUDP 1434 للمثيلات المسماة التي ليس لها منفذ ثابتSQL loginمدعومة
HTTP(S)نقاط نهاية الويب وبوابات Reporting Services وشهادات TLS وانتهاء صلاحية النطاق (RDAP)443، 80لا شيء، أو Windows account (NTLM)، أو HTTP user and password، أو Bearer tokenمدعومة
DNSتحليل أسماء نقاط النهاية ووحدات استماع مجموعات التوفر، باستخدام محلّل الخادم53لا شيءمدعومة
Azure Resource Graphفحوص الوضع في السحابة، وتقييمات Defender for Cloud، وAzure Update Manager، وService Health443الهوية المُدارة للخادم، أو Azure service principalمدعومة
Microsoft Graphفحوص الهوية في Entra ID443الهوية المُدارة للخادم، أو Azure service principalمدعومة
WazuhWazuh indexer، وواجهة API الخاصة بـ manager اختياريًاعناوين URL التي تضبطهاHTTP user and passwordمدعومة عند تشغيل Wazuh
WinRMفحوص مضيفات Windows وفحوص Active Directory5986 (HTTPS)Windows accountتجريبية
SSHفحوص مضيفات Linux22، أو ssh_port الخاص بالمضيفSSH key، SSH passwordتجريبية
PostgreSQLفحوص وحدة PostgreSQL5432SQL loginغير متاحة بعد: تُضاف الفحوص لكنها تبقى غير معروف
تحذير

وسيلتا النقل WinRM وSSH موجودتان وتُضاف فحوصهما إلى مضيفات Windows وLinux، لكنهما لم يُتحقق منهما بعد على مضيفات حقيقية. لهذه المضيفات، استخدم NinjaOne أو New Relic أو Azure Monitor كمصدر إلى أن يصنّفهما أحد الإصدارات على أنهما مدعومتان.

يقرأ المُجمِّع المصادر أيضًا، عبر HTTPS (المنفذ 443)، ولكل منها محوّله الخاص: New Relic عبر NerdGraph، وNinjaOne عبر واجهة API العامة الخاصة به، وAzure Monitor عبر Azure Resource Manager وResource Graph وAzure Monitor وData Factory وKey Vault وMicrosoft Graph. راجع المصادر.

يتيح المُجمِّع افتراضيًا كل وسيلة نقل تتوفر مكتباتها في صورته. ويضيّق EXCUBIUS_COLLECTOR_TRANSPORTS هذه القائمة؛ راجع متغيرات البيئة.

ما تحتاج إليه كل وحدة​

الوحدةيُجمع عبرما تقدمه
SQL Server، مجموعات التوفر، أمان SQL ServerT-SQLحساب دخول SQL للقراءة فقط على كل مثيل وكل نسخة متماثلة
WindowsWinRM (تجريبي)، أو New Relic وNinjaOneحساب Windows في ثلاث مجموعات قراءة محلية، أو مصدر
LinuxSSH (تجريبي)، أو New Relic وNinjaOneمستخدم غير root بمفتاح، أو مصدر
PostgreSQLغير متاح بعد أصلًا؛ وخوادم Azure المرنة عبر Azure Monitorدور يحمل pg_monitor، جاهزًا لحين توفر الجمع
Azure، Azure Data Factoryمصدر Azure MonitorReader وMonitoring Reader، إضافةً إلى دور Data Factory للقراءة فقط
الاختبارات الاصطناعيةHTTP وDNS وT-SQLبيانات اعتماد لنقاط النهاية المحمية وخوادم التقارير فقط
انتهاء الصلاحيةAzure Monitor وHTTP (RDAP) وT-SQL وWinRMأذونات قراءة Key Vault وMicrosoft Graph
التحديثاتخلاصات الموردين التي تقرؤها API، إضافةً إلى فحوص الجرداتصال HTTPS صادر من الخادم إلى الخلاصات
أمان الهويةMicrosoft Graph وWinRMأذونات تطبيق Graph للقراءة فقط
أمان السحابةResource Graph وDefender for Cloud وWazuhReader وSecurity Reader؛ ومستخدم Wazuh للقراءة فقط
New Relic، NinjaOneمصدرها الخاصمفتاح أو عميل API للقراءة فقط

كل الأذونات في مكان واحد: الأذونات.

مسارات الشبكة​

يبدأ كل اتصال من خادم Excubius. ولا شيء يتصل بالمُجمِّع.

إلىالمنفذالغرض
كل مثيل SQL Server وكل نسخة متماثلة واسم وحدة استماع وعنوان IP لوحدة استماعمنفذ SQL، وهو 1433 افتراضيًاوحدات SQL Server ومجموعات التوفر واختبارات SQL الاصطناعية ذهابًا وإيابًا
المثيلات المسماة التي ليس لها منفذ ثابتUDP 1434SQL Server Browser
نقاط نهاية الويب وبوابات Reporting Services443، 80الاختبارات الاصطناعية وشهادات TLS
محلّل DNS الخاص بالخادم53فحوص تحليل الأسماء
data.iana.org وخوادم RDAP الخاصة بالسجلات443انتهاء صلاحية النطاق
مضيفات Windows5986WinRM (تجريبي)
مضيفات Linux22SSH (تجريبي)
management.azure.com وgraph.microsoft.com وخزائن المفاتيح لديك (*.vault.azure.net)، وlogin.microsoftonline.com عند استخدام service principal443مصدر Azure Monitor وفحوص الوضع الأمني والهوية في Azure
api.newrelic.com أو api.eu.newrelic.com443مصدر New Relic
app.ninjarmm.com، أو eu. أو oc. أو ca.ninjarmm.com443مصدر NinjaOne
Wazuh indexer وmanagerمنفذاهماWazuh

تجلب API، وليس المُجمِّع، خلاصات التحديثات وتتحدث إلى Slack وJira؛ راجع متغيرات البيئة. وتصل webhooks من المصادر إلى العنوان العام للخادم على المنفذ 443 وتذهب إلى API، وليس إلى المُجمِّع أبدًا.

القيود والمهلات​

القيدالقيمة
الفحوص التي تعمل في وقت واحد32 في المجموع؛ لكل وسيلة نقل: T-SQL 8، وHTTP وDNS 16، وSSH 8، وWinRM 4، وResource Graph 4، وDefender وMicrosoft Graph وWazuh 2
مهلة تسجيل الدخول إلى SQL Server · مهلة الاستعلام10 ث · 30 ث (معلمات الكتالوج timeout_seconds وquery_timeout_seconds)
الصفوف المقروءة لكل استعلام1,000
أطول مدة يجوز أن يعمل فيها فحص واحد120 ث
النتائج المحفوظة أثناء تعذر الوصول إلى API10,000؛ وتُحذف الأقدم أولًا

تحمل جلسات SQL Server اسم التطبيق monitoring-collector، حتى يتمكن مسؤولو قواعد البيانات من التعرف عليها في sys.dm_exec_sessions.

ما لا يفعله المُجمِّع أبدًا​

المُجمِّع للقراءة فقط بحكم التهيئة وبحكم الشفرة. فهو لا يثبّت ولا يحدّث ولا يعيد تشغيل ولا يوقف أي شيء، ولا يكتب بيانات أو سجل النظام (registry) أو إعدادات، ولا ينهي أي جلسة، ولا ينفّذ أي معالجة تصحيحية. والفحص الذي يتطلب كتابة يُرفض عند مراجعته للإدراج في الكتالوج.

ما يرسله فعلًا:

  • SQL Server: استعلامات SELECT على طرق عرض الإدارة الديناميكية وطرق عرض الكتالوج وجداول النسخ الاحتياطي والمهام في msdb وExecutionLog3 الخاص بخادم التقارير؛ وsys.sp_readerrorlog إلى متغير جدولي؛ وsp_testlinkedserver للخوادم المرتبطة.
  • HTTP: GET وHEAD فقط.
  • Azure وWazuh: عمليات قراءة، إضافةً إلى القليل من طلبات POST التي هي استعلامات، مثل استعلام Resource Graph أو استعلام تشغيلات Data Factory أو _search في Wazuh. وأي شيء آخر يُرفض في الشفرة.
  • WinRM وSSH: أوامر PowerShell وshell المكتوبة في الكتالوج، وهي تقرأ فقط.

الاستعلام الدقيق لكل فحص موجود في الكتالوج وفي API على GET /api/v1/catalog/checks/{id}.

وكلاء المصادر الاختيارية​

لا يثبّت Excubius أي شيء على الأنظمة التي يراقبها. أما وكلاء المصادر الاختيارية، مثل Wazuh، فتنشرهم أدواتك الخاصة، مثل NinjaOne أو أداة إدارة الإعدادات لديك.

الخطوات التالية​