قابلية الرصد / الأساسي: الإشارات ومعنى القياس / الدرس 5
المدرجات وملخصات زمن الاستجابة الصادقة
اختر حدود التوزيع وفق السؤال، وميّز تمثيلات الحاويات، وتجنب تجميع المئينات غير الصحيح أو إظهار دقة لا تسندها البيانات.
في هذه الصفحة
أهداف الدرس
- صنف المشاهدات ضمن فواصل ذات حدود صريحة.
- ميّز الأعداد المنفصلة للحاويات من أعدادها التراكمية.
- اشرح شروط التقدير والتجميع المتوافق.
لا يصف المتوسط المجموعة كاملة
قد يكون لحملَي معالجة المتوسط نفسه، مع اختلاف كبير في ذيل الاستجابات البطيئة. يلخص المدرج كيفية وقوع المشاهدات ضمن نطاقات، ويتيح السؤال عن النسبة التي تحقق مهلة أو عن شكل توزيع الزمن. أدرج الفشل وانتهاء المهل في سياسة القياس؛ فقد يجعل قياس النهايات الناجحة وحدها نظاماً فاشلاً يبدو أسرع. سجل حد المشاهدة والوحدة قبل تصميم الحاويات. فالمدة المقاسة حول نداء تخزين واحد لا تعادل تأخر تحديث الطرد من بدايته إلى نهايته، حتى لو عُرض الاثنان بالثواني في لوحة واحدة.
ضع الحدود حيث يحتاج القرار إلى الدقة
تحدد حدود الحاويات الصريحة الدقة المتاحة قرب قيمة مهمة. إذا اعتمد القرار على الإكمال خلال نصف ثانية، فقد يتيح حد مطابق عدّاً مباشراً بدلاً من الاستيفاء بين حدين بعيدين. يمكن أن تحسن الحاويات الإضافية الدقة، لكنها تزيد حجم البيانات. ويعرّف OpenTelemetry تمثيلات أخرى للمدرجات؛ لذا يجب فحص دعم المخزن والمصدر، لا افتراض أن التحويل يحفظ المعلومات كاملة. يبين السجل التحريري الكمية وسياسة الحدود وما يحدث لما يتجاوزها، وهو تصميم تعليمي وليس تعريف view في SDK أو إعداد جامع.
distribution: parcel-processing-seconds
explicit_upper_bounds: [0.1, 0.5, 1.0]
includes_overflow: true
question: fraction-at-or-below-0.5-seconds
compatibility_check: unit-boundaries-population-and-temporality
يدعم وجود حد عند 0.5 ثانية سؤال العتبة المحدد. السجل ليس إعلاناً باستخدام API في OpenTelemetry.
اعرف هل تتداخل أعداد الحاويات
في التمثيل ذي الحاويات الصريحة المنفصلة، تنتمي كل مشاهدة إلى فاصل واحد. لكن بعض صيغ التصدير تعرض أعداداً تراكمية عند كل حد علوي، فتظهر المشاهدات الصغيرة أيضاً ضمن الحاويات الأعلى. ينشئ المثال المحلي أعداداً منفصلة ويشتق التراكمية من المشاهدات الخمس نفسها. يؤدي جمع الأعداد التراكمية إلى تكرار عد كثير من المشاهدات. اقرأ صيغة الإشارة الفعلية قبل كتابة استعلام أو تحويل. يفيد العدد الإجمالي كفحص اتساق، لكنه لا يبين هل كانت الأحداث مؤهلة، أو هل أسقط مسار سابق بعض المشاهدات بالفعل.
values = [0.05, 0.2, 0.4, 0.8, 1.4]
bounds = [0.1, 0.5, 1.0]
disjoint = [0, 0, 0, 0]
for value in values:
index = next((i for i, bound in enumerate(bounds) if value <= bound), len(bounds))
disjoint[index] += 1
cumulative = [sum(disjoint[:i + 1]) for i in range(len(disjoint))]
print("disjoint", disjoint)
print("cumulative", cumulative)
print("within_half_second", f"{cumulative[1] / len(values):.0%}")
disjoint [1, 2, 1, 1]
cumulative [1, 3, 4, 5]
within_half_second 60%
تمثل الحاوية الأخيرة القيم المتجاوزة للحدود. تحقق ثلاث مشاهدات من خمس عتبة 0.5 ثانية، أي 60%، دون استخدام محرك قياس.
ادمج الأدلة المتوافقة قبل تقدير المئين
يمكن أن تدعم المدرجات تجميع المجموعة عندما يتوافق تمثيلها ومعناها. افحص الوحدات والحدود أو قواعد المقياس ومجموعة الأحداث والتمثيل الزمني والفاصل. قد ينتج جمع حاويات مختلفة، لمجرد أن مصفوفتيها متساويتان في الطول، توزيعاً يبدو معقولاً لكنه بلا معنى. لا تحسب متوسط p95 للمثيلات وتسميه p95 للخدمة؛ فالمئينات غير قابلة للجمع. احفظ عدد العينات وحدود التقدير. وإذا قللت إعادة التقسيم أو التحويل الدقة، فأظهر الفقد كيلا يفهم قارئ لاحق قيمة ذيل مستوفاة على أنها مهلة مقاسة بدقة.
وضح ما يستطيع التوزيع إثباته
يمكن للمدرج إثبات الأعداد ضمن النطاقات التي يمثلها، بينما يعتمد المئين المقدر على طريقة الاستعلام والدقة المتاحة. تحتاج العينات القليلة حذراً خاصاً؛ فقد تحرك مشاهدة بطيئة واحدة مئيناً مرتفعاً بشدة. قارن مزيج الحركة والبيانات المفقودة قبل نسبة تغير التوزيع إلى إصدار. افصل التزام عتبة محددة عن المئينات الاستكشافية عندما يخدمان قرارين مختلفين. ينفذ هذا الدرس مصنف حاويات محلياً فقط؛ ولا يختبر تجميع OpenTelemetry أو استعلام مدرجات Prometheus أو تحويل مخزن أو حملاً مقاساً لزمن الاستجابة.
الأخطاء الشائعة وإصلاحها
تتجاوز مجاميع الحاويات عدد المشاهدات.
- لماذا يحدث؟
- جُمعت الأعداد التراكمية كما لو كانت فواصل منفصلة.
- كيف تصلحه؟
- استخدم معنى العد الصحيح لصيغة البيانات.
- كيف تتجنب تكراره؟
- اختبر توزيعاً صغيراً معلوماً قبل كتابة استعلامات الإنتاج.
ينتج دمج مدرجين توزيعاً زائفاً.
- لماذا يحدث؟
- تختلف الوحدات أو الحدود بينهما.
- كيف تصلحه؟
- وحّد التمثيلات المتوافقة، أو أبقها منفصلة.
- كيف تتجنب تكراره؟
- أنشئ نسخاً لعقود المدرجات بالتنسيق مع المستهلكين.
يُحسب p95 للخدمة بمتوسط p95 للمثيلات.
- لماذا يحدث؟
- عوملت المئينات غير القابلة للجمع كمجاميع.
- كيف تصلحه؟
- اجمع التوزيعات الأساسية المتوافقة أولاً.
- كيف تتجنب تكراره؟
- وثق طريقة التقدير وعدد العينات.
اختبر فهمك
1. الأعداد التراكمية عند الحدود 0.1 و0.5 واللانهاية هي 2 و7 و10. كم مشاهدة تقع فوق 0.1 وحتى 0.5؟
اعرض الحل المشروح
اطرح العدد التراكمي عند الحد الأدنى من العدد عند الأعلى: 7 − 2 = 5 مشاهدات. العدد الإجمالي عشرة وليس تسعة عشر. يفترض هذا التفسير معنى الحدود العليا التراكمية المذكور، ومجموعة مشاهدات واحدة متوافقة.
2. هل يستطيع مدرج ذو حدين 0.1 و1.0 إثبات النسبة الدقيقة التي تحقق 0.5؟
اعرض الحل المشروح
لا يستطيع ذلك من أعداد هاتين الحاويتين وحدها؛ فالمشاهدات بين 0.1 و1.0 غير مفصولة عند 0.5. قد يتاح تقدير بافتراضات إضافية، لكن يجب تسميته تقديراً. يحتاج العد المباشر للعتبة إلى حد صريح مناسب أو تمثيل متوافق أعلى دقة.
أهم ما تعلمته
- يحدد تمثيل الحاويات العمليات الحسابية الصحيحة.
- يحدد موضع الحد مقدار الدقة المتاحة لسؤال العتبة.
- تحتاج دقة المئين وتجميعه إلى بيان القيود صراحة.