أوضاع الاستيعاب
يصل كل مصدر، مثل New Relic أو NinjaOne أو Azure Monitor، إلى Excubius بأحد ثلاثة أوضاع: Polling أو Webhook only أو Hybrid. يحدد الوضع سرعة وصول التنبيهات، وما إذا كان Excubius يحتاج إلى بيانات اعتماد للمصدر، وما إذا كان يحصل على الجرد والمقاييس إضافة إلى التنبيهات. تشرح هذه المقالة كل وضع ومتى يناسب.
الأوضاع الثلاثة
| الوضع | كيف يعمل | نقاط القوة | نقاط الضعف | يناسب عندما |
|---|---|---|---|---|
| Polling | يسأل المُجمِّع API المصدر وفق جدول عن الجرد والمقاييس والتنبيهات، ببيانات اعتماد للقراءة فقط | لا يدخل شيء من الخارج. يستدرك ما فاته بعد فترة التوقف. تحصل على الجرد والمقاييس | تظهر التنبيهات خلال فترة الاستطلاع. ويستهلك حصة API | لا يستطيع المصدر الوصول إلى هذا الخادم: لا عنوان عام، أو أن حركة المرور الواردة غير مسموح بها |
| Webhook only | يدفع المصدر تنبيهاته إلى عنوان webhook. لا يُستطلع شيء ولا تُخزَّن بيانات اعتماد | تصل التنبيهات فورًا. ولا بيانات اعتماد API إطلاقًا | لا جرد ولا مقاييس. وتضيع التنبيهات المرسلة أثناء توقف هذا الخادم | تستطيع منح المصدر عنوان URL لكن لا تستطيع منحه بيانات اعتماد API |
| Hybrid | webhooks للتنبيهات، إضافة إلى استطلاع الجرد والمقاييس ومطابقة دورية للتنبيهات | فوري وذاتي الإصلاح: التنبيه الذي أُغلق عند المصدر بينما ضاع webhook الخاص به تحلّه المطابقة التالية | استخدام أكبر قليلًا لـ API | يستطيع المصدر استدعاء هذا الخادم وتستطيع منحه بيانات اعتماد للقراءة فقط. وهو الخيار الافتراضي الموصى به |
تختار الوضع عند إضافة المصدر في Settings › Sources، ويمكنك تغييره في أي وقت دون إعادة تشغيل: يلتقط المُجمِّع التغيير خلال 30 ثانية، وتُفحص webhooks مقابل الوضع عند كل استدعاء.
ما يفعله كل وضع
| Polling | Webhook only | Hybrid | |
|---|---|---|---|
| بيانات الاعتماد المطلوبة | نعم | لا | نعم |
| الجرد والمقاييس | تُستطلع | لا شيء | تُستطلع |
| التنبيهات | تُستطلع بحسب فترة التنبيهات | webhooks | webhooks، وتُطابَق بحسب فترة المطابقة |
| استدعاءات webhook | تُرفض وتُدقَّق | تُقبل | تُقبل |
| المصدر حديث ما دام | ينجح الاستطلاع | وصل webhook خلال آخر يوم | ينجح الاستطلاع |
| Test | يعمل على المُجمِّع | يجيب فورًا مما ورد | يعمل على المُجمِّع |
| Sync now | نعم | لا | نعم |
يبقى المصدر المُستطلَع حديثًا ما دام قد نجح خلال ثلاثة أضعاف أقصر فترات استطلاعه، على ألا تقل المدة عن 15 دقيقة. أما المصدر الذي يعمل بـ webhook فقط فلا يستطيع أن يُظهر سوى آخر مرة سمع فيها شيئًا، لذا فإن يومًا هادئًا يجعله متقادمًا.
المطابقة
المطابقة قائمة كاملة بالتنبيهات المفتوحة لدى المصدر. والتنبيه الذي لم يعد المصدر يدرجه يُحَلّ في Excubius، مع استثناءين:
- التنبيهات الأقدم من نافذة سرد المصدر نفسه، وهي 30 يومًا لمشكلات New Relic وتنبيهات Azure Monitor، لا تُحَلّ إلا عندما يقول المصدر ذلك.
- التنبيهات التي حلّها شخص يدويًا في Excubius لا يُعاد فتحها ما دام المصدر يواصل الإبلاغ عن الحدوث نفسه. أما الحدوث الجديد فيفتح تنبيهًا جديدًا.
لا يُحَلّ شيء بناءً على استطلاع فاشل، ولا يُختلَق أي تنبيه عندما يتعذر الوصول إلى مصدر: بل يصبح المصدر متقادمًا ويعرض الخطأ.
كيف تُحمى webhooks
تطبّق كل نقطة نهاية webhook القواعد نفسها، أيًا كان المصدر:
- HTTPS ورمز يتعذر تخمينه. يحمل العنوان رمزًا عشوائيًا بطول 256 بت، ولا يُخزَّن منه إلا تجزئة. ويُعرض العنوان الكامل مرة واحدة، عند إنشائه. ويستبدله Rotate URL، فيتوقف القديم عن العمل فورًا.
- سر مشترك اختياري. عندما تضبط Webhook secret، يجب أن يحمله كل استدعاء في
Authorization: Bearer <secret>أو ككلمة مرور فيAuthorization: Basicأو فيX-Webhook-SecretأوX-Custom-Webhook-Secret. ولا تستطيع مجموعات الإجراءات (action groups) في Azure Monitor إضافة ترويسات، ولذلك يكون الرمز هو بيانات الاعتماد بالنسبة إليها. - الحدود. يقبل الخادم 30 استدعاء webhook في الدقيقة لكل عنوان IP، مع دفعات من 20، ويرفض الأجسام التي تتجاوز 512 KiB. ويحصل الرمز المجهول على الإجابة نفسها التي يحصل عليها مصدر غير موجود.
- التخزين قبل المعالجة. تُخزَّن الحمولة أولًا وتُعالَج في الخلفية. والحمولة التي تفشل تُحفظ مع خطئها وتُعاد محاولتها ثلاث مرات، فلا يضيع شيء بسبب خلل. ويُقبل إعادة إرسال الحدث نفسه، المعروف بمعرّف الحدث لدى المصدر، ثم يُسقَط.
- التدقيق. الاستدعاءات المرفوضة لأن المصدر في وضع الاستطلاع أو متوقف تُحتسب على المصدر وتُدقَّق. وتُكتب كل عملية تغيير للوضع أو تدوير أو اختبار أو مزامنة في سجل التدقيق مع المستخدم والوقت.
تُحفظ الأحداث المستلمة والمتجاهلة 30 يومًا؛ وتعرض Settings › Sources أحدثها لكل مصدر.
فترات الاستطلاع
لكل مصدر فتراته الخاصة، بالثواني، تحت Polling intervals. اترك الحقل فارغًا لاستخدام قيمته الافتراضية:
| المصدر | الجرد | المقاييس | التنبيهات (استطلاع) | مطابقة التنبيهات (مختلط) |
|---|---|---|---|---|
| New Relic | 900 | 300 | 300 | 900 |
| NinjaOne | 900 | 900 | 300 | 900 |
| Azure Monitor | 900 | 300 | 300 | 900 |
الحد الأدنى 60 ثانية، و300 للمطابقة. ولكل فحص فترته الخاصة أيضًا، فلا تشغّل مرحلة المقاييس إلا الفحوص التي حان موعدها؛ فانتهاء صلاحية Key Vault مثلًا يُقرأ كل ساعة. وتكلّف الفترات الأقل من حصة API: إن خطأ rate limited لدى المصدر يعني أنها منخفضة جدًا.
لا تعتمد فحوص المُجمِّع نفسه على وضع: فهي تعمل بفترات الكتالوج، من 30 ثانية إلى 24 ساعة.