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

أوضاع الاستيعاب

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

يصل كل مصدر، مثل New Relic أو NinjaOne أو Azure Monitor، إلى Excubius بأحد ثلاثة أوضاع: Polling أو Webhook only أو Hybrid. يحدد الوضع سرعة وصول التنبيهات، وما إذا كان Excubius يحتاج إلى بيانات اعتماد للمصدر، وما إذا كان يحصل على الجرد والمقاييس إضافة إلى التنبيهات. تشرح هذه المقالة كل وضع ومتى يناسب.

الأوضاع الثلاثة​

الوضعكيف يعملنقاط القوةنقاط الضعفيناسب عندما
Pollingيسأل المُجمِّع API المصدر وفق جدول عن الجرد والمقاييس والتنبيهات، ببيانات اعتماد للقراءة فقطلا يدخل شيء من الخارج. يستدرك ما فاته بعد فترة التوقف. تحصل على الجرد والمقاييستظهر التنبيهات خلال فترة الاستطلاع. ويستهلك حصة APIلا يستطيع المصدر الوصول إلى هذا الخادم: لا عنوان عام، أو أن حركة المرور الواردة غير مسموح بها
Webhook onlyيدفع المصدر تنبيهاته إلى عنوان webhook. لا يُستطلع شيء ولا تُخزَّن بيانات اعتمادتصل التنبيهات فورًا. ولا بيانات اعتماد API إطلاقًالا جرد ولا مقاييس. وتضيع التنبيهات المرسلة أثناء توقف هذا الخادمتستطيع منح المصدر عنوان URL لكن لا تستطيع منحه بيانات اعتماد API
Hybridwebhooks للتنبيهات، إضافة إلى استطلاع الجرد والمقاييس ومطابقة دورية للتنبيهاتفوري وذاتي الإصلاح: التنبيه الذي أُغلق عند المصدر بينما ضاع webhook الخاص به تحلّه المطابقة التاليةاستخدام أكبر قليلًا لـ APIيستطيع المصدر استدعاء هذا الخادم وتستطيع منحه بيانات اعتماد للقراءة فقط. وهو الخيار الافتراضي الموصى به

تختار الوضع عند إضافة المصدر في Settings › Sources، ويمكنك تغييره في أي وقت دون إعادة تشغيل: يلتقط المُجمِّع التغيير خلال 30 ثانية، وتُفحص webhooks مقابل الوضع عند كل استدعاء.

ما يفعله كل وضع​

PollingWebhook onlyHybrid
بيانات الاعتماد المطلوبةنعملانعم
الجرد والمقاييستُستطلعلا شيءتُستطلع
التنبيهاتتُستطلع بحسب فترة التنبيهاتwebhookswebhooks، وتُطابَق بحسب فترة المطابقة
استدعاءات webhookتُرفض وتُدقَّقتُقبلتُقبل
المصدر حديث ما دامينجح الاستطلاعوصل webhook خلال آخر يومينجح الاستطلاع
Testيعمل على المُجمِّعيجيب فورًا مما ورديعمل على المُجمِّع
Sync nowنعملانعم

يبقى المصدر المُستطلَع حديثًا ما دام قد نجح خلال ثلاثة أضعاف أقصر فترات استطلاعه، على ألا تقل المدة عن 15 دقيقة. أما المصدر الذي يعمل بـ webhook فقط فلا يستطيع أن يُظهر سوى آخر مرة سمع فيها شيئًا، لذا فإن يومًا هادئًا يجعله متقادمًا.

المطابقة​

المطابقة قائمة كاملة بالتنبيهات المفتوحة لدى المصدر. والتنبيه الذي لم يعد المصدر يدرجه يُحَلّ في Excubius، مع استثناءين:

  • التنبيهات الأقدم من نافذة سرد المصدر نفسه، وهي 30 يومًا لمشكلات New Relic وتنبيهات Azure Monitor، لا تُحَلّ إلا عندما يقول المصدر ذلك.
  • التنبيهات التي حلّها شخص يدويًا في Excubius لا يُعاد فتحها ما دام المصدر يواصل الإبلاغ عن الحدوث نفسه. أما الحدوث الجديد فيفتح تنبيهًا جديدًا.

لا يُحَلّ شيء بناءً على استطلاع فاشل، ولا يُختلَق أي تنبيه عندما يتعذر الوصول إلى مصدر: بل يصبح المصدر متقادمًا ويعرض الخطأ.

كيف تُحمى webhooks​

تطبّق كل نقطة نهاية webhook القواعد نفسها، أيًا كان المصدر:

  1. HTTPS ورمز يتعذر تخمينه. يحمل العنوان رمزًا عشوائيًا بطول 256 بت، ولا يُخزَّن منه إلا تجزئة. ويُعرض العنوان الكامل مرة واحدة، عند إنشائه. ويستبدله Rotate URL، فيتوقف القديم عن العمل فورًا.
  2. سر مشترك اختياري. عندما تضبط Webhook secret، يجب أن يحمله كل استدعاء في Authorization: Bearer <secret> أو ككلمة مرور في Authorization: Basic أو في X-Webhook-Secret أو X-Custom-Webhook-Secret. ولا تستطيع مجموعات الإجراءات (action groups) في Azure Monitor إضافة ترويسات، ولذلك يكون الرمز هو بيانات الاعتماد بالنسبة إليها.
  3. الحدود. يقبل الخادم 30 استدعاء webhook في الدقيقة لكل عنوان IP، مع دفعات من 20، ويرفض الأجسام التي تتجاوز 512 KiB. ويحصل الرمز المجهول على الإجابة نفسها التي يحصل عليها مصدر غير موجود.
  4. التخزين قبل المعالجة. تُخزَّن الحمولة أولًا وتُعالَج في الخلفية. والحمولة التي تفشل تُحفظ مع خطئها وتُعاد محاولتها ثلاث مرات، فلا يضيع شيء بسبب خلل. ويُقبل إعادة إرسال الحدث نفسه، المعروف بمعرّف الحدث لدى المصدر، ثم يُسقَط.
  5. التدقيق. الاستدعاءات المرفوضة لأن المصدر في وضع الاستطلاع أو متوقف تُحتسب على المصدر وتُدقَّق. وتُكتب كل عملية تغيير للوضع أو تدوير أو اختبار أو مزامنة في سجل التدقيق مع المستخدم والوقت.

تُحفظ الأحداث المستلمة والمتجاهلة 30 يومًا؛ وتعرض Settings › Sources أحدثها لكل مصدر.

فترات الاستطلاع​

لكل مصدر فتراته الخاصة، بالثواني، تحت Polling intervals. اترك الحقل فارغًا لاستخدام قيمته الافتراضية:

المصدرالجردالمقاييسالتنبيهات (استطلاع)مطابقة التنبيهات (مختلط)
New Relic900300300900
NinjaOne900900300900
Azure Monitor900300300900

الحد الأدنى 60 ثانية، و300 للمطابقة. ولكل فحص فترته الخاصة أيضًا، فلا تشغّل مرحلة المقاييس إلا الفحوص التي حان موعدها؛ فانتهاء صلاحية Key Vault مثلًا يُقرأ كل ساعة. وتكلّف الفترات الأقل من حصة API: إن خطأ rate limited لدى المصدر يعني أنها منخفضة جدًا.

لا تعتمد فحوص المُجمِّع نفسه على وضع: فهي تعمل بفترات الكتالوج، من 30 ثانية إلى 24 ساعة.