دليل التشغيل (Runbook) الجيد في صفحة واحدة

دليل التشغيل (Runbook) هو تعليمات مكتوبة لتنفيذ مهمة تشغيلية أو معالجة تنبيه محدد. قيمته تظهر عندما يكون الخبير غير متاح.

صفات الدليل الجيد

• مرتبط بتنبيه أو مهمة محددة، لا بنظام كامل.
• قصير: صفحة واحدة تكفي غالبًا.
• أوامر قابلة للنسخ بدل الوصف العام.
• نقاط قرار واضحة: إذا كانت النتيجة كذا فافعل كذا.
• متى تصعّد ولمن.

قالب مقترح

1. الغرض: ماذا يعالج هذا الدليل، وما التنبيه المرتبط به.
2. الأثر: ما الذي يشعر به المستخدمون.
3. التحقق السريع: خطوتان أو ثلاث للتأكد من المشكلة.
4. المعالجة: خطوات مرقمة مع الأوامر.
5. التحقق بعد المعالجة: كيف تعرف أن الخدمة عادت.
6. التصعيد: متى، ولمن، وبأي معلومات.
7. آخر مراجعة: التاريخ والشخص.

حافظ عليه صحيحًا

• حدّث الدليل بعد كل حادثة استُخدم فيها.
• اجعل مهندسًا جديدًا ينفّذه في بيئة اختبار؛ أي سؤال يطرحه يعني نقصًا في الدليل.
• الخطوات المتكررة دائمًا مرشحة للأتمتة، والدليل حينها يصبح «شغّل هذا السكربت وتحقق من النتيجة».