محتويات الدورة
معمارية البرمجيات
الأساسيات: الوعود والبنية والملكية
التفاعلات: التوزيع والفشل والتشغيل
التطور: السعة والانتقال والتحقق والمراجعة

معمارية البرمجيات / التفاعلات: التوزيع والفشل والتشغيل / الدرس 12

صمّم الرصد حول الأسئلة والملكية

استخدم المقاييس والآثار والسجلات والربط والتنبيهات لتفسير نتائج الورش مع ضبط حساسية البيانات وكلفة الرصد.

وقت القراءة التقريبي: 4 دقيقةتاريخ مراجعة المحتوى
في هذه الصفحة

أهداف الدرس

  • اختر إشارات الرصد لسؤال تشخيص أو خدمة محدد.
  • حدّد معنى التنبيه وحدود التنوع وتسليما تشغيليا مفيدا.

راقب وعد المستخدم واعتمادياته

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

استخدم إشارات متكاملة بدلا من سجل شامل

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

json حدث نتيجة منظم افتراضي
{"event":"reservation.completed","outcome":"confirmed","reservation_ref":"r-12","trace_id":"11111111111111111111111111111111","duration_ms":42}

المثال JSON صالح بمعرفات وزمن مختلقين. يوضح مخطط رصد فقط، ولا يشغّل مصدرا أو خلفية مراقبة.

أبق الهوية كثيرة القيم خارج أبعاد المقاييس

تميّز مجموعة الوسوم سلسلة المقياس. وقد ينشئ معرف الحجز أو البريد أو URL حر سلسلة لكل حدث تقريبا، فيزيد الكلفة ويعقد التجميع. استخدم أبعادا محدودة كالعملية والنتيجة عندما تجيب السؤال. ضع المراجع التفصيلية في سجلات أو آثار محمية عند الضرورة. ولا تعني المحدودية انعدام الحساسية؛ فالمنطقة أو فئة المستأجر أو الخطأ قد تكشف معلومات أو تضاعف التركيبات. راجع الأبعاد والاحتفاظ ضمن عقد المعمارية.

ينبغي أن يطلب التنبيه قرارا مملوكا

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

yaml عقد تنبيه تشغيلي
alert: notification completion delay threatens the product target
evidence: oldest pending job age and completion rate
owner: notification workflow owner
first_checks: [provider errors, worker saturation, retry backlog]
missing_data: investigate collection health
threshold: derived from the agreed completion objective

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

احفظ سياقا يكفي لإعادة الاستدلال

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

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

يعد مقياس النجاح الطلبات التي وصلت للمعالج الأخير فقط.

لماذا يحدث؟
يستبعد المقام الإخفاقات السابقة.
كيف تصلحه؟
حدّد المحاولات المحتسبة عند حد الوعد.
كيف تتجنب تكراره؟
راجع البسط والمقام معا.

يصبح معرف الحجز وسم مقياس.

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

لتنبيه لا يوجد مستجيب أو ملاحظة تالية.

لماذا يحدث؟
اعتُبر الإشعار حلا.
كيف تصلحه؟
عيّن مالكا ومسار تحقيق مختصرا.
كيف تتجنب تكراره؟
راجع هل يقود كل تنبيه إلى قرار مفيد.

اختبر فهمك

1. العاملون أحياء لكن أقدم إشعار عمره ساعتان. أي ادعاء غير مدعوم؟

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

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

2. لماذا لا نسجل جسم كل طلب لتسهيل التشخيص؟

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

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

أهم ما تعلمته

  • راقب الأسئلة والنتائج وحدود الاعتماديات.
  • يحتاج التنبيه شرطا مفيدا ومالكا مسؤولا.

المراجع الرسمية