مراقبة تشغيلات خطوط الأنابيب
هذه الصفحة لكل ما يلي بدء التشغيل: العثور عليه، وقراءة ما فعلته كل خطوة، وإعادة التشغيل الفاشل إلى العمل. لبدء تشغيل، انظر تشغيل خط أنابيب يدويًا.
العثور على تشغيل
قسم بعنوان “العثور على تشغيل”- انقر خطوط الأنابيب في الشريط الجانبي لمساحة العمل. الشاشة هي طابور تشغيلات مساحة العمل: كل تشغيل، والأحدث أولًا.
- استخدم شريط التصفية بجانب الجدول. المرشّحات ثلاثة بالضبط، ولكل منها عدد حي: الكل، قيد التشغيل، فشل.
- تنقّل بين صفوف الجدول بـ ↑/↓ (أو j/k) واضغط Enter لفتح التشغيل الذي عليه التركيز. النقر على الصف يفعل الأمر نفسه.
يعرض كل صف أيقونة لطريقة بدء التشغيل: أيقونة تشغيل للبدء اليدوي، وأيقونة
ملف لمراقبة مخطط الشفرة، وإلا فأيقونة المشغّل التلقائي. يسمّي التلميح
المشغّل — يدوي، نُشر PR، تغيير ملف، وما شابه — ويذكر، في تشغيل
المراقبة، الملفات التي تغيّرت. ثم اسم خط الأنابيب، وشارة الحالة، والمدة
النشطة (أو موضع الطابور لتشغيل queued)، ومنذ متى بدأت هذه المحاولة.
المدة النشطة تستبعد فترات الخمول بين الإيقاف وإعادة التشغيل، فهي لا
تطابق الزمن المنقضي على الساعة.
لا مرشّح للتشغيلات المكتملة أو المعلّقة أو الملغاة، ولا مرشّح لكل قالب، ولا نافذة زمنية، ولا عرض لسجل تشغيلات قالب بعينه. مقارنة تشغيلات قالب واحد تعني البحث عن اسمه في الطابور.
قراءة تفاصيل التشغيل
قسم بعنوان “قراءة تفاصيل التشغيل”لصفحة التشغيل ثلاثة أجزاء متراصة.
شريط البيانات يحمل وقت البدء، والمدة النشطة، وتقدّم الخطوات («3 من 7 خطوات»)، وملخص الفشل الذي يسمّي الخطوة التي فشلت وسبب فشلها، وإجراءَي إعادة المحاولة وحذف.
الخط الزمني يعطي شريطًا لكل خطوة، مع مدتها، ولخطوات الوكيل تكلفتها
بالسنت. الخطوة التي أُعيدت محاولتها تُظهر اللاحقة ×N بعد مدتها، وهذه
اللاحقة هي الموضع الوحيد الذي يظهر فيه عدد المحاولات.
لوحة المخطط ترسم القالب مع الحالة الحيّة لكل عقدة. تحديد عقدة يفتح لوحة خطوتها.
حالات التشغيل والخطوة
قسم بعنوان “حالات التشغيل والخطوة”| الحالة | المعنى |
|---|---|
| قيد الانتظار | أُنشئ ولم يبدأ بعد |
| في قائمة الانتظار | قُبل لكنه مُبقًى: سقف الحد الأقصى للتشغيلات المتوازية لهذا القالب ممتلئ، ولا صفوف خطوات بعد |
| قيد التشغيل | يُنفَّذ |
| معلّق | ينتظر أمرًا خارجيًا. هذا طبيعي، والخطوة ليست عالقة |
| مكتمل | انتهى بنجاح |
| فشل | انتهى بخطأ |
| أُلغي | أوقفه مستخدم أو النظام |
للخطوات الحالات نفسها ما عدا في قائمة الانتظار، ويُضاف تم تخطيه للفرع الذي لم يسلكه الموجّه ولما تفرّع عنه وصار غير قابل للوصول.
معلّق هي الحال التي تقضي فيها خطوة الوكيل جلّ وقتها: وكيل مُرسَل أو
بوابة موافقة يبقيها حتى يكتمل عملها. ضمانتان في المحرّك تُفشلان التشغيل
كله بدل استئنافه: خطوة بقيت معلّقة أطول من 24 ساعة
(extras.awaitApproval — جسم orchestration.awaitApproval — مستثنى،
وhuman.gate ليس كذلك)، وخطوة غير متماثلة الأثر كانت في منتصف التنفيذ
حين توقف الخادم.
فحص خطوة
قسم بعنوان “فحص خطوة”حدّد عقدة على اللوحة. تعرض لوحة الخطوة، بالترتيب:
- تنبيه الخطأ حين تفشل الخطوة، أو تنبيه تم تخطيها مع السبب حين تُتخطى.
- بدأت وانتهت والمدة.
- الفرع — فهرس الفرع، للفروع المتوازية.
- عرض المحادثة — ينتقل إلى المحادثة التي عملت فيها الخطوة. محادثات خط الأنابيب مخفية عن الشريط الجانبي، فهذا السبيل الوحيد إليها.
- المدخل والمخرج، بصيغة JSON قابلة للطي.
- نشاط الوكيل — بطاقة لكل تشغيل وكيل أرسلته الخطوة، مع حالته وملخصه ومدته وتكلفته.
في خطوة الوكيل، المخرج هو الحمولة المنظَّمة التي سلّمها الوكيل عبر
submit_output، لا النص الذي كتبه. أثر الاستدلال في نشاط الوكيل وفي
المحادثة التي يفتحها عرض المحادثة.
في خطوة bash، المخرج هو stdout المشذَّب الذي كتبه السكربت عند الخروج 0. الخروج بغير صفر يُفشل الخطوة، وذيل stderr هو رسالة الخطأ.
استعادة تشغيل فاشل
قسم بعنوان “استعادة تشغيل فاشل”- اقرأ ملخص الفشل في شريط البيانات؛ فهو يسمّي الخطوة الفاشلة. تنبيه الخطأ في لوحة الخطوة يحمل الرسالة.
- افحص المدخل الخاص بالخطوة: مفتاح حالة ناقص أو مكتوب خطأ هو السبب الأكثر شيوعًا. خطوة وكيل الموجّه تفشل فورًا وتسمّي العناصر النائبة غير المحسومة، أما خطوة bash فتعرضها سلاسل فارغة وتمضي في التنفيذ، فيظهر الخلل عادة في الخطوة التالية.
- لخطوة وكيل، افتح عرض المحادثة واقرأ ما فعله الوكيل فعلًا.
- اضغط إعادة المحاولة في شريط البيانات. الخطوات المكتملة والمتخطاة تحتفظ بمخرجاتها، ويُحذف ما عداها ويُعاد تنفيذه، ويعود التشغيل إلى قيد التشغيل. تبدأ ساعة المدة من جديد لهذه المحاولة.
أسباب شائعة يجدر فحصها أولًا:
- انتهاء المهلة — تجاوزت الخطوة المهلة (مللي ثانية). تذكّر أن الحقل بالمللي ثانية.
- خطأ في السكربت — خرج أمر bash بغير صفر، أو
bashليس علىPATHلمضيف الخادم. - التحقق من المخطط — حمولة
submit_outputالتي سلّمها الوكيل لم تطابق مخطط إخراج الخطوة. - عنصر نائب غير محسوم —
{{key}}أشارت إليه خطوة وكيل الموجّه ولم يُكتَب في خطوة سابقة. يسمّي الخطأ كل مفتاح غير محسوم. - جسم غير مسجّل — خطوة مفتاح جسمها غير مسجّل تحذّر عند تحميل القالب ثم لا تُنفَّذ أصلًا.
إيقاف خطوة عالقة
قسم بعنوان “إيقاف خطوة عالقة”حدّد الخطوة قيد التشغيل، واضغط زر إنهاء العمليات الجارية في ترويسة لوحة الخطوة. يقتل ذلك عملية الخطوة، ويعلّمها فاشلة، فيفشل التشغيل كله معها، ويُغلَق كل فرع شقيق ما زال مفتوحًا.
لا عنصر لإلغاء التشغيل في هذه الشاشة. pipeline.cancel موجود كعملية
RPC، والمحرّك ينفّذه، لكن واجهة خطوط الأنابيب لا تستدعيه. إنهاء
العمليات الجارية على خطوة، أو حذف على التشغيل، هما وسيلتا الإيقاف
المتاحَتان.
تتبّع التكلفة
قسم بعنوان “تتبّع التكلفة”تُعرض التكلفة لكل خطوة، في العمود الأخير من الخط الزمني وعلى كل بطاقة تحت نشاط الوكيل. لا مجموع للتشغيل في صفحة التفاصيل، ولا عمود تكلفة في طابور التشغيلات، فمقارنة تكلفة تشغيلين تعني جمع خطواتهما.