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

أخطاء المُجمِّع

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

عندما يتعذر تشغيل فحص، يبلغ عن نوع الخطأ بدلًا من قيمة. يظهر النوع على الفحص وفي المخطط الزمني للمورد وفي نتيجة Test connection، ويحصر السبب المحتمل. تسرد هذه المقالة كل الأنواع، وتشرح تنبيه Cannot reach، وتوضح ما يجب فحصه لكل عَرَض، سواء للفحوص أو للمصادر.

أنواع الأخطاء​

النوعيظهر باسمالمعنىيُحتسب ضمن Cannot reach
unreachableUnreachableخطأ في الشبكة، أو تعذر تحليل الاسم، أو رفض الاتصال أو انقطاعه، أو فشل مصافحة TLSنعم
authSign-in refusedفشل تسجيل الدخول، أو لا يستطيع حساب تسجيل الدخول فتح قاعدة البيانات التي يحتاج إليهانعم
timeoutTimed outاستغرق الاتصال، أو الفحص بأكمله، وقتًا أطول من المسموح بهنعم
queryQuery failedردّ النظام، لكن العبارة فشلت، وعادةً بسبب إذن مفقودلا
query_timeoutQuery timed outتم الاتصال، لكن العبارة تجاوزت مهلتهالا
configConfigurationأمر يجب إصلاحه في Excubius: لا مضيف، أو لا بيانات اعتماد أو نوع خاطئ منها، أو سر لا يمكن قراءتهلا
unsupportedNot supportedلا يملك المُجمِّع وسيلة نقل (transport) لهذا الفحصلا
internalCollector 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، أو رأس السر خاطئافحص الوضع والرأس الذي ترسله المنصة