محتويات الدورة

قابلية الرصد / الأساسي: الإشارات ومعنى القياس / الدرس 2

أنواع المقاييس ووحداتها ومعنى التراكم والفروق

اختر أداة القياس وفق معنى الكمية، ثم احفظ وحدتها وطريقة تجميعها ومعنى نقاطها التراكمية أو الفروقية خلال الجمع والاستعلام.

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

أهداف الدرس

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

اختر الأداة بحسب المعنى لا شكل الرسم

يسجل العداد زيادات كمية تتراكم، مثل عدد مسوحات الطرود المقبولة. أما عمق الطابور الحالي فيمكن أن يرتفع أو ينخفض، ويحتاج أداة تمثل هذا السلوك. ويسجل المدرج توزيع قياسات، مثل مدة المعالجة. يميز OpenTelemetry الأدوات المتزامنة وغير المتزامنة ومعاني التجميع المسموحة لها؛ ويجب فحص دعم SDK الخاص باللغة والنسخة الفعليتين. لا تختر الأداة لمجرد أن رسمها يشبه اللوحة التي تريدها. اكتب أولاً الكمية ووحدتها وطريقة تحديثها والتجميع المقصود، ثم اختر أداة مدعومة تحافظ على هذا المعنى.

اجعل الوحدة جزءاً من عقد القياس

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

yaml عقد تعليمي لقياس مدة
quantity: parcel-processing-duration
unit: seconds
measurement: processing-end-minus-processing-start
instrument_shape: histogram
attributes: [bounded-operation-type, bounded-result-class]
excluded_attributes: [parcel-id, customer-email]

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

ميّز المجموع التراكمي من فرق الفاصل

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

python تحليل محلي للتحويل من التراكمي إلى الفروق
cumulative = [10, 15, 21]
deltas = [current - previous for previous, current in zip(cumulative, cumulative[1:])]
print(deltas)
print("incorrect_sum", sum(cumulative))
print("observed_increase", cumulative[-1] - cumulative[0])
الناتج المتوقع
[5, 6]
incorrect_sum 46
observed_increase 11

تبلغ الزيادة المرصودة 11 بعد المشاهدة الأولى؛ أما العشرة الأولية فقد وقعت قبل حد المقارنة. ولا يحاكي المثال أي إعادة ضبط للعداد.

تحقق من أن الجمع يجيب السؤال

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

أنشئ نسخاً واضحة للتغيرات الدلالية

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

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

يؤدي جمع لقطات العداد إلى تضخيم الحركة.

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

يبدو زمن الاستجابة أصغر بعامل ألف.

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

لا تنخفض قيمة عداد عمق الطابور أبداً.

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

اختبر فهمك

1. تعرض عملية قيماً تراكمية 80 ثم 95، ثم 4 بعد إعادة تشغيلها. هل الزيادة الأخيرة تساوي ناقص 91؟

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

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

2. هل ينبغي حساب متوسط عمق الطابور في ثلاثة أقسام مستقلة أم جمعه؟

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

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

أهم ما تعلمته

  • يسبق معنى أداة القياس صياغة استدعاءات SDK.
  • يجب الحفاظ على الوحدة ومعنى التراكم أو الفرق عبر مسار البيانات كله.
  • يحتاج التجميع إلى مجموعة محددة وغرض واضح.

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