Prometheus / المتوسط: PromQL وعقود القواعد / الدرس 7
التجميع ونسب الأخطاء ذات المعنى
استخدم التجميع والأعداد الموزونة لاشتقاق نسبة خدمة، مع حفظ التأهيل والوحدات والفرق بين سلسلة غائبة وصفر مقاس.
في هذه الصفحة
أهداف الدرس
- اشرح اختيارات التجميع باستخدام by وwithout.
- ابن مجموعتين متوافقتين للبسط والمقام.
- فسر النسب مع اختلاف الحركة وغياب نتائج معينة.
اختر المجموعة قبل إسقاط التسميات
يختزل التجميع السلاسل وفق أبعاد معلنة. تُبقي sum by(operation) تسميات التجميع المختارة وتسقط غيرها، بينما تزيل without(instance) المسماة وقد تحتفظ بأبعاد تضاف لاحقاً. ليس أحدهما أكثر أماناً للجميع؛ فقد يجزئ بعد جديد نتيجة، وقد تدمج قائمة by ضيقة بيئات. حدد المجموعة والمحددات أولاً. احفظ حدود العملية أو البيئة أو المستأجر عند حاجة السؤال. لا يعني اختصار التعبير وضوح العقد، خصوصاً إن افترض المستهلك تسميات أسقطها التجميع.
اقسم معدلات متوافقة لا متوسط النسب
يجمع التعبير معدلات الأخطاء المختارة بحسب العملية ويقسمها على معدلات كل الطلبات المؤهلة بالتجميع نفسه. يجب أن يحدد عقد المصدر التأهيل؛ فلا يستنتج PromQL هل يدخل مدخل عميل مشوه. النسبة بلا وحدة لأن الطرفين أحداث في الثانية. يغير الضرب بمئة العرض إلى نسبة مئوية لا المجموعة. لا تضف ثابتاً اعتباطياً للمقام لتجنب الفراغ. يحتاج المقام الصفري أو البسط الغائب سياسة واضحة توافق الحدث والرصد الفعليين.
sum by (operation) (
rate(warehouse_requests_total{job="warehouse-lab",outcome="error"}[5m])
)
/
sum by (operation) (
rate(warehouse_requests_total{job="warehouse-lab"}[5m])
)
يستخدم التعبير غير المنفذ المهمة والنافذة نفسيهما للطرفين. ويفترض أن المصدر يعد المحاولات المؤهلة المتفق عليها.
وضح كيف يضلل متوسط النسب
تقارن العينة مثيلين: خطأ واحد من عشرة طلبات، وخطأ من 990. يعطي متوسط نسب خطأ المثيلات نحو 5.05%، بينما تعطي المجموعة المجمعة 0.2%. الوزن المتساوي إحصاء مستقل صالح، لكنه لا يجيب سؤال الخدمة الموزون بالأحداث. لتجميع المعدلات متطلبات مجموعة مشابهة، منها توافق النوافذ ومعالجة الضبط. يستخدم حساب بايثون أعداد نافذة ثابتة مكتملة، ولا يعيد استقراء Prometheus أو يقيّم الاستعلام السابق.
instances = [(1, 10), (1, 990)]
mean_error = sum(bad / total for bad, total in instances) / len(instances)
combined_error = sum(bad for bad, total in instances) / sum(total for bad, total in instances)
print("mean_instance_error", f"{mean_error:.2%}")
print("population_error", f"{combined_error:.2%}")
mean_instance_error 5.05%
population_error 0.20%ينتمي الخطآن إلى ألف طلب. يوضح الحساب الوزن فقط، وليس قاعدة تسجيل مختبرة أو نتيجة محرك PromQL.
ليس غياب تدفق الخطأ صفراً دائماً
قد تنشئ الأداة سلسلة نتيجة بعد أول حدث فقط، فتبقى النسبة فارغة عند غياب سلسلة خطأ رغم وجود حركة مؤهلة. وقد يعطي فشل الجمع غياباً مشابهاً بمعنى مختلف. راجع تهيئة مكتبة العميل المدعومة ومعنى الاستعلام، ولا تحول كل فجوة إلى صفر. افصل الحركة المتوقعة من اكتمال القياس. قد يخفي تعبير بديل واسع مصدراً معطلاً أو يلصق تسميات خطأ. اختبر انعدام الحركة وعدم الأخطاء وغياب المصدر والعملية الجديدة مستقلة قبل الاستدعاء.
احفظ الصحة خلال تغييرات المستهلك
راجع البسط والمقام معاً كلما تغيرت تسميات النتائج أو شروط التأهيل أو التجميع أو الرصد. قد تستمر لوحة في عرض علامة النسبة المئوية نفسها مع أنها تختار مجموعة مختلفة بعد نشر إصدار. احفظ نسخة العقد ونافذة الاستعلام والوحدات ونطاق المصدر بجوار النتيجة. قارن الشرائح الإقليمية أو شرائح العمليات ذات المعنى عندما تستطيع نسبة عامة إخفاء ضرر مركز. ينفذ هذا الدرس حساباً ثابتاً فقط؛ ولا يصل إلى محرك استعلام أو مقيّم قواعد أو مصدر بيانات أو خدمة مراقبة. تبقى قيود التعبير غير المنفذ ظاهرة، بدلاً من الادعاء بأنه نتيجة اعتمادية مقاسة.
الأخطاء الشائعة وإصلاحها
نسبة الخدمة متوسط نسب المثيلات.
- لماذا يحدث؟
- أُعطيت حركة متفاوتة أوزاناً متساوية.
- كيف تصلحه؟
- اجمع الأعداد أو المعدلات المتوافقة قبل القسمة.
- كيف تتجنب تكراره؟
- احفظ عينة بحركة غير متساوية.
تجزئ تسمية جديدة تجميع without.
- لماذا يحدث؟
- تغيرت الأبعاد المحتفظ بها دون مراجعة.
- كيف تصلحه؟
- قارن عقد التجميع بالتسميات الجديدة.
- كيف تتجنب تكراره؟
- اختبر إضافة التسميات وحذفها.
يصبح كل فراغ صفراً سليماً.
- لماذا يحدث؟
- اختلط غياب المصدر بعدم الأخطاء.
- كيف تصلحه؟
- عرّف سياستي الغياب وانعدام الحركة مستقلتين.
- كيف تتجنب تكراره؟
- تحقق من اكتمال الجمع مع النسبة.
اختبر فهمك
1. لماذا يمكن حساب متوسط نسب خطأ منطقتين متطابقتين دون تغيير الإجابة في هذه الحالة بالذات؟
اعرض الحل المشروح
تنتج النسب المتساوية المتوسط والنسبة المجمعة نفسيهما، ولذلك لا تكشف تلك العينة أخطاء الوزن. لا يبرر التصادف الطريقة عند اختلاف النسب وحجم الحركة. استخدم حالة متفاوتة عمداً لحماية العقد الموزون بالأحداث، واحتفظ بنطاق المنطقة عندما يهم أثرها على المستخدمين.
2. ما الذي يجب التحقق منه قبل إضافة تعبير بديل باستخدام or إلى نسبة تعيد نتيجة فارغة؟
اعرض الحل المشروح
حدد سبب الفراغ، ومجموعة التسميات المفترض وجودها، ووجود حركة مؤهلة، وسلامة تغطية المصدر. قد يغير البديل المطابقة ويخفي فقد الأدلة. عرّف واختبر نتائج لا أخطاء ولا حركة ومصدر مفقود بدقة، بدلاً من استعمال صفر لتحسين مظهر اللوحة.
أهم ما تعلمته
- التجميع جزء من عقد المجموعة.
- اجمع المعدلات المتوافقة قبل حساب نسب الأحداث.
- يجب أن يحفظ التعامل مع الغياب عدم يقين القياس.