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

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

قواعد التسجيل وعقود السلاسل المشتقة

صمم قاعدة التسجيل كقياس مشتق محفوظ ذي نسخة، مع تجميع ودورية تقييم واعتماديات وتوقعات مستهلك صريحة.

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

أهداف الدرس

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

تنشئ قاعدة التسجيل عقد قياس آخر

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

اقرأ القاعدة كواجهة ذات معنى ونطاق

يسجل مقطع YAML غير التنفيذي معدل طلبات بحسب العملية للمهمة الافتراضية. يتبع الاسم المفصول بالنقطتين اصطلاحاً وصفياً، ولا يفرض صحة التجميع. فاصل القاعدة ثلاثون ثانية للتوضيح، وهو مستقل عن مدى rate داخلها. يدخل المحدد والتسميات الباقية والنافذة والوحدة في المراجعة. قد تستبدل تسمية قاعدة تسمية من الناتج؛ فعامل المضاف تغيراً دلالياً لا زينة. لا يُحمّل المقطع في خادم ولا يدعي نجاح promtool.

yaml قاعدة تسجيل تعليمية لـPrometheus v3.5.0
groups:
  - name: warehouse-lab-rates
    interval: 30s
    rules:
      - record: operation:warehouse_requests:rate5m
        expr: sum by (operation) (rate(warehouse_requests_total{job="warehouse-lab"}[5m]))

يحفظ التعبير طلبات في الثانية بحسب العملية. يظل الإعداد والجدولة وتقييم الاستعلام سلوك منصة غير مختبر.

افحص شكل التسميات بقيم ثابتة

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

python عينة محلية لشكل التسميات المشتقة
source_rates = [("lookup", "a", 2.0), ("lookup", "b", 3.0), ("reserve", "a", 2.0)]
recorded = {}
for operation, instance, rate_value in source_rates:
    recorded[operation] = recorded.get(operation, 0.0) + rate_value
for operation in sorted(recorded):
    print(operation, recorded[operation])
الناتج المتوقع
lookup 5.0
reserve 2.0

المدخلات معدلات منمذجة مسبقاً. يفحص النص الجمع والأبعاد فقط، دون عدادات أو أوقات أو PromQL أو مجدول قواعد.

أظهر اعتماديات القاعدة وحداثتها

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

راجع التكلفة والتوافق وإيقاف القواعد

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

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

تطبق rate على معدل مسجل في الثانية.

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

يكسر تغيير اسم القاعدة كل تنبيه.

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

يُفترض ترتيب اعتماد للمجموعات المنفصلة.

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

اختبر فهمك

1. تجمع قاعدة تسجيل بحسب operation وتحذف instance. هل يستطيع استعلام لاحق استعادة معدل كل مثيل منها؟

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

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

2. ماذا ينبغي أن تشمل مراجعة قاعدة التسجيل إلى جانب قبول محلل الصياغة للتعبير؟

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

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

أهم ما تعلمته

  • تحفظ قواعد التسجيل قياسات مشتقة ذات نسخ.
  • تسميات المخرج ووحداته عقود للمستهلك.
  • تحتاج الاعتماديات وسلامة التقييم مراجعة صريحة.

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