تتبّع تشغيل قابل لإعادة البناء
التشغيل شجرة
تنفيذ الوكيل ليس سجلًا خطيًا، وإجباره على أن يكون كذلك هو سبب امتلاك فرق كثيرة لسجلات لا تستطيع الاستفادة منها. التشغيل يحتوي خطوات؛ والخطوة تحتوي استدعاءً واحدًا للنموذج وتنفيذات الأدوات التي طلبها؛ والوكيل الفرعي (Subagent) يتفرّع تحت الخطوة التي أطلقته؛ وإعادة المحاولة (Retry) تقع تحت الاستدعاء الذي تكرّره. صمّمه على هيئة مقاطع (Spans) لها مراجع إلى آبائها، مع معرّف تشغيل واحد يُمرَّر في كل مكان، بما في ذلك الأنظمة اللاحقة التي تلمسها الأدوات، بحيث يمكن تتبّع سجل شاذ في خدمة أخرى رجوعًا إلى التشغيل والخطوة اللذين أنشآه. البنية هي ما يجعل التتبّع (Tracing) قابلًا للاستخدام: تتيح لك طيّ تشغيل من أربعين خطوة إلى شكله العام، وتوسيع الخطوة التي أخطأت وحدها، ورؤية ما إذا كان وكيل فرعي متورطًا فورًا. أما تدفّق مسطّح من أسطر السجل لوكيل متزامن فهو أقرب إلى غير المقروء، ولا يقرؤه أحد في الواقع.
- التشغيل يحتوي خطوات؛ والخطوة تحتوي استدعاءً للنموذج وتنفيذات أدواته
- الوكلاء الفرعيون يتفرّعون تحت الخطوة التي أطلقتهم؛ وإعادات المحاولة تحت الاستدعاء الذي تكرّره
- مرّر معرّف التشغيل إلى الأنظمة اللاحقة التي تكتب فيها الأدوات
- البنية هي ما يجعل التشغيل الطويل مقروءًا — السجلات المسطّحة لوكلاء متزامنين لا تُقرأ
سجّل ما لا يمكن إعادة بنائه
معيار انتماء حقل ما إلى التتبّع هو: هل يمكنك استعادته لاحقًا من مصدر آخر؟ التعليمات المجمّعة لا يمكن استعادتها، لأن تطبيق القوالب والاسترجاع والضغط والاقتطاع كلها حدثت وقت التشغيل، والقالب لا يخبرك بما خرج فعلًا — وهذا الحقل هو الأكثر غيابًا على الإطلاق، وغيابه هو أكثر ما يُنهي التحقيقات. ونتائج الأدوات الخام لا يمكن استعادتها، لأن النظام الخارجي قد تغيّر منذ ذلك الحين. ومعاملات الأدوات كما أُرسلت، والإصدارات المستخدمة، وحالة الميزانية في كل خطوة، وأي فرع من منطق التجميع نُفّذ، كلها تقع في الفئة نفسها. ما يمكنك حذفه بأمان هو كل ما يمكن اشتقاقه: أعداد الرموز التي يمكنك إعادة حسابها، والتنسيق الذي يمكنك إعادة توليده. خزّن مدخلات القرارات لا سرد ما جرى فيها.
- التعليمات المجمّعة لا يمكن استعادتها لاحقًا، وهي الحقل الأكثر غيابًا
- نتائج الأدوات الخام لا يمكن استعادتها لأن النظام الخارجي قد تغيّر
- التقط أيضًا المعاملات كما أُرسلت، والإصدارات، وحالة الميزانية، وفرع التجميع الذي نُفّذ
- احذف كل ما يمكن اشتقاقه لاحقًا؛ خزّن مدخلات القرارات لا السرد
الحجم وأخذ العيّنات والتكلفة
التتبّعات الكاملة الدقة كبيرة — فهي تحتوي كل التعليمات، ما يعني أنها قد تتجاوز حجم ناتج العمل نفسه بفارق كبير — وعند حجم التشغيل الفعلي يصبح التخزين والنقل تكلفة حقيقية تكتشفها الفرق متأخرة، فتستجيب بتقليص التتبّع إلى لا شيء. خطّط للتدرّج بدل ذلك. احتفظ بالدقة الكاملة لنسبة مختارة بالعيّنة من التشغيلات الناجحة، ولكل تشغيل فشل أو بلغ سقف الميزانية أو أطلق بوابة أو انتهى بالتصعيد، لأن هذه هي التشغيلات التي سيرغب أي أحد في رؤيتها. واحتفظ بهياكل مختصرة — عدد الخطوات، والأدوات المستدعاة، والتوقيتات، والتكاليف، والنتيجة — لكل شيء، لأن الهيكل المختصر هو ما يقوم عليه التحليل الإجمالي، وهو صغير. حدّد مدة الاحتفاظ حسب الفئة لا بشكل موحّد، وقرّرها قبل الإطلاق، لأنك بعد وقوع الحادثة لن تملك إلا نافذة الاحتفاظ التي حدّدتها مسبقًا.
- التتبّعات الكاملة قد تتجاوز حجم ناتج العمل؛ وتكاليف الحجم حقيقية
- دقة كاملة للإخفاقات وتجاوزات الميزانية والتشغيلات المحجوزة ببوابة والمصعّدة، مع عيّنة من النجاحات
- هياكل مختصرة لكل شيء: الخطوات، والأدوات، والتوقيتات، والتكلفة، والنتيجة
- حدّد الاحتفاظ لكل فئة قبل الإطلاق — بعد الحادثة يكون الأوان قد فات
جرّب بنفسك
اختبار التتبّع ليس في كمية ما يحمله، بل في قدرة شخص ما على إعادة بناء تشغيل منه بعد وقوعه. طبّق هذا الاختبار على فشل حقيقي الآن، بدل أن تطبّقه أثناء الحادثة التي يكون فيها الأمر حاسمًا.
اعثر على تشغيل واحد لوكيلك فشل أو تصرّف بشكل غريب، وحاول الإجابة عن الأسئلة التسعة أدناه من التتبّع المخزّن وحده — دون وصول إلى النظام العامل، ودون إعادة تنفيذ، ودون سؤال المهندس الذي بناه. كل سؤال لا تستطيع الإجابة عنه يحدّد حقلًا يجب إضافته. إن لم تكن لديك تتبّعات بعد، فطبّق القائمة على مخطط التتبّع الذي تصمّمه، وحدّد الحقول التي سيحملها بالفعل.
التشغيل: النتيجة: أجب من التتبّع وحده: 1. ما السياق الدقيق الذي رآه النموذج في الخطوة التي أخطأ فيها؟ 2. ما المعاملات التي أُرسلت إلى كل أداة، كما أُرسلت فعلًا لا كما قُصد؟ 3. ماذا أعادت كل أداة، بصيغتها الخام؟ 4. ما إصدارات النموذج والتعليمات ومخطط الأدوات وفهرس الاسترجاع التي كانت سارية؟ 5. كم كانت الميزانية المتبقية في كل خطوة؟ 6. أي فرع من منطق التجميع نُفّذ، وهل اقتُطع شيء أو ضُغط؟ 7. هل عمل وكيل فرعي، وتحت أي خطوة؟ 8. ما قرارات البوابات أو السياسات التي قُيّمت، وماذا أعاد كل منها؟ 9. لماذا انتهى التشغيل، كما هو مسجّل لا كما يُستنتج؟ لكل سؤال لم تستطع الإجابة عنه: الحقل المطلوب إضافته | مكان إصداره في الكود | هل يمكن استعادته من مصدر آخر؟ | فئة الاحتفاظ
- وصلت إلى حكم محدد على السبب، أو تستطيع تسمية السؤال الدقيق الذي عجز التتبّع عن الإجابة عنه
- تحوّلت كل ثغرة إلى حقل مسمّى له مكان في الكود الذي يُصدره، لا إلى ملاحظة بتحسين التسجيل
- تستطيع أن تحدّد أي الثغرات كان غير قابل للاستعادة فعلًا، وأيها كان يمكن اشتقاقه مما خُزّن بالفعل