> ## Documentation Index
> Fetch the complete documentation index at: https://help.teable.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# صندوق المهام المحسوبة
> راقب تسليم BullMQ وتراكم المهام المحسوبة في لوحة الإدارة.
متاح لخطة Business ذاتية الاستضافة والخطط الأعلى
المسار: لوحة الإدارة ← صندوق المهام المحسوبة
استخدم **صندوق المهام المحسوبة** عندما تتوقف قيم الصيغ أو البحث أو غيرها من الحقول المحسوبة عن التحديث أو تستغرق وقتًا أطول بكثير من المتوقع. تعرض الصفحة السلامة العامة للمهام، والمهام التي تتحرك عبر قائمة الانتظار، والمهام التي قد تحتاج إلى استرداد، وأي مساحة أُوقفت مهامها المحسوبة مؤقتًا.
## قراءة حالة السلامة
توضح الحالة المجاورة لعنوان الصفحة ما إذا كانت المهام المحسوبة تحتاج إلى الانتباه:
| الحالة | المعنى |
| ----------- | ------------------------------------------------------------ |
| **سليمة** | تعمل المهام المحسوبة بصورة طبيعية. |
| **متدهورة** | عثر Teable على إخفاقات أو مهام انتهت مهلتها أو تراكم متزايد. |
| **حرجة** | BullMQ غير متاح أو لا يوجد عامل متاح لمعالجة المهام. |
عندما تتطلب الحالة الانتباه، تسرد الصفحة السبب.
## العثور على مهمة في قائمة الانتظار
تعرض **قائمة BullMQ المباشرة** الوظائف التي لا يزال Teable يحتفظ بها، حتى تتمكن من متابعة مهمة محسوبة أو البحث عن المهام البطيئة.
يمثل كل صف مهمة واحدة افتراضيًا، ويتنقل بين الحالات في موضعه أثناء إعادة Teable المحاولة. انتقل إلى **عمليات التسليم** عندما تحتاج إلى السجل الكامل لمحاولات مهمة أو تريد البحث عن عمليات التشغيل البطيئة.
لتضييق القائمة:
* انقر على مربعات الحالات أعلى الجدول للتصفية حسب الحالة: **بانتظار التنفيذ** و**نشطة** و**مؤجلة** و**فاشلة** و**مكتملة (محتفظ بها)** وما إلى ذلك. يمكنك تحديد عدة حالات معًا، ويشرح تمرير المؤشر فوق مربع معنى تلك الحالة.
* صفِّ حسب **المساحة** أو **قاعدة البيانات** أو **السبب** أو **النتيجة**، أو ابحث عن مهمة أو قاعدة بيانات أو مساحة أو خطأ، أو عيّن حدًا أدنى لوقت المعالجة لإظهار المهام البطيئة.
* انقر على صف لفتح **مسار الحوسبة**: الطوابع الزمنية لقائمة الانتظار، وتأخر التسليم، ووقت المعالجة، وسبب الفشل الكامل مع SQL المنقح لعملية تسليم فاشلة، وتفاصيل الانتشار الموضحة أدناه.
لا تعني حالة **مكتملة** أن المهمة نفذت عملًا. توضح شارة النتيجة ما فعلته عملية التسليم فعليًا: **تمت المعالجة** تعني تشغيل المهمة، و**بلا إجراء** تعني عدم العثور على شيء متبقٍ، و**مؤجلة** تعني إعادة جدولتها لوقت لاحق، و**مركونة** تعني أن نطاقها متوقف مؤقتًا. يضيّق عامل تصفية **النتيجة** القائمة حسب تلك النتيجة ويعرض عدد عمليات التسليم التي تغطيها كل نتيجة؛ لذا فإن الجمع بين **مكتملة (محتفظ بها)** و**تمت المعالجة** لا يترك إلا عمليات التسليم التي شغّلت المهمة بالفعل.
يمثل الصف الفاشل سجل محاولة تسليم واحدة، لا مهمة عالقة. تواصل المهمة الدائمة إعادة المحاولة تلقائيًا، لذا اقرأ عمود **حالة دفتر السجل** لتحديد ما إذا كان يلزم التدخل: تعني **تمت التسوية** نجاح محاولة لاحقة بالفعل، بينما تربط **رسالة ميتة** بمعالجة الحالات الشاذة. تُخفى الإخفاقات التي تمت تسويتها افتراضيًا؛ ويعرض شريط عددها ويتيح لك إظهارها.
لا يؤدي **مسح سجل الإخفاقات** إلا إلى إزالة سجلات الوظائف الفاشلة المحتفظ بها من قائمة الانتظار. وهو لا يصلح شيئًا، وتظل الرسائل الميتة في **معالجة الحالات الشاذة**.
قد يحسب مربع الحالة أيضًا إدخالات لم تعد بيانات وظائفها موجودة في Redis، وغالبًا ما تكون متبقية بعد الإخلاء أو فقدان البيانات. لا تستطيع القائمة عرضها، لذلك توضح الصفحة الفجوة أسفل الجدول. يزيل Teable هذه البقايا من حالة الفشل تلقائيًا، بينما يزيلها **مسح سجل الإخفاقات** فورًا.
## تتبع كيفية انتشار القيمة
عندما تبدو قيمة محسوبة غير صحيحة أو تصل متأخرة، افتح **مسار الحوسبة** لرؤية السلسلة الكاملة وراءها. انقر على أي صف في قائمة الانتظار، أو انقر على **المسار** بجوار معرّف مهمة في تفاصيل الحالة الشاذة.
| القسم | السؤال الذي يجيب عنه |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| الملخص | زمن الاستجابة من البداية إلى النهاية، ووقت تغير المصدر، ووقت استقرار القيمة، والجدول والحقول التي شغّلت التنفيذ. تعني شارة **قيد الحوسبة** أن السلسلة لا تزال قيد التشغيل. |
| **المخطط الزمني** | وقت إدراج التشغيل في قائمة الانتظار وبدئه واكتماله أو فشله. |
| **سلسلة المهام** | كل مهمة في التسلسل، متداخلة تحت المهمة التي أدرجتها في قائمة الانتظار، حتى تتمكن من معرفة مصدر كل فرع. يعرض كل صف حالته وخطوات الخطة و**هدف الكتابة** (الجدول والحقول التي تحدّثها المهمة) و**الصفوف المتسخة** وعمق التسلسل ووقت الإدراج والمدة. |
| **انتشار الحقول** | الحقول التي قرأها التشغيل وكتبها، وكيف انتقل التغيير بينها. يمثل الأزرق المتقطع الأصل الذي أدى إلى هذه الكتابة، والرمادي مدخلًا لم يُكتب في هذا التشغيل، والأخضر ما كُتب في هذا التشغيل، وتمثل الأسهم تبعيات الحقول أو انتقالات الارتباط لا ترتيب الخطوات. لا تُرسم إلا الأصول التي تصل فعليًا إلى كتابات هذا التشغيل. استخدم **توسيع** لفتح الرسم بملء الشاشة عندما يصعب تتبع سلسلة عريضة داخل الصفحة. |
لا يسجل دفتر المسار إلا المهام التي أُنشئت بعد إصدار هذه الميزة، ويحتفظ بسجل لمدة 7 أيام. تعرض المهمة الأقدم بيانات قائمة الانتظار من دون رسم انتشار. ولا تعرض المهمة الأولية التي لم يخطط لها العامل بعد إلا حقول تشغيلها. عندما لا ينتج عن تغيير أي كتابات محسوبة لاحقة، يوضح الرسم ذلك: لم يعتمد شيء على تلك الحقول من خلال صيغة أو بحث أو تجميع أو عنوان ارتباط.
## معالجة المهام الشاذة
يعرض عدد **الفاشلة** وقسم **معالجة الحالات الشاذة** أنواعًا مختلفة من المشكلات، ولذلك قد تختلف أرقامهما.
تجمع **معالجة الحالات الشاذة** الحالات في مجموعات مشكلات، واحدة لكل قاعدة بيانات وجدول مصدر وخطأ، حتى يسهل اكتشاف السبب الجذري الواحد. راجع سبب الفشل وأصلح المشكلة الأساسية قبل استرداد أي شيء. وسّع مجموعة لقراءة تفاصيل الخطأ والمهام التي تشملها؛ هذه الصفوف للفحص، ويُنفذ الاسترداد دائمًا على المجموعة بأكملها.
تعتمد الإجراءات التي توفرها المجموعة على نوعها:
| نوع الحالة الشاذة | الإجراء | ما يحدث |
| ----------------- | ------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| **رسالة ميتة** | **استرداد المجموعة بأكملها** | يعيد كل الرسائل الميتة الموجودة حاليًا في تلك المجموعة إلى قائمة الانتظار الدائمة ويسلّمها مجددًا. وتظل كل مجموعة أخرى من دون تغيير. |
| **رسالة ميتة** | **تجاهل المجموعة** (في قائمة **إجراءات إضافية**) | يحذف الرسائل الميتة في تلك المجموعة نهائيًا. لا يمكن استردادها أو إعادة تشغيلها بعد ذلك، لذا لا تستخدمه إلا عندما تكون إعادة التشغيل بلا جدوى. |
| **انتهت مهلتها** | **إعادة تفعيل أحدث مهمة منتهية المهلة** | يوقظ قائمة الانتظار لأحدث مهمة في المجموعة حتى يتمكن عامل من توليها. |
بعد استرداد مجموعة، يبلغ Teable بعدد المهام التي استعادها، وعدد المهام التي أُدرجت حديثًا أو كانت مدرجة بالفعل، وعدد ما سُلّم منها أو أُجّل. ثم تستهلك العوامل المجموعة وفق حدود التزامن وتقسيم المهام الحالية.
تنتمي المجموعة التي تحمل علامة **قاعدة البيانات محذوفة** إلى قاعدة بيانات لم تعد موجودة. سيفشل استردادها فورًا مرة أخرى، لذلك يكون **تجاهل المجموعة** هو الإجراء الوحيد المتاح.
لم يعد نقل جدول إلى سلة المهملات ينشئ حالات شاذة هنا. تتخطى المهمة المحسوبة التي لا تزال تشير إلى جدول في سلة المهملات الخطوات التي تقرأه، وتكمل الخطوات التي تستهدف جداول نشطة، ثم تنتهي.
لا يتاح الاسترداد أيضًا عندما تكون البيانات نفسها سبب الفشل، مثل قيمة تتجاوز حد الحجم أو تخالف قيدًا على حقل. ستفشل إعادة تشغيل المهمة نفسها بالطريقة ذاتها، لذا تجاهل المجموعة وأصلح بيانات المصدر أو تعريف الحقل بدلاً من ذلك؛ وستعيد عمليات الكتابة اللاحقة حساب تلك الحقول تلقائيًا.
## إيقاف المهام المحسوبة مؤقتًا لمساحة
عندما تؤدي المهام المحسوبة لإحدى المساحات إلى تفاقم حادثة، أوقف تلك المساحة مؤقتًا في **إيقافات المهام المحسوبة** بدلاً من إيقاف النسخة بأكملها.
انقر على **إيقاف مساحة مؤقتًا**.
ابحث حسب معرّف المساحة أو اسمها، ثم حددها من النتائج.
اضبط **مدة الإيقاف المؤقت** على 15 أو 30 أو 60 أو 120 دقيقة.
دوّن الحادثة أو نافذة الصيانة في **السبب**.
انقر على **تأكيد الإيقاف المؤقت**.
لا يمنع الإيقاف المؤقت إلا العوامل من المطالبة بمهام محسوبة جديدة لتلك المساحة. لا تتوقف المهام الجاري تنفيذها، وتنتظر المهام المطابقة حتى انتهاء الإيقاف بدلاً من إسقاطها.
ينتهي الإيقاف المؤقت دائمًا تلقائيًا، وساعتان هما أطول مدة يمكنك تعيينها. إذا استمرت الحادثة بعد ذلك، فأوقف المساحة مؤقتًا مرة أخرى من هذه الصفحة. تعرض القائمة كل إيقاف نشط مع منشئه وسببه ووقت الاستئناف التلقائي، إلى جانب عدد المهام المعلقة التي تحتجزها الإيقافات النشطة، حتى تتمكن من تقدير الأعمال المتراكمة التي سيحررها الاستئناف. لإنهاء إيقاف مبكرًا، انقر على **استئناف** في صفه وأكد الإجراء.
## ضبط التزامن
يتضمن قسم قائمة الانتظار عنصري تحكم في التزامن. يكتب كل منهما تجاوزًا على مستوى المجموعة تلتقطه كل عملية خلال نحو 15 ثانية من دون إعادة تشغيل، ويمكن إعادة تعيين كل منهما حتى تعود العمليات إلى إعدادات بيئتها. تشير شارة **تم التجاوز** إلى عنصر تحكم لم يعد على قيمته الافتراضية.
| عنصر التحكم | ما يقيّده |
| ---------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **التزامن لكل عملية** | عدد المهام المحسوبة التي تعالجها كل عملية عامل في الوقت نفسه. |
| **حدود المطالبة لكل قاعدة بيانات** | عدد المهام المحسوبة التي تعمل في الوقت نفسه لقاعدة بيانات واحدة (**لكل قاعدة بيانات**) ولجدول مصدر واحد داخلها (**لكل جدول أولي**). القيمة الافتراضية لكل منهما 2، ويقبلان قيمًا من 1 إلى 16. |
ارفع حدود المطالبة عندما تكون قاعدة بيانات مزدحمة واحدة هي عنق الزجاجة، وارفع التزامن لكل عملية عندما تكون عدة قواعد بيانات في قائمة الانتظار في الوقت نفسه.
يفرض التزامن الأعلى حملًا أكبر على قاعدة بياناتك. تحتفظ المساحات التي تخزن بياناتها في [مستأجر قاعدة بيانات](/ar/basic/admin-panel/database-tenant) بالإعدادات الافتراضية للبيئة الخاصة بحدود المطالبة، لأن مجمعات اتصالاتها مضبوطة لتلك القيم.