recording rules Prometheus: كتابة القواعد وتسميتها (level:metric:operations)

recording rules Prometheus: اكتب ملف قواعد، وطبّق تسمية level:metric:operations، واختبره بأداة promtool قبل النشر لتسريع لوحات المراقبة.
Recording rules Prometheus : écrire et nommer vos règles (level:metric:operations)

تحسب recording rules Prometheus مسبقًا تعبير PromQL على فترات منتظمة وتحفظ النتيجة في سلسلة جديدة. فتقرأ لوحة المراقبة أو التنبيه هذه السلسلة الجاهزة بدل إعادة حساب تجميع مكلف عند كل عرض. يوضح هذا المقال كيف تكتب هذه القواعد، وكيف تسمّيها وفق الاصطلاح level:metric:operations، وكيف تختبرها بأداة promtool وتراجعها بمنهج SRE.

تظهر الحاجة سريعًا: مؤشر SLI لمعدل الأخطاء محسوب على مئات النسخ، ومعروض في عشر لوحات، ومُقيَّم بثلاثة تنبيهات، يكرر العمل نفسه عشر مرات. تنجزه قاعدة التسجيل مرة واحدة، باسم يفهمه الفريق كله. ويكمّل هذا الموضوع جمع مقاييس Prometheus على Kubernetes الذي يعالج الاستيعاب لا الحساب.

باختصار

  • الـ recording rule زوج من record (اسم السلسلة الجديدة) وexpr (تعبير PromQL)، داخل مجموعة تُقيَّم على فترة ثابتة.
  • اصطلاح التسمية الرسمي هو level:metric:operations: مستوى التجميع، ثم المقياس الأصلي، ثم العمليات المطبقة.
  • يُجمَّع البسط والمقام دائمًا كلًا على حدة ثم يُقسَّمان؛ ولا يُؤخذ متوسط لنسبة أبدًا.
  • يتحقق promtool check rules من الصياغة، ويتحقق promtool test rules من النتائج على سلاسل مصطنعة.

لماذا نستخدم recording rules Prometheus

يمر استعلام مثل sum(rate(http_requests_total[5m])) على كل السلاسل المعنية عند كل تنفيذ. وعلى عنقود Kubernetes مزدحم، تكفي بضع عشرات من اللوحات التي تكرره لإبطاء الواجهة. أما الحساب المسبق مرة كل دقيقة فينقل الكلفة إلى نقطة واحدة متوقعة وقابلة للقياس.

الفائدة تنظيمية أيضًا. فاسم ثابت مثل path:http_requests:rate5m يصبح عقدًا: تعتمد التنبيهات ولوحات المراقبة وتقارير SLO التعريف نفسه لحركة المرور. وهذا يقلل من toil المراجعة ومن التباين بين شاشتين لا تعرضان الرقم نفسه. ولتحديد موقع Prometheus مقارنة بـ OpenTelemetry، راجع OpenTelemetry مقابل Prometheus.

بنية ملف القواعد

وفق وثائق Prometheus، ملفات القواعد بصيغة YAML وتُحمَّل عبر الحقل rule_files في الضبط. تحمل المجموعة name إلزاميًا وفريدًا داخل الملف، وinterval اختياريًا (القيمة الافتراضية global.evaluation_interval)، وقائمة rules. وتحتوي recording rule على record، وهو اسم مقياس صالح، وexpr، وهو تعبير PromQL، وlabels اختيارية تُضاف أو تُستبدل في كل نتيجة مخزَّنة.

هذا ملف من ثلاث قواعد يحسب حركة المرور والإخفاقات ونسبة الإخفاق لكل مسار.

ملف rules.yml: ثلاث recording rules هي path:http_requests:rate5m وpath:http_request_failures:rate5m ونسبة الإخفاق
groups:
  - name: http_requests
    interval: 1m
    rules:
      - record: path:http_requests:rate5m
        expr: sum without (instance, status) (rate(http_requests_total[5m]))
      - record: path:http_request_failures:rate5m
        expr: sum without (instance, status) (rate(http_requests_total{status=~"5.."}[5m]))
      - record: path:http_request_failures_per_requests:ratio_rate5m
        expr: path:http_request_failures:rate5m / path:http_requests:rate5m

المقياس http_requests_total وlabels الخاصة به (instance وpath وstatus) مثال من المقال هنا، وليست مقياسًا تفرضه Prometheus. وتعيد النسبة استخدام اسمي القاعدتين الأوليين، ما يُبقي تعبيرها مقروءًا.

التسمية باستخدام level:metric:operations

تصف صفحة Recording rules ضمن ممارسات Prometheus الجيدة الشكل العام level:metric:operations.

  1. level: مستوى التجميع، أي labels الخرج. هنا path.
  2. metric: اسم المقياس دون تغيير، عدا حذف _total من العدّادات المستخدمة مع rate() أو irate(). هنا يصبح http_requests_total هو http_requests.
  3. operations: قائمة العمليات المطبقة، الأحدث أولًا. هنا rate5m.

تضيف الصفحة نفسها بعض القواعد: عند عدم وجود عملية واضحة تُستخدم sum؛ ولنسبة تُفصل المقياسان بـ _per_ وتُسمّى العملية ratio، ومن هنا path:http_request_failures_per_requests:ratio_rate5m. ويمكن دمج العمليات التجميعية: يُكتب min_min على هيئة min.

التجميع بـ without بدل by

