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

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

السلاسل الزمنية والتسميات والهوية

عرّف السلسلة بمجموعة تسمياتها الكاملة، واشرح لماذا ينشئ تغيير الأبعاد تاريخاً جديداً بدلاً من تعديل سلسلة قائمة في مكانها.

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

أهداف الدرس

  • حدد اسم المقياس وتسمياته وطوابعه الزمنية وقيمه.
  • ميّز هوية السلسلة من الاسم المعروض للمستخدم.
  • اختر أبعاداً محدودة تحفظ المقارنات المفيدة.

تحدد مجموعة التسميات الكاملة السلسلة

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

اقرأ العرض إعلاناً للهوية

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

text مقطع عرض افتراضي لسلسلتين
warehouse_requests_total{operation="lookup",outcome="ok"} 120
warehouse_requests_total{operation="lookup",outcome="error"} 3

تفصل قيم التسميات النجاح والفشل. المقطع التعليمي غير الكامل لا يُجمع ولا يُفحص بمحلل Prometheus.

نمذج الهوية دون الاعتماد على الترتيب

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

python نموذج محلي لهوية التسميات
def identity(labels):
    return tuple(sorted(labels.items()))
a = {"__name__": "warehouse_requests_total", "outcome": "ok"}
b = {"outcome": "ok", "__name__": "warehouse_requests_total"}
c = {"__name__": "warehouse_requests_total", "outcome": "error"}
print(identity(a) == identity(b))
print(identity(a) == identity(c))
الناتج المتوقع
True
False

تقارن الدالة أزواجاً ثابتة فقط. لا تحسب بصمة سلاسل Prometheus أو تحلل العرض أو تنفذ قواعد التسميات المحجوزة.

اختر الأبعاد لسؤال محدد

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

عامل تغير التسميات كتغير عقد

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

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

يُعد تغيير ترتيب التسميات خدمة جديدة.

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

ينشئ كل طلب سلسلة جديدة.

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

تبدو إعادة التسمية تحسناً مفاجئاً في الاعتمادية.

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

اختبر فهمك

1. تملك عينتان التسميات نفسها تماماً باستثناء قيمة instance. هل تنتميان إلى سلسلة زمنية واحدة؟

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

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

2. هل ينبغي إضافة معرف عنصر المستودع كتسمية مقياس لتسهيل استكشاف مشكلة تخص عنصراً معيناً؟

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

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

أهم ما تعلمته

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

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