في أدوات الأتمتة، تكون لحظة ظهور رسالة «اكتملت المهمة» مريحة للمستخدم، لكنها غالبًا أسوأ لحظة للمهندس الذي يعود إلى التشغيل بعد أيام ليفهم ما جرى. الرسالة تخبرنا بأن شيئًا ما انتهى، ولا تخبرنا كيف انتهى، ولا ما الذي تغيّر في الطريق، ولا لماذا نجح تشغيل وفشل آخر بالمهمة نفسها. السجل الجيد هو الفرق بين أداة تُعطي انطباعًا وأداة تُعطي دليلًا.
هذه ليست مسألة رفاهية تقنية. عندما تصبح المهام الآلية جزءًا من عمل متكرر، يصبح السجل هو الذاكرة الوحيدة القابلة للفحص. وكل سجل يُكتب بعناية يوفر وقتًا كان سيُصرف في إعادة التجربة العمياء، وكل سجل يُكتب باستعجال يتحول إلى عبء جديد: بيانات كثيرة بلا معنى، أو بيانات قليلة بلا فائدة.
لماذا لا تكفي عبارة النجاح؟
كلمة «نجاح» تصف حالة نهائية، لا مسارًا. وهي تُسقط تفاصيل حاسمة: هل نُفّذت كل الخطوات أم تم تجاوز بعضها؟ هل استغرق التنفيذ ثانية أم دقيقة؟ هل مرّ التشغيل بمحاولة إعادة بعد انقطاع؟ هل نجح العنصر المطلوب فعلًا أم أن المحدِّد (selector) التقط عنصرًا آخر بالخطأ؟ كل هذه الأسئلة مشروعة، ولا يستطيع أي منها أن يُجاب من رسالة من كلمتين.
الخطر الأكبر يظهر في الأعطال المتقطعة. تشغيل ينجح اليوم ويفشل غدًا على البروفايل نفسه قد يكون ضحية تغيّر في الصفحة، أو انتهاء جلسة، أو بطء شبكة، أو تعديل في خطوة سابقة. إذا كانت النتيجة المسجلة هي «فشل» فقط، فإن التحقيق يبدأ من الصفر في كل مرة. أما إذا كان السجل يحمل تسلسل الأحداث، فإن التحقيق يبدأ من نقطة قريبة من السبب.
السجل كبنية، لا كنص حر
الفارق الجوهري بين السجل المفيد والسجل العابث هو البنية. النص الحر، مثل «حدث خطأ أثناء تنفيذ المهمة»، سهل الكتابة وصعب التحليل؛ لأنه يجمع رسالة للبشر مع بيانات تقنية في سطر واحد، ولا يمكن تجميعه أو مقارنته بين تشغيلين. أما السجل المنظم فيفصل الحقول: معرّف التشغيل، اسم الخطوة، وقت البداية، وقت النهاية، الحالة، ورمز الخطأ.
السجل الجيد يحتاج ثلاث صفات عملية. أولًا، قابلية الربط: كل سطر يجب أن يحمل معرّفًا يجمعه مع بقية أسطر التشغيل نفسه، ومعرّفًا آخر يربط المحاولات المتكررة. ثانيًا، قابلية الترتيب: الطوابع الزمنية مع المنطقة الزمنية، ورقم تسلسلي للخطوة، حتى لا يعتمد القارئ على ترتيب وصول الأسطر. ثالثًا، قابلية القراءة الآمنة: أي شخص يفتح السجل يجب أن يفهمه دون أن يرى ما لا يُفترض أن يراه.
من المفيد أيضًا التمييز بين ثلاثة أشياء كثيرًا ما تُخلط: السجل (log) يجيب عن «ماذا حدث في هذا التشغيل؟»، والمقياس (metric) يجيب عن «كم مرة يحدث ذلك عبر التشغيلات؟»، والتتبع (trace) يجيب عن «أين ذهب الوقت؟». للأتمتة المتعددة الخطوات، السجل المنظم لكل خطوة هو العمود الفقري، لأن الخطوات هي وحدات الفهم الطبيعية.
سيناريو واقعي: ثلاثة بروفايلات والمهمة نفسها
لنفترض سيناريو افتراضيًا لم يُنفَّذ فعليًا، نستخدمه للتوضيح فقط: مهمة اسمها «فحص مسار الشراء» تزور صفحة السلة، ثم تتحقق من وجود زر إتمام الطلب، ثم تتحقق من ظهور ملخص الطلب. شُغّلت المهمة على ثلاثة بروفايلات: الأول بجلسة قديمة، والثاني على شبكة بطيئة، والثالث بعد تغيير في تصميم الصفحة.
حصل المشغّل على «اكتملت المهمة» في التشغيلات الثلاثة، ثم جاءت ملاحظة لاحقة بأن أحد البروفايلات لم يصل إلى صفحة الملخص. لو كان السجل يحتفظ فقط بالنتيجة النهائية، فسيبدو التناقض لغزًا. لكن سجلًا يحتفظ بكل خطوة سيكشف صورة مختلفة: في البروفايل الثاني، انتظرت الخطوة الثالثة أطول من المعتاد ثم نجحت بعد محاولة إعادة؛ وفي الثالث، طابق المحدِّد عنصرًا مخفيًا فبدت الخطوة ناجحة بينما الصفحة لم تكن جاهزة. الأول قد يمر دون ملاحظة لأن الجلسة كانت صالحة وقت التشغيل ثم انتهت.
الدرس هنا ليس أن الأداة سيئة، بل أن «النجاح» يمكن أن يكون سطحيًا إذا لم يُقس على شرط واضح. السجل يسمح لنا بالتفريق بين نجاح حقيقي، ونجاح بعد تعافٍ، ونجاح زائف بسبب شرط تحقق ضعيف. وهذه التفريقة هي ما يجعل الإصلاح ممكنًا قبل أن يتكرر العطل.
الحد الأدنى من الحقول المفيدة
لا تحتاج إلى تسجيل كل شيء. تحتاج إلى تسجيل ما يفسر المشكلة بأمان. الحد الأدنى العملي يمكن أن يتكون من: معرّف التشغيل، واسم المهمة، ومرجع غير حساس للبروفايل (مثل «بروفايل-07» بدل بيانات الهوية)، ورقم الخطوة واسمها، ووقت البداية والنهاية، والحالة، ورمز الخطأ عند الفشل، ورقم المحاولة. هذه الحقول تجيب عن الأسئلة الأربعة: أين توقف التنفيذ؟ متى؟ بأي خطوة؟ وهل كانت هناك محاولة سابقة؟
مثال مختصر لشكل سجل خطوة واحدة، بوصفه توضيحًا للبنية لا نموذجًا لمنتج بعينه:
```text run=2026-11-13 T09:14Z-4f2a task=checkout-smoke profile_ref=p-07 step=3 name=assert_summary status=error code=E_TIMEOUT attempt=2 duration_ms=12150 ```
لاحظ ما هو غائب عمدًا: لا كوكيز، ولا رموز دخول، ولا كلمات مرور، ولا محتوى الصفحة الخاص. لاحظ أيضًا أن رمز الخطأ ثابت وقابل للتجميع، بينما الرسالة النصية للبشر يمكن أن تتغير. هذا الفصل بين «رمز للآلة» و«نص للإنسان» هو ما يجعل السجلات قابلة للتحليل دون أن تفقد وضوحها.
أخطاء شائعة تفسد السجل
أول خطأ هو الاكتفاء بتسجيل النتيجة النهائية. هذا يجعل السجل جميلًا عند النجاح وعديم القيمة عند الفشل. والخطأ الثاني هو تسجيل الأسرار بحجة التشخيص: تشخيص يحتوي على رمز جلسة لم يعد تشخيصًا آمنًا، بل مشكلة أمنية مؤجلة.
الخطأ الثالث هو الرسائل النصية الحرة المتغيرة، مثل تضمين اسم العنصر أو طول الصفحة في نص الخطأ نفسه؛ فتصبح كل رسالة فريدة، ويصعب تجميع الأعطال المتشابهة. والرابع هو إغفال المنطقة الزمنية، فيصير ترتيب الأحداث محل شك عند مقارنة تشغيلات من مصادر مختلفة. والخامس هو كتابة سجل ضخم في سطر واحد، يجمع كل الخطوات ثم يُرسل دفعة واحدة، فيفقد القارئ القدرة على معرفة أي خطوة استهلكت الوقت.
الخطأ السادس هو عدم ربط المحاولات المتكررة بمعرّف أب. عندما تُعاد المحاولة، تظهر كأنها تشغيل جديد، فتضيع قصة التعافي. والسابع هو التعامل مع مستوى التسجيل (level) كأنه حكم على العمل: خطأ تقني في خطوة اختيارية ليس بالضرورة فشلًا للمهمة، والعكس صحيح. والثامن هو تجاهل سياسة الاحتفاظ: سجل بلا مدة صلاحية يصبح أرشيفًا ثقيلًا، وسجل بلا تنقيح يصبح خطرًا.
كيف تقيس جودة السجل؟
أبسط اختبار هو اختبار القارئ الخارجي: أعطِ السجل لشخص لم يشغّل المهمة، واسأله إن كان يستطيع تحديد سبب التوقف دون الرجوع إليك. إذا احتاج إلى سؤالك، فالسجل ناقص. ويمكن تحويل هذا إلى معيار متكرر: نسبة التشغيلات الفاشلة التي لها سبب مصنّف برمز واضح، ونسبة الأخطاء التي تبقى تحت مسمى «غير معروف»، والزمن اللازم للوصول إلى السبب.
هناك معايير أخرى قابلة للقياس: عدد الحقول الثابتة في كل سطر، وحجم السجل لكل خطوة، ونسبة السجلات التي تحتوي أنماطًا حساسة (والهدف هنا صفر)، ونسبة الخطوات التي تحمل طوابع زمنية متسقة. لكن الأهم من الأرقام هو اختبار السيناريو: هل يمكن إعادة بناء قصة التشغيل من السجل وحده؟ إن كانت الإجابة نعم، فأنت على الطريق الصحيح.
حدود التصميم وما لا يستطيعه السجل
السجل لا يعوّض إعادة إنتاج العطل. قد يصف لك ما حدث بدقة، لكنه لا يثبت أن السبب الذي استنتجته هو السبب الفعلي. وقد يكون ناقصًا بحكم التصميم إذا قررت تسجيل الخطوات المهمة فقط لتقليل الحجم. كما أن السجل ليس أداة مراقبة دائمة، ولا ينبغي أن يتحول إلى جمع بيانات بلا غاية.
هناك حدّ آخر مهم: السجل الجيد يكلّف شيئًا. كل حقل تضيفه يزيد حجم البيانات، وكل بيانات تحتفظ بها تحتاج سياسة حذف وتنقيح. لذلك التصميم الجيد يوازن بين كفاية التشخيص وتقليل المخاطر. وفي هذا السياق، من المفيد التوضيح أن Social Browser برنامج لإدارة Profiles وأتمتة سير العمل، وليس أداة مضمونة لتجاوز كشف المنصات؛ hence فإن جودة السجل هنا مسألة تشغيلية تنظيمية، لا وعد بنتائج خارج قدرة الأداة.
تجربة مصرح بها خطوة بخطوة
يمكنك تطبيق هذا على مشروعك دون أي تدخل خارجي. ابدأ باختيار سجل قديم لمهمة فاشلة تملك صلاحية الوصول إليه. اكتب على ورقة الأسئلة التي تحتاجها للإجابة: أين توقفت المهمة؟ ما الخطوة السابقة؟ هل كانت هناك محاولة إعادة؟ ثم افتح السجل وقارن. سجّل الفجوات بدل أن تخمنها.
بعد ذلك، أضف الحقول الناقصة إلى سجل تجريبي، وأعد تشغيل سيناريو اختباري على بروفايل تملكه، بشرط أن يكون التشغيل مصرحًا به ومحدودًا. لا تجمع بيانات شخصية، ولا تشارك السجل خارج فريقك قبل تنقيحه. وأخيرًا، اعرض السجل على زميل لم يشارك في التشغيل واطلب منه تفسير الفشل. هذه التجربة لا تُنتج أرقامًا عن أداء منتج، لكنها تكشف جودة السجل كأداة فهم.
أسئلة شائعة
هل أسجل كل خطوة أم الخطوات المهمة فقط؟ سجّل كل خطوة تغيّر حالة أو تنتظر الشبكة أو تتحقق من شرط. الخطوات التجميلية يمكن دمجها.
هل أكتب نص الخطأ كما ظهر؟ اكتب رمزًا ثابتًا، وأضف رسالة قصيرة منقّحة. النص الخام قد يحمل بيانات لا تصلح للمشاركة.
كم مدة الاحتفاظ بالسجلات؟ حسب حاجة المراجعة وسياسة مشروعك، مع تدوير واضح وحذف لما لا يلزم. الأفضل مدة محددة مسبقًا لا مفتوحة.
هل يكفي السجل وحده للدعم؟ لا. تحتاج معه سياق الإصدار والبيئة واسم السيناريو، وإلا بقي السبب محتملًا.
هل يمكن تسجيل لقطة شاشة عند الفشل؟ ممكن إذا كان ذلك مصرحًا به ومحدودًا، لكن اللقطة قد تحتوي بيانات خاصة، فتحتاج تنقيحًا وسياسة وصول.
ما الفرق بين السجل والتقرير؟ التقرير مُشتق ومُلخّص للقارئ، أما السجل فهو المادة الخام التي يُبنى منها التقرير.
خلاصة عملية
اجعل السجل يجيب عن سؤال واحد: «ماذا حدث في هذا التشغيل، وبأي دليل؟». سجّل وقت البداية والنهاية، ومعرّف التشغيل، ومرجع البروفايل غير الحساس، واسم المهمة، ورقم الخطوة وحالتها، ورمز الخطأ ورقم المحاولة. لا تسجّل الأسرار، ولا المحتوى الخاص، ولا الكوكيز ورموز الدخول. اختبر السجل بقارئ خارجي، وقس نسبة الأخطاء غير المصنفة، وثبّت سياسة احتفاظ وتنقيح. وبهذا تنتقل من رسالة «تم بنجاح» إلى ذاكرة تشغيلية قابلة للمراجعة، وهي التي تصنع الفرق عندما يتعقد التشغيل ويتعدد البروفايلات.
لمن يريد متابعة أدوات إدارة Profiles وأتمتة سير العمل، يمكن زيارة الموقع العربي ل ـSocial Browser.
شارك في تقييم ونقاش المقال
رأيك يضيف قيمة للمقال ويساعدنا على تحسين المحتوى والنقاش حوله.
النقاش
جارٍ تحميل التعليقات…