الاستعلام باستخدام PromQL

تعرض لوحة المراقبة نسبة أخطاء قدرها 0.3%، بينما تبلغ النسبة الفعلية في الخدمة 4%. لا يحتوي الاستعلام على أي خطأ في الصياغة، وينفّذه Prometheus دون أي تحذير، والرقم المعروض خاطئ منذ لحظة إنشائه. والسبب حرف واحد: نافذة rate أقصر من فترة الجمع، فلا تجد العبارة نقاطًا كافية لحساب أي شيء في نصف السلاسل. لا تحميك PromQL من هذا النوع من الأخطاء، إذ لا توجد رسالة تحذير لاستعلام صالح تقنيًا لكنه بلا معنى دلاليًا.

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

التحديد

يعيد المحدِّد (selector) متجهًا لحظيًا (instant vector): قيمة واحدة لكل سلسلة مطابقة، عند لحظة التقييم.

# جميع السلاسل التي تحمل هذا الاسم.
http_requests_total