أخطاء المُجمِّع
عندما يتعذر تشغيل فحص، يبلغ عن نوع الخطأ بدلًا من قيمة. يظهر النوع على الفحص وفي المخطط الزمني للمورد وفي نتيجة Test connection، ويحصر السبب المحتمل. تسرد هذه المقالة كل الأنواع، وتشرح تنبيه Cannot reach، وتوضح ما يجب فحصه لكل عَرَض، سواء للفحوص أو للمصادر.
أنواع الأخطاء
| النوع | يظهر باسم | المعنى | يُحتسب ضمن Cannot reach |
|---|---|---|---|
unreachable | Unreachable | خطأ في الشبكة، أو تعذر تحليل الاسم، أو رفض الاتصال أو انقطاعه، أو فشل مصافحة TLS | نعم |
auth | Sign-in refused | فشل تسجيل الدخول، أو لا يستطيع حساب تسجيل الدخول فتح قاعدة البيانات التي يحتاج إليها | نعم |
timeout | Timed out | استغرق الاتصال، أو الفحص بأكمله، وقتًا أطول من المسموح به | نعم |
query | Query failed | ردّ النظام، لكن العبارة فشلت، وعادةً بسبب إذن مفقود | لا |
query_timeout | Query timed out | تم الاتصال، لكن العبارة تجاوزت مهلتها | لا |
config | Configuration | أمر يجب إصلاحه في Excubius: لا مضيف، أو لا بيانات اعتماد أو نوع خاطئ منها، أو سر لا يمكن قراءته | لا |
unsupported | Not supported | لا يملك المُجمِّع وسيلة نقل (transport) لهذا الفحص | لا |
internal | Collector error | خطأ برمجي في المُجمِّع؛ وتذكر الرسالة موضعه | لا |
يعرض مورد تنبيه «Cannot reach» واحدًا
الأعراض. يظهر على مورد تنبيه واحد حرج هو Cannot reach، وتذكره تنبيهاته الأخرى بوصفه سببها الجذري.
السبب. افتراضيًا، فشلت 3 تشغيلات متتالية لفحص من فحوص ذلك المورد بالنوع unreachable أو auth أو timeout. وبدلًا من فتح تنبيه لكل فحص فاشل، يفتح Excubius تنبيهًا واحدًا ويؤجل إشعارات التنبيهات الأخرى للمورد ما دام مفتوحًا. يحدد عدد حالات الفشل المتغير EXCUBIUS_UNREACHABLE_AFTER.
الحل. أصلح الاتصال، ثم اختر Test connection على المورد للتأكد. يتم حل التنبيه تلقائيًا بمجرد نجاح الفحوص الفاشلة مجددًا؛ وإلى ذلك الحين تبقى إشعارات التنبيهات الأخرى للمورد في الانتظار.
تفشل الفحوص بالنوع auth
السبب. كلمة المرور خاطئة أو منتهية الصلاحية، أو حساب تسجيل الدخول معطل، أو المثيل لا يقبل حسابات تسجيل دخول SQL، أو لا يملك حساب تسجيل الدخول مستخدمًا في قاعدة بيانات يفتحها أحد الفحوص. وفي مجموعة التوفر، قد يكون لحساب تسجيل الدخول SID مختلف على النسخة الأساسية الجديدة بعد تجاوز الفشل.
الحل. تحقق من بيانات الاعتماد ومن أن المثيل يعمل في الوضع المختلط (mixed mode). وفي مجموعات التوفر، أنشئ حساب تسجيل الدخول بالـ SID نفسه على كل نسخة متماثلة؛ راجع المتطلبات الأساسية لمجموعات التوفر.
تفشل الفحوص بالنوعين unreachable أو timeout
السبب. تعذر تحليل اسم المضيف انطلاقًا من خادم Excubius، أو يحجب جدار حماية المنفذ، أو الخدمة متوقفة، أو مسار الشبكة بطيء.
الحل. افحص DNS وجدار الحماية بين خادم Excubius والنظام، على المنفذ الصحيح: منفذ SQL (والمنفذ UDP 1434 للمثيلات المسماة التي ليس لها منفذ ثابت)، و443 أو 80 لنقاط نهاية الويب، و5986 لـ WinRM، و22 لـ SSH. وفي وحدات الاستماع متعددة الشبكات الفرعية، اسمح بكل عنوان IP لوحدة الاستماع. راجع مسارات الشبكة.
تفشل الفحوص بالنوع query
السبب. ردّ النظام، لكن العبارة رُفضت، وذلك في الغالب لأن حساب تسجيل الدخول يفتقر إلى إذن. ويفشل بهذه الطريقة الفحص الذي يحتاج إلى msdb أو CONNECT ANY DATABASE بينما تعمل الفحوص الأخرى.
الحل. اختر Test connection: يسرد في SQL Server أذونات حساب تسجيل الدخول وما ينقصه. امنح ما تسرده صفحة الأذونات، ولا تمنح أكثر من ذلك.
تفشل الفحوص بالنوع query_timeout
السبب. استغرق تنفيذ العبارة وقتًا أطول من مهلتها، وهي 30 ثانية افتراضيًا في SQL Server، وعادةً يحدث ذلك على مثيل تحت حمل كبير.
الحل. أعد المحاولة لاحقًا. وإن استمرت المشكلة على مثيل مشغول، فارفع المعامل query_timeout_seconds الخاص بالفحص لذلك المورد.
تفشل الفحوص بالنوع config
السبب. هناك ما هو ناقص في Excubius: ليس للمورد مضيف، أو لا تصل إليه أي بيانات اعتماد، أو نوع بيانات الاعتماد لا يستطيع الفحص استخدامه، أو يتعذر فك تشفير السر المخزن لأن EXCUBIUS_DATA_KEY تغيّر.
الحل. عدّل المورد أو بيانات الاعتماد. يحتاج الفحص الذي يقع تحت خادم تقارير مرتبط ببيانات اعتماد حساب Windows إلى حساب تسجيل دخول SQL لفحوص T-SQL الخاصة به؛ راجع بيانات الاعتماد التي يستخدمها المورد. وإذا تعذرت قراءة الأسرار، فأدخلها مرة أخرى.
تفشل الفحوص بالنوع unsupported، أو تبقى بحالة غير معروف
السبب. لا يوفر أي مُجمِّع وسيلة النقل التي يحتاج إليها الفحص. قد يكون EXCUBIUS_COLLECTOR_TRANSPORTS قد استبعدها، أو أن وسيلة النقل غير موجودة بعد: تبقى فحوص PostgreSQL بحالة غير معروف في هذا الإصدار.
الحل. أزل وسيلة النقل من القيد، أو عطّل الفحص على ذلك المورد. راجع التوافق.
تنتهي مهمة بالرسالة «No collector picked it up»
الأعراض. يبقى Test connection أو Discover أو Test الخاص بمصدر عند waiting for the collector، ثم ينتهي بالرسالة No collector picked it up.
السبب. لم يستلم أي مُجمِّع المهمة خلال 10 دقائق. المُجمِّع غير قيد التشغيل، أو ليس لديه رمز (EXCUBIUS_COLLECTOR_TOKEN فارغ، وعندها يبقى خاملًا)، أو لا يوفر وسيلة النقل. أما المهمة التي استلمها مُجمِّع ولم يبلغ عن نتيجتها خلال 15 دقيقة فتفشل بالنوع timeout.
الحل. افحص آخر إشارة نبض للمُجمِّع في منطقة Sources من Overview. على الخادم، بحساب الخدمة، شغّل <dir>/current/scripts/compose.sh ps و<dir>/current/scripts/compose.sh logs collector.
أخطاء المصادر
يعرض المصدر آخر خطأ له بأحد هذه الأنواع:
| يظهر باسم | غالبًا | ما يجب فحصه |
|---|---|---|
| Credentials refused | مفتاح أو سر خاطئ أو منتهي الصلاحية، أو منطقة خاطئة | استبدل السر، وافحص المنطقة أو مركز البيانات |
| Missing permission | دور أو نطاق (scope) مفقود | يذكر Test القراءة التي فشلت؛ امنح ما تسرده صفحة الأذونات |
| Not found | معرّف حساب أو مؤسسة أو اشتراك خاطئ | افحص المعرّفات في المصدر |
| Rate limited | تُقيّد المنصة الطلبات | ارفع الفواصل الزمنية للاستطلاع |
| Unreachable، Timed out | لا يستطيع الخادم الوصول إلى واجهة API الخاصة بالمنصة | اسمح بحركة HTTPS الصادرة إلى المنصة |
| Platform error | ردّت واجهة API الخاصة بالمنصة بخطأ | أعد المحاولة لاحقًا؛ وافحص حالة المنصة |
| Secrets unreadable | تغيّر EXCUBIUS_DATA_KEY منذ حفظ الأسرار | أدخلها مرة أخرى |
| No collector picked it up | المُجمِّع غير قيد التشغيل | راجع القسم السابق |
| حداثة البيانات Stale | لا استطلاع ناجح خلال ثلاثة فواصل زمنية، وبما لا يقل عن 15 دقيقة؛ ولمصدر يعتمد على webhook فقط، لم يصل شيء منذ يوم | هل المُجمِّع قيد التشغيل؟ هل ترسل المنصة webhooks؟ |
| الـ webhooks Rejected | المصدر معطل أو في وضع Polling، أو رأس السر خاطئ | افحص الوضع والرأس الذي ترسله المنصة |