قابلية الرصد / الأساسي: الإشارات ومعنى القياس / الدرس 6
مسارات الجمع وإظهار فقد البيانات
ارسم مسار بيانات القياس من الرصد إلى الاستعلام، وميّز صمت المصدر والتصفية المقصودة والتخزين المؤقت وفشل التصدير وظهور البيانات في المخزن.
في هذه الصفحة
أهداف الدرس
- اشرح مسؤوليات المستقبل والمعالج والمصدر داخل المسار.
- طابق أعداد المراحل الافتراضية مع بيان الفقد صراحة.
- عرّف حداثة البيانات وسلامة المسار بوصفهما سؤالين مستقلين.
ارسم كل حد يمكن أن يحول البيانات
تعبر بيانات القياس حدوداً متعددة قبل أن يعرضها استعلام: الرصد، وتجميع SDK أو تخزينه المؤقت، والنقل، والجمع، والمعالجة، والتصدير، والحفظ، واختيار الاستعلام. لا تتضمن كل بيئة جميع المراحل، وقد تتكرر بعض المراحل. يستطيع الجامع استقبال الإشارات وتطبيق معالجات مضبوطة ثم تصديرها عبر مسارات مهيأة. يعتمد توفر المكونات وصياغة الإعداد على التوزيعة والنسخة الفعليتين. عامل الرسم نموذجاً يحتاج تحققاً، لا دليلاً على أن كل إشارة تسلكه. سجل مواضع التصفية وأخذ العينات وحذف السمات وتحويل التمثيل التراكمي أو الفروقي.
حدد ما تقبله كل مرحلة وما تصدره
سجل عند كل حد نوع الإشارة والصيغة المقبولة والوجهة والتحويلات المتوقعة ومعالجة الفشل والمالك. لا يثبت إعلان مستقبل في ملف إعداد أنه مشارك في مسار خدمة نشط. وقد يعني إقرار النقل الناجح قبول البيانات في طابور، لا حفظها دائماً وإتاحتها للاستعلام. يفصل السجل التحريري هذه الحالات ويسمي المشاهدات اللازمة. وهو مقصود كتصميم غير تنفيذي، لا كإعداد جامع قابل للتشغيل؛ فلا يتضمن نقاط اتصال أو بيانات اعتماد أو مسارات تخزين أو نسخ مكونات خاصة ببيئة فعلية.
pipeline_review: parcel-telemetry
stages: [accepted, processed, queued, exported, queryable]
intentional_drop_policy: bounded-and-counted
retry_policy: finite-and-observable
freshness_measure: source-event-to-query-visibility
health_owner: telemetry-platform-team
يميز السجل تقدم النقل من ظهور البيانات للاستعلام. وهو عقد تحريري، وليس YAML لإعداد OpenTelemetry Collector.
افصل حساب الفقد المقصود عن غير المتوقع
يبدأ المثال المحلي بألف سجل مقبول، ويسقط مئة عمداً وفق السياسة، ثم يرصد عشرين فشل تصدير من المجموعة الباقية. يصل 880 سجلاً إلى الوجهة في النموذج. إن عرض نسبة تسليم 88% وحدها يخفي الفرق بين تصفية متوقعة وفشل غير متوقع. تحتوي المسارات الفعلية غير المتزامنة أيضاً سجلات جارية ومتأخرة، لذلك قد لا تتوازن أعداد المراحل في لحظة واحدة. وحّد النوافذ واحسب تغير الطابور قبل إعلان الفقد. وقد تزيد إعادة ضبط العدادات والمحاولات وتكرار التصدير تعقيد المطابقة.
accepted = 1000
policy_dropped = 100
export_failed = 20
exported = accepted - policy_dropped - export_failed
assert accepted == policy_dropped + export_failed + exported
print("exported", exported)
print("unexpected_loss_fraction", f"{export_failed / (accepted - policy_dropped):.2%}")
exported 880
unexpected_loss_fraction 2.22%تستخدم نسبة الفقد غير المتوقع 900 سجل بقيت مؤهلة بعد التصفية المقصودة. ويفترض النموذج عدم وجود سجلات منتظرة أو مكررة.
تعرّف حدود التخزين المؤقت والضغط العكسي
يمكن أن يمتص التخزين المؤقت انقطاعاً قصيراً، لكن الذاكرة أو التخزين الدائم المحدود يمتلئ في النهاية إذا تجاوز الوصول التصدير الناجح. قد تؤخر الإعادات ظهور البيانات وتستهلك الموارد، وقد تفقد إعادة التشغيل العمل الموجود في الذاكرة بحسب التنفيذ. عرّف سلوك امتلاء المخازن وكيف يصبح مرئياً. قد يصعب تشخيص تطبيق سليم عندما يمتلئ مسار قياسه. تجنب جعل طلبات العمل تنتظر تصدير القياس دون حد. تحتاج مفاضلات الأداء والديمومة معرفة سلوك SDK والجامع الفعليين، ولا يحسمها حجم طابور موصى به للجميع.
راقب أداة الرصد بسؤال مستقل
تسأل سلامة المسار هل بيانات القياس المتوقعة كاملة وحديثة بما يكفي لدعم القرارات. افحص الحجم المقبول والمرفوض وضغط الطابور وأخطاء التصدير والمعالجة وعمر البيانات وفق المعاني الموثقة للمكوّن الفعلي. احفظ وسيلة لمعرفة متى يكون مسار الاستعلام المعتاد نفسه أعمى. لا تفسر لوحة فارغة بأنها صفر أخطاء خدمة قبل فحص الجمع والاختيار. تستخدم الدورة حساب أعداد محلياً وتصاميم تحريرية فقط؛ ولا تشغل جامعاً أو تفتح منفذاً أو ترسل بيانات أو تملأ طابوراً أو تتحقق من ديمومة مخزن.
الأخطاء الشائعة وإصلاحها
يُعرض إقرار الاستلام بوصفه حفظاً دائماً.
- لماذا يحدث؟
- اختلط قبول النقل بديمومة المخزن.
- كيف تصلحه؟
- حدد الحد الذي يشمله الإقرار وتحقق من المراحل اللاحقة مستقلة.
- كيف تتجنب تكراره؟
- وثق حالات القبول وحدود ضمان الحفظ.
يُنسب غياب البيانات إلى الرصد فوراً.
- لماذا يحدث؟
- تُخطيت مراحل التصفية والتخزين المؤقت والتصدير والاستعلام.
- كيف تصلحه؟
- تتبع الإشارة عبر كل حد ذي مالك.
- كيف تتجنب تكراره؟
- احفظ أعداد المراحل وأدلة الحداثة.
يُعامل المخزن المؤقت كحماية غير محدودة من الانقطاع.
- لماذا يحدث؟
- أُهملت محدودية الموارد والتراكم المستمر.
- كيف تصلحه؟
- حدد سلوك تجاوز السعة وتوقعات تعافٍ محدودة.
- كيف تتجنب تكراره؟
- راجع السعة ومعاني الفشل الخاصة بالنسخة الفعلية.
اختبر فهمك
1. يرتفع عدد السجلات المقبولة وينخفض التصدير وينمو الطابور. هل فُقدت جميع البيانات غير الظاهرة؟
اعرض الحل المشروح
ليس بالضرورة. قد تبقى سجلات مخزنة مؤقتاً أو قيد الإعادة، وقد تنتهي فترة المشاهدة قبل تصديرها. قارن تغير الطابور وعدادات الفشل والإسقاط والطوابع الزمنية والظهور اللاحق بنوافذ متوافقة. ولا تعلن سلامة الحفظ الدائم أيضاً؛ بل افحص سلوك الثبات وتجاوز السعة في التنفيذ.
2. لماذا ينبغي حساب السجلات التي تسقطها التصفية المقصودة؟
اعرض الحل المشروح
يجعل ذلك عقد البيانات قابلاً للتدقيق، ويميز التخفيض المتوقع من مسار معطل. وإلا فقد يبدو مرشح جديد انخفاضاً في حركة التطبيق. سجل السياسة والأسباب المحدودة والإشارة المتأثرة ونسخة التغيير، حتى يفهم المستهلكون أي مجموعة بقيت ولماذا.
أهم ما تعلمته
- لقبول البيانات في المسار حدود متعددة مختلفة.
- احسب إسقاط السياسة والفشل والعمل الذي ما زال جارياً.
- تحتاج حداثة القياس واكتماله إلى ملكية صريحة.