Prometheus / المتوسط: PromQL وعقود القواعد / الدرس 9

المدرجات التقليدية وتقدير المئينات

اقرأ سلاسل الحاويات التراكمية، واحفظ le أثناء التجميع، وميّز نسبة العتبة المعدودة مباشرة من تقدير المئين بالاستيفاء.

وقت القراءة التقريبي: 4 دقيقةتاريخ مراجعة المحتوى 2026-10-28

في هذه الصفحة

أهداف الدرس

اشرح أدوار _bucket و_sum و_count.
اجمع الحاويات التقليدية المتوافقة قبل تقدير المئين.
بيّن قيود دقة الحاويات ومجموعة المشاهدات.

المدرج التقليدي عائلة سلاسل مترابطة

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

احفظ تسمية حد الحاوية

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

promql تعبير تعليمي لمئين p95 لمدرج تقليدي

histogram_quantile(0.95,
  sum by (le, operation) (
    rate(warehouse_request_duration_seconds_bucket{job="warehouse-lab"}[5m])
  )
)

يحفظ التعبير غير التنفيذي le ويفترض حاويات متوافقة بالثواني. لم يحسب محرك استعلام نتيجة مئين.

استخدم حداً مطابقاً لسؤال العتبة

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

python عينة محلية لعتبة مدرج

durations = [0.05, 0.2, 0.4, 0.8, 1.4]
cumulative = [sum(value <= bound for value in durations) for bound in (0.1, 0.5, float("inf"))]
print("cumulative_buckets", cumulative)
print("within_half_second", f"{cumulative[1] / cumulative[-1]:.0%}")
print("mean_seconds", f"{sum(durations) / len(durations):.2f}")

الناتج المتوقع

cumulative_buckets [1, 3, 5]
within_half_second 60%
mean_seconds 0.57

تتداخل الأعداد تراكمياً، وتبلغ خمس مشاهدات عند اللانهاية. نسبة العينة الدقيقة 60% دون محرك استعلام مدرجات.

افحص المجموعة قبل دمج الحاويات

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

راجع الدقة وتكلفة السلاسل معاً

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

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

تُجمع كل الحاويات كإجمالي الحركة.

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

تتلقى histogram_quantile حاويات بلا le.

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

تُحسب p95 الخدمة بمتوسط المئينات.

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

اختبر فهمك

1. الأعداد التراكمية عند 0.1 و0.5 واللانهاية هي 2 و8 و10. كم مشاهدة تقع فوق 0.1 وحتى 0.5؟

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

توجد 8 − 2 = 6 مشاهدات في ذلك الفاصل. العدد الكلي عشرة وليس عشرين. يستخدم هذا معنى الحدود العليا التراكمية، ويفترض عائلة واحدة متوافقة. وتبلغ نسبة تحقيق عتبة 0.5 مباشرة ثمانية من عشرة، أي ثمانين بالمئة.

2. لماذا قد يكون رقم p95 الذي يبدو دقيقاً مضللاً بعد هجرة إعداد المدرج؟