توصي الوثائق باستخدام عبارة without دائمًا، مع سرد labels المحذوفة، للإبقاء على labels مثل job. ولا ينبغي أن يختلف مستوى الخرج عن مستوى الدخل إلا بالـ labels المحذوفة: فإذا لم يتطابق المستويان فهذه علامة خطأ. وتذكّر البادئة path في اسم القاعدة بالـ labels التي تبقى إلى جانب job.

لا تأخذ متوسط نسبة أبدًا

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

اختبار القواعد بأداة promtool

قبل أي نشر، تحقق من الملف دون تشغيل أي خادم:

promtool check rules rules.yml

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

وللتحقق من القيم، تصف صفحة Unit testing for rules الأمر promtool test rules test.yml. يعلن ملف الاختبار القواعد المراد تحميلها وسلاسل الدخل والعينات المتوقعة. ويولّد الترميز 0+90x10 سلسلة تبدأ من 0 ثم تزيد 90 في كل خطوة من الخطوات العشر.

ملف test.yml لأمر promtool test rules: سلاسل الدخل http_requests_total والعينات المتوقعة عند 10 دقائق

القيم المتوقعة (3,5 طلب في الثانية إجمالًا، و0,5 منها فاشل) ناتجة عن حساب يدوي: 90 طلبًا في الدقيقة لكل نسخة ناجحة، أي 1,5 في الثانية، ونسختان، إضافة إلى 12 و18 في الدقيقة بخطأ. لم يُنفَّذ هذا الملف من أجل هذا المقال: شغّله لديك وصحّح القيمة المتوقعة إذا كان إصدار Prometheus لديك يستكمل القيم بطريقة أخرى.

إعادة تحميل القواعد ومراقبتها

لإعادة تحميل الملفات مباشرة، تشير الوثائق إلى إرسال SIGHUP إلى عملية Prometheus؛ ولا تُطبَّق التغييرات إلا إذا كانت كل ملفات القواعد سليمة التكوين. وثمة نقطة انتباه تخص الموثوقية: إذا لم تنهِ مجموعة تقييمها قبل التقييم التالي، يُتخطى هذا الأخير وتظهر فجوة في السلسلة المسجَّلة. ويزداد العدّاد rule_group_iterations_missed_total مع كل تكرار فائت. أنشئ تنبيهًا عليه، لأن SLI ذا فجوات يشوّه استهلاك error budget. وللاطلاع على SLO، راجع مقارنة SLO مع Prometheus.

ممارسات جيدة

  • مجموعة لكل موضوع (حركة المرور، زمن الاستجابة، التشبع) وinterval مناسب لنافذة الاستعلام.
  • اسم مطابق لـ level:metric:operations لكل قاعدة، دون اختصارات خاصة.
  • اختبارات promtool test rules في المستودع، تُنفَّذ في CI مع check rules.
  • قواعد قليلة، موجَّهة إلى الاستعلامات الثقيلة والمعاد استخدامها: فكل قاعدة تنشئ سلاسل جديدة تُخزَّن.
  • تنبيه على التقييمات الفائتة.

الأسئلة الشائعة

ما الفرق بين recording rule وalerting rule؟

كلتاهما تعيش في مجموعة قواعد. تخزّن recording rule نتيجة تعبير في سلسلة جديدة؛ أما alerting rule فتقيّم شرطًا وتطلق تنبيهات. ويمكن لتنبيه أن يعتمد على سلسلة مسجَّلة.

هل يجب أن أتبع اصطلاح التسمية؟

لا تفرضه Prometheus: يقبل record أي اسم مقياس صالح. يأتي الاصطلاح من الممارسات الرسمية الجيدة ويجعل السلاسل مقروءة بنظرة واحدة، وهذا مهم أثناء المناوبة.

هل يمكن استخدام هذه السلاسل مع OpenTelemetry أو Dynatrace؟

تبقى السلسلة المسجَّلة مقياس Prometheus عاديًا. ولنقلها إلى منصة أخرى، اتبع الطريقة الموصوفة في هذا المقال عن Prometheus وKubernetes وتحقق في وثائق المنصة المستهدفة من معاملة العدّادات وgauges. أما القواعد نفسها فتبقى Prometheus هي من يقيّمها.

الخلاصة

تنقل recording rules Prometheus التجميعات المكلفة بعيدًا عن لوحات المراقبة وتمنح مؤشرات SLI اسمًا ثابتًا. طبّق level:metric:operations، وجمّع بـ without، واقسم بعد التجميع، واختبر بـ promtool، وراقب التكرارات الفائتة. ويرد الفرق بين قابلية الملاحظة والمراقبة البسيطة، وهو ما يحفّز هذا العمل على SLI، في هذا المقال.

span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC. Dynatrace علامة تجارية لشركة Dynatrace LLC. Prometheus مشروع تابع لمؤسسة Cloud Native Computing Foundation. تحقق دائمًا من القيم (المنافذ والإصدارات والأحجام) في الوثائق الرسمية الخاصة بإصدارك.

Total
0
Shares
Leave a Reply

Your email address will not be published. Required fields are marked *

Previous Post
Alerte logs Dynatrace : créer l'alerte et réduire le bruit

تنبيه سجلات Dynatrace: إنشاؤه وتخفيض الضجيج

Next Post
Fidélité RAG : évaluer un RAG et comprendre les limites de la métrique

أمانة RAG: تقييم نظام RAG وفهم حدود المقياس

Related Posts