Prometheus / الأساسي: الجمع ومعنى السلاسل الزمنية / الدرس 1
نموذج السحب وحدود القياس
تتبع المقياس من هدف مرصود عبر الجمع والتخزين وتقييم الاستعلام، مع تمييز دليل المراقبة من عملية المستخدم نفسها.
في هذه الصفحة
أهداف الدرس
- اشرح أدوار الهدف وعملية الجمع والعينة والاستعلام.
- افصل إمكان الوصول إلى العملية عن نجاح المستخدم.
- بيّن نسخة المرجع الثابتة وحدود الأدلة المحلية.
تتبع العينة لا رسم المنتج
يكتشف Prometheus عادة الأهداف، ويجلب مقاييسها المعروضة دورياً، ويحفظ السلاسل الزمنية، ويقيّم استعلامات PromQL أو القواعد. يحدد الرصد معنى القيم؛ ولا يستنتج الخادم صحة العمل من رقم. تعرض واجهة مستودع افتراضية أعداد الطلبات المقبولة والفاشلة. وقد يترجم exporter مشاهدات نظام آخر إلى نقطة عرض، لكن الترجمة تضيف حداً واحتمال فشل مستقلين. ارسم المصدر ونقطة العرض والجالب والتخزين والمستهلك منفصلة، لتعرف هل يعكس الرسم المفقود غياب عمل التطبيق أو فشل الجمع أو استعلاماً اختار سلسلة خاطئة.
الجمع الناجح مشاهدة واحدة
يعني الجمع الناجح أن نظام المراقبة حصل على استجابة مقبولة عند حد الجمع. ولا يثبت نجاح مصادقة مستخدمي المستودع أو صحة المخزون أو اكتمال الكتابة. وقد يفشل الجمع والتطبيق يخدم المستخدمين. احتفظ بنتائج الخدمة وسلامة الجمع كدليلين مختلفين. يسمي السجل الحدود دون نقطة شبكة. ينبغي أن يملك فريق الخدمة عقد مقياس العمل، وتشمل ملكية المراقبة سلامة الجمع والقواعد. وتحتاج المسؤولية المشتركة جهات اتصال وتصعيداً صريحين في المؤسسة الفعلية.
measurement_design: warehouse-api
source: application-instrumentation
collection_boundary: metrics-exposition-response
user_boundary: eligible-api-operation-outcome
separate_health: [collection, storage, rule-evaluation, user-success]
reference_baseline: Prometheus-v3.5.0
الخريطة ليست إعداد Prometheus. تفصل الجمع التقني من نتائج المستخدم، ولا تقدم عنواناً أو بيانات اعتماد.
افهم الرصد الدوري
يرصد الجمع الحالة المعروضة عند أوقات منفصلة. قد تتغير قيمة gauge بين المشاهدات دون حفظ كل قيمة وسيطة؛ وقد يحفظ counter الزيادات المتراكمة إذا استمرت العملية وصح الرصد. تشاهد العينة المحلية مقياساً متغيراً عند ثلاث لحظات مختارة، ويقل أقصى المرصود عن أقصى التسلسل الافتراضي الكامل. يوضح ذلك حد أخذ المشاهدات، لا عيباً في Prometheus. اختر دورية الجمع وفق فائدة الدليل وتكلفة المصدر والقيود، ولا تدّع أن تقصير الفاصل يضمن رؤية كل حدث عابر.
gauge_by_second = {0: 2, 1: 9, 2: 3, 3: 2, 4: 4}
scrape_times = [0, 2, 4]
observed = [gauge_by_second[t] for t in scrape_times]
print("observed", observed)
print("observed_max", max(observed))
print("full_sequence_max", max(gauge_by_second.values()))
observed [2, 3, 4]
observed_max 4
full_sequence_max 9تُختار قيم قاموس ثابت فقط. لا تُجمع نقطة فعلية ولا يعمل خادم Prometheus؛ وتوضح النتيجة قمماً قد لا تُرى.
افصل البيانات والاستعلام والإشعار
العينات المحفوظة ونتيجة الاستعلام المشتقة وقاعدة التسجيل وحالة التنبيه والإشعار الموصل أشياء مختلفة. قد تنجح القاعدة ولا تختار سلاسل، وقد يطلق التنبيه ولا يصل للمستلم. احفظ تعريف المقياس وملكيته عبر الطبقات. لا تصلح الألوان بسطاً خاطئاً. حدد أثناء التشخيص ادعاء الطبقة المختبر قبل فحص غيرها؛ حتى لا تُعرض سلامة واجهة الاستعلام دليلاً على سلامة كل جامع وقاعدة ورحلة مستخدم.
استخدم مرجع تعلم ثابتاً بصدق
تثبت الدورة مراجع الصياغة عند مستودع Prometheus v3.5.0 الرسمي وAlertmanager v0.28.1 حيث يلزم، دون ادعاء أنهما الأحدث أو مناسبان للنشر اليوم. تحقق من سلوك النسخة المثبتة ودعمها قبل تكييف مقطع. كل PromQL وصيغ العرض والإعداد أمثلة تعليمية غير تنفيذية. تختبر عينات بايثون الحساب أو التصنيف المنمذج فقط، ولا تتحقق من تفاوض الجمع أو ديمومة التخزين أو محرك الاستعلام أو الأداء. فهم هذه الحدود جزء من تعلم النظام، وليس إذناً بخلط المثال بنتيجة تشغيلية.
الأخطاء الشائعة وإصلاحها
يُعلن نجاح الجمع سلامة رحلة المستخدم.
- لماذا يحدث؟
- اختلط الجمع بنتائج العمل.
- كيف تصلحه؟
- قس عمليات المستخدم المؤهلة مستقلة.
- كيف تتجنب تكراره؟
- وثق حدي الرصد معاً.
لا تظهر قمة قصيرة لمقياس حالي.
- لماذا يحدث؟
- تغيرت القيمة بين المشاهدات المنفصلة.
- كيف تصلحه؟
- راجع هل يجيب توزيع أو عداد أحداث السؤال.
- كيف تتجنب تكراره؟
- طابق الأداة والدورية مع الحاجة التشخيصية.
يسمى إطلاق القاعدة استدعاءً موصلاً.
- لماذا يحدث؟
- عومل التقييم والإشعار خطوة واحدة.
- كيف تصلحه؟
- تحقق من كل طبقة ومالكها مستقلة.
- كيف تتجنب تكراره؟
- افصل أدلة القاعدة والتوصيل.
اختبر فهمك
1. تستجيب نقطة عرض المقاييس، لكن مستخدمي المستودع يتلقون بيانات مخزون خاطئة. ما الذي تثبته استجابة نقطة المقاييس تحديداً؟
اعرض الحل المشروح
لم يثبت إلا إمكان الوصول للجمع عند هذا الحد، وفق شروط نجاح الجمع الفعلية. أضف أدلة عن نتائج عمليات المستخدم وصحة بياناتها أو افحصها إن كانت موجودة. لا توسع معنى سلامة الجمع كي يشمل وعداً لم يُصمم لقياسه.
2. هل يستطيع نموذج بايثون المعروض إثبات أن فاصل جمع مقداره ثانية واحدة يكفي للغرض التشخيصي؟
اعرض الحل المشروح
لا. يوضح تسلسلاً ثابتاً واحداً للمشاهدات، ولا يتضمن تكلفة المصدر أو تأخر الجدولة أو الشبكة أو حملاً عابراً فعلياً. اختر الفاصل من سؤال القياس والأدلة المخولة في البيئة المناسبة. قد يحفظ عداد أو مدرج معلومات لا تستطيع لقطات gauge المتكررة الاحتفاظ بها.
أهم ما تعلمته
- اربط كل ادعاء بحد المشاهدة الذي يسنده.
- ليس الجمع الدوري سجلاً لكل حالة وسيطة.
- للمراجع الثابتة والنماذج المحلية حدود صريحة.