تقنية

العدد التراكمي وعد الفترة: متى يصح طرح قراءتين؟

قراءة 120 وقراءة 147 للعداد نفسه تعطيانزيادة 27 عند استمرار العداد دون تصفير أو التفاف
رسم أصلي لطرح مشروط في المثال الافتراضي، وليس قياس إنجازات فعلية.

العدد التراكمي وعد الفترة يصفان معنيين مختلفين. يعرّف Prometheus العداد Counter بأنه قيمة تراكمية تزيد أو تصفر عند إعادة التشغيل، ويميزه عن Gauge الذي قد يصعد ويهبط. [1]

الخلاصة السريعة

قراءة العداد تصف تراكمه، والزيادة في فترة قد تستخرج من فرق قراءتين للعداد نفسه إذا استمر تعريفه ولم يصفر أو يلتف. افحص ذلك قبل تفسير الفرق، ولا تجعل آخر قراءة عد الفترة تلقائيا.

  • العداد التراكمي يزيد أو يصفر عند إعادة التشغيل وفق تعريف Prometheus؛ وهو مختلف عن قيمة قد تصعد وتهبط. [1]
  • في المثال، القراءة 147 ناقص 120 تعطي 27 إنجازا للفترة، بشرط العداد نفسه وعدم تصفيره وتوافق التسجيل.
  • بعد تصفير العداد، آخر قراءة قد تصف جزءا لاحقا فقط؛ لا نعتبر الطرح السلبي عد إنجازات ولا نخمن الجزء المفقود.
  • وثق الهوية والوقت وطريقة الزيادة والتصفير قبل اشتقاق ميزة؛ ارتفاع القراءتين وحده لا يثبت غياب تصفير بينهما.

ماذا تعني قراءة متراكمة؟

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

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

متى يوضح الفرق زيادة الفترة؟

في مثالنا، قراءة العداد نفسه عند 10:00 هي 120، وعند 10:10 هي 147. نفترض أنه زاد فقط واحدا لكل إنجاز، واستمر دون تصفير أو التفاف، وأن التسجيل متوافق. عندئذ الفرق 147 ناقص 120 يساوي 27 إنجازا بين القراءتين.

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

ما الذي يتغير عند التصفير؟

يشمل تعريف العداد في Prometheus التصفير عند إعادة التشغيل. [1]

لنفترض إعادة تشغيل في أثناء فترة المثال، ثم أصبح العداد 12 بعدها. هذه القراءة لا تمنحنا وحدها عدد المهام التي اكتملت قبل التصفير خلال الفترة. وطرح 120 من 12 يعطي عددا سالبا حسابيا، لكنه ليس «إنجازات سالبة» وفقا لتعريف مهمتنا.

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

كيف نوثق القيمة المشتقة؟

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

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

المصادر ومتابعة القراءة

  1. Prometheus: Metric types — Counter and Gauge (يفتح في نافذة جديدة)prometheus.io

أُعدّ هذا المقال بصياغة عربية أصلية بالاستناد إلى المصادر أعلاه، وهو مدخل تمهيدي إلى الموضوع. اقرأ منهجية المحتوى وحدوده.