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

Prometheus / الأساسي: الجمع ومعنى السلاسل الزمنية / الدرس 5

المحددات والمتجهات ووقت التقييم

اقرأ المحددات الآنية ومحددات المدى كعقود للمجموعة والوقت، مع مطابقة التسميات وغيابها والفرق بين مدى التقييم ومدى البيانات.

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

أهداف الدرس

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

ابدأ بنوع نتيجة التعبير

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

اقرأ كل شرط كقاعدة تأهيل

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

promql محددان تعليميان آني وذو مدى
warehouse_requests_total{job="warehouse-lab",operation=~"lookup|reserve"}
warehouse_requests_total{job="warehouse-lab",operation="lookup"}[5m]

الأول محدد متجه آني والثاني محدد متجه مدى. كلاهما PromQL غير منفذ، ولا يمثلان نتائج استعلام مقاسة.

قد تختلف لحظة العينة عن التقييم

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

python نموذج محلي مبسط للرجوع الزمني
samples = [(0, 4), (10, 7)]
def latest_within(evaluation, max_age):
    eligible = [(t, value) for t, value in samples if t <= evaluation and evaluation - t <= max_age]
    return max(eligible)[1] if eligible else None
print(latest_within(12, 5))
print(latest_within(20, 5))
الناتج المتوقع
7
None

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

وحّد حدود المدى مع السؤال

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

اختبر المجموعة قبل تعقيد التعبير

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

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

يُعد مدى اللوحة بديلاً عن محدد المدى.

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

يضم النفي بيانات بلا تسمية.

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

يُعلن الخط الثابت جمعاً حديثاً.

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

اختبر فهمك

1. لماذا يظل تعبير المعدل بحاجة إلى [5m] عندما تعرض لوحة المتابعة بيانات يوم كامل؟

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

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

2. ارتفعت نتيجة استعلام يستخدم outcome!="error" بعد نشر أغفل تسمية outcome. ما الذي ينبغي فحصه قبل تفسير الارتفاع؟

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

افحص هل أصبحت السلاسل التي تغيب عنها التسمية تحقق المطابقة السلبية وتوسع البسط. قارن عقدي التسميات القديم والجديد والنتائج المؤهلة الصريحة. لا تصف التغير بأنه تحسن في الاعتمادية حتى تستعيد المجموعة والمعنى نفسيهما أو تنقلهما عمداً.

أهم ما تعلمته

  • يحدد المحدد المجموعة والوقت معاً.
  • يختلف تقييم المدى عن مدخل متجه المدى.
  • يحتاج غياب التسميات والعينات الحديثة نسبياً تفسيراً صريحاً.

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