جودة DevOps / المتوسط: أنظمة تحقق موثوقة / الدرس 12

رصد الاختبارات وفرزها القابل للتصرف

اربط الحالة الفاشلة ببيئتها ونشاط التطبيق دون تحويل القياس لأرشيف غير مضبوط.

وقت القراءة التقريبي: 3 دقيقةتاريخ مراجعة المحتوى 2026-10-25

في هذه الصفحة

أهداف الدرس

صمم أدلة مترابطة للاختبار والتطبيق والمسار.
قِس جودة التشخيص واحفظ تشخيصاً يراعي الخصوصية.

ابدأ بأسئلة التشخيص

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

استخدم مقاطع لعمليات محدودة

تمثل آثار OpenTelemetry العمليات بمقاطع وعلاقات وتوقيت. علّم حدوداً كإنشاء البيانات وطلب الحجز وانتظار التأكيد لا كل سطر تحقق. اربط بنقل السياق المدعوم عند توفر التكامل ولا تضع حمولات خاصة بالسمات. تتطور الاتفاقيات والواجهات فثبت SDK والاتفاقية. يستخدم المثال سمات qa.* يعرّفها التطبيق لا حقولاً معيارية مزعومة، ويفترض مزود تتبع اختباري محلياً مضبوطاً.

python مقطع اختبار Python محدود بـ OpenTelemetry

from opentelemetry import trace

tracer = trace.get_tracer("booking.qa")

def traced_case(run_id, case_id, exercise):
    with tracer.start_as_current_span("qa.case") as span:
        span.set_attribute("qa.run_id", run_id)
        span.set_attribute("qa.case_id", case_id)
        return exercise()

يتطلب حزم API وSDK متوافقة ومثبتة ومصدّراً معتمداً؛ لا تثبت أو تتصل الدورة بشيء. exercise دالة بيانات محلية. لا تربط الرموز أو البريد أو أجسام الطلبات بالمقاطع.

اختر مقاييس بمقامات صادقة

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

خزن أول دليل مفيد

يحفظ سجل الفرز أول خطأ ذي صلة ويربط تشخيصاً محدوداً بضبط وصول. صنف مؤقتاً عند جهل السبب ثم حدّث بالدليل. يميز السجل السلوك الفاشل من حالة المسار ويظهر المحاولة. قيم الحزمة وسوم اصطناعية لا ادعاءات تشفير. يربط الاستيعاب الموثوق الهوية الثابتة الفعلية. لا تستبدله عند نجاح الإعادة؛ احفظ العلاقة للمقارنة.

json غلاف فرز يعرّفه التطبيق

{
  "caseId": "reserve-final-seat",
  "runId": "lab-run-51",
  "attempt": 1,
  "artifact": "lab-candidate-51",
  "phase": "assertion",
  "classification": "unclassified",
  "errorCode": "CAPACITY_MISMATCH",
  "diagnostics": ["owned-trace-51", "fixture-manifest-51"]
}

تشير الأسماء لحزم اصطناعية مضبوطة الوصول لا روابط حقيقية. يحتاج المخطط احتفاظاً وحجباً وسلامة وملكية. احفظ رمز الخطأ الآلي ثابتاً وترجم التفسير خارج حقله.

حسّن دورة التحقيق

وجه الفشل لمالك يميز التطبيق والاختبار والبيئة والمسار. قِس تقليل الدليل لإعادة العمل وتغير التصنيف بعد المراجعة. حسّن البيانات والتحققات والقياس بحوادث ممثلة. لا ترتب الأفراد بعدد المهام الحمراء؛ يشجع ذلك إخفاء الإشارات. للرصد كلفة وخصوصية؛ خذ عينة من النجاح واحفظ فشلاً محدوداً وانتهِ بالحزم بقصد. الهدف طريق قصير مبرر من الفشل للإصلاح المتحقق لا أكبر حجم قياس.

الأخطاء الشائعة وإصلاحها

للفشل لقطات بلا هوية مرشح

لماذا يحدث؟: انفصل التشخيص عن بيانات المسار.
كيف تصلحه؟: اربط الحزمة والبيئة والتشغيل والحالة والمحاولة.
كيف تتجنب تكراره؟: تحقق من الغلاف قبل قبول التقارير.

ينمو الرصد مع كل معرّف مستخدم مولد

لماذا يحدث؟: المعرّفات غير المحدودة أبعاد مقاييس.
كيف تصلحه؟: استخدم فئات محدودة وروابط تتبع للتفصيل.
كيف تتجنب تكراره؟: راجع كثرة القيم وميزانية الاحتفاظ.

تحذف الإعادة الناجحة التتبع الأصلي

لماذا يحدث؟: تستبدل الأسماء بين المحاولات.
كيف تصلحه؟: احفظ أدلة كل محاولة وعلاقاتها.
كيف تتجنب تكراره؟: اختبر جمع التشخيص مع الإعادة.

اختبر فهمك

1. قد تأتي مهلة من الإعداد أو API أو واجهة قديمة. ما الدليل الفاصل؟

اعرض الحل المشروح

سجل مدد المراحل والجاهزية وتتبع الطلب ونتيجته وحالة تحقق الواجهة. إذا لم يكتمل الإعداد فصنفه أولاً. إذا نجح API سريعاً وبقيت الواجهة قديمة فافحص المراقبة لا تزد مهلة الخادم عشوائياً.

2. تعرض لوحة نجاح 98% بعد استبعاد التقارير المفقودة. كيف تتغير؟