لا تظهر كاردينالية المقاييس في لوحة المراقبة، بل في فاتورة الشهر التالي، أو في خادم Prometheus يعيد التشغيل مرارًا بسبب نفاد الذاكرة. يبدأ هذا الدليل من قرار تشغيلي محدد: قبل أن ينشر فريق مقياسًا جديدًا، ماذا ينبغي أن يفحص؟ وكيف يكتشف سلسلة زمنية تنفجر وهي في الإنتاج بالفعل؟
تقوم الطريقة على أربع خطوات: تقدير حجم المقياس قبل تسليمه، وتدقيق كتلة بيانات بأداة promtool، والتنبيه على معدل إنشاء السلاسل، ثم وضع سقف عند المصدر داخل حزمة OpenTelemetry SDK. وهي تكمّل دليل كاردينالية مقاييس Kubernetes المخصص لواجهة TSDB وkube-state-metrics، ولا تكرره.
باختصار
- عدد سلاسل المقياس لا يتجاوز حاصل ضرب عدد القيم الممكنة لكل وسم (label)، ويُحسب قبل الوصول إلى الإنتاج.
- تدقق
promtool tsdb analyzeكتلة بيانات دون اتصال وترتّب الوسوم الأكثر كلفة. - تتيح
scrape_series_addedالتنبيه على السلاسل الجديدة، وتختبرpromtool test rulesالتنبيه دون خادم. - تستطيع حزمة OpenTelemetry SDK تصفية السمات (
attribute_keys) وتحديد عدد النقاط، مع نقطة للفائض.
حساب كاردينالية المقاييس قبل مراجعة الشيفرة
توصي وثائق Prometheus الخاصة بممارسات الأدوات القياسية بإبقاء كاردينالية المقياس دون 10، وإذا زادت عن ذلك فليكن في حفنة قليلة من المقاييس في النظام كله. وإذا تجاوز المقياس 100 فتقترح البحث عن حل آخر. هذه مؤشرات وليست محظورات، لكنها تعطي رتبة حجم مفيدة أثناء المراجعة.
الحساب بسيط. مقياس بالوسوم route (4 قيم) وstatus (3 قيم) وuser_id (1000 قيمة) قد يبلغ 4 × 3 × 1000 = 12000 سلسلة. الوسم الثالث وحده يصنع الكلفة كلها. لذلك أضف سؤالًا إلى قالب طلب الدمج (pull request): ما القيم الممكنة لكل وسم، وما الذي يحدّ عددها؟
صفحة التسمية في Prometheus صريحة: لا تخزّن في الوسوم أبعادًا عالية الكاردينالية مثل معرّفات المستخدمين أو عناوين البريد الإلكتروني. مكان المعرّف هو التتبع أو السجل، لا المقياس.
تدقيق كتلة بيانات بأداة promtool tsdb analyze
تستعلم واجهة حالة TSDB من الخادم العامل. أما promtool فتقدم الخيار الآخر: تحليل مجلد بيانات، مثل نسخة من كتلة أُخذت من خادم أو لقطة منه، دون تحميل الإنتاج. اسم الأمر tsdb analyze ووصفه الرسمي «Analyze churn, label pair cardinality and compaction efficiency».
ولكي يكون المثال قابلًا للتكرار، أعددت مجموعة بيانات مخبرية: مقياس http_requests_total فيه 12 سلسلة سليمة (4 مسارات و3 حالات) و400 سلسلة تحمل وسمًا إضافيًا هو user_id. يُحوَّل ملف OpenMetrics إلى كتل ثم يُحلَّل.
promtool tsdb create-blocks-from openmetrics m.om ./db
promtool tsdb analyze ./db

يُقرأ الناتج من الأسفل إلى الأعلى. يشير «Highest cardinality metric names» إلى المقياس المتسبب، و«Highest cardinality labels» إلى الوسم (هنا user_id بـ 400 قيمة مقابل 4 لـ route)، و«Label names with highest cumulative label value length» إلى مكان ذهاب الذاكرة، لأن طول القيم يُحسب أيضًا. ويتضمن الناتج نفسه «Label pairs most involved in churning» المفيد لاكتشاف قيم تولد وتموت باستمرار. في مجموعتي كل شيء يساوي 0: البيانات مستقرة، وهذا لا يحدث في عنقود يُعاد نشره كثيرًا.
اكتشاف السلاسل المنفجرة بمقياس scrape_series_added
لا يكفي تدقيق واحد في وقت ما، فالانفجار يأتي بعد نشر جديد، يوم خميس في الخامسة مساءً. يولّد Prometheus سلاسل تشخيصية عند كل عملية جمع (scrape). وبحسب وثيقة «Jobs and instances»، فإن scrape_series_added هو العدد التقريبي للسلاسل الجديدة في تلك العملية، وscrape_samples_scraped عدد العينات التي يعرضها الهدف، وscrape_samples_post_metric_relabeling العينات المتبقية بعد إعادة الوسم.
المهمة السليمة تنشئ سلاسل جديدة قليلة في كل عملية جمع، إلا أثناء إعادة النشر. وتنبيه على هذه الإشارة ينذر قبل أن تمتلئ الذاكرة:
groups:
- name: cardinalite
rules:
- alert: SeriesNouvellesParScrape
expr: scrape_series_added > 500
for: 10m
labels:
severity: warning
العتبة 500 مجرد مثال، فقِس المستوى الطبيعي لمهامك قبل تحديدها. ثم اختبر القاعدة دون خادم بملف اختبار يحقن القيم:

يحقن الاختبار السلسلة scrape_series_added بقيمة 10 خمس دقائق، ثم بقيمة 900، ويتحقق من أن التنبيه فعّال بعد 30 دقيقة. التنبيه الذي لم يُختبر قط مجازفة، خصوصًا مع شرط for.
تحديد سقف لكاردينالية المقاييس عند المصدر مع OpenTelemetry
التصحيح داخل Prometheus ردّ فعل متأخر. أما OpenTelemetry SDK فيسمح بالقرار قبل التصدير. تعرّف مواصفة حزمة المقاييس حدًّا لكاردينالية التجميع: إذا لم تُحدَّد قيمة أخرى استُخدم الرقم 2000. وما بعده تذهب القياسات إلى مجموعة فائض تحمل السمة المنطقية otel.metric.overflow بالقيمة true. ويمكن لـ View أن تضبط aggregation_cardinality_limit لأداة قياس، أو تصفّي السمات بـ attribute_keys. وبحسب المواصفة يُطبَّق الحد بعد التصفية، فالتصفية أولًا تتجنب بلوغ السقف.
تحققت من السلوك بحزمة Python (opentelemetry-sdk 1.45.2): عدّاد يتلقى 3000 قياس، لكل منها سمة user.id مختلفة.
View(instrument_name="app.requests", attribute_keys={"http.route"})
View(instrument_name="app.requests", aggregation_cardinality_limit=100)

دون View نحصل على 2001 نقطة: الحد الافتراضي 2000 زائد نقطة الفائض. ومع attribute_keys تبقى نقطة واحدة تجمع كل القياسات (3000). ومع حد 100 نحصل على 101 نقطة، وتجمع نقطة الفائض 2900 قياس المتبقية. أي أن الفائض لا يفقد الإجمالي بل يفقد التفصيل. السقف يحدّ من الضرر، لكن حذف السمة وحده يحل المشكلة. لم أتحقق من هذه الخيارات في اللغات الأخرى، فتوافرها يختلف بحسب الحزمة.
ولوضع المنظومتين إحداهما بالنسبة للأخرى، راجع OpenTelemetry وPrometheus: أداتان متكاملتان.
ممارسات جيدة: حارس مراجعة في خمسة أسطر
- اذكر في طلب الدمج القيم الممكنة لكل وسم واضرب بعضها ببعض.
- ارفض أي معرّف (مستخدم، طلب، جلسة) وسمًا أو سمةً في مقياس.
- ضع
sample_limitعلى المهام، مع العلم أن تجاوزه يُفشل عملية الجمع كلها. - نبّه على
scrape_series_addedواختبر القاعدة بـpromtool test rules. - أعد تشغيل
promtool tsdb analyzeكل ثلاثة أشهر على كتلة حديثة.
ينطبق المنطق نفسه على السجلات: يصف مقال الوسوم والكاردينالية في Loki المكافئ في فهرس السجلات، ويبيّن مقال مقاييس Datadog المخصصة كيف يحسب مزوّد تجاري الفاتورة. أما من جهة التشغيل، فإن التنبيه على العقد وPods والحصص موضوع مستقل.
المصادر: ممارسات الأدوات القياسية في Prometheus، مواصفة حزمة المقاييس في OpenTelemetry.
الأسئلة الشائعة
ما الكاردينالية المقبولة لمقياس؟
تعطي وثائق Prometheus مؤشرات: أقل من 10 قيم للمقياس، وقلة من المقاييس فوق ذلك، ومراجعة الأبعاد بعد 100. والعتبة الصحيحة تتوقف على ميزانية السلاسل لديك، وهي ما يجب قياسه.
ماذا يحدث عند بلوغ حد OpenTelemetry SDK؟
تُجمَّع تركيبات السمات الجديدة في نقطة واحدة تحمل otel.metric.overflow=true. يبقى الإجمالي صحيحًا، لكن يضيع التفصيل بحسب السمات لتلك القياسات.
هل ينبغي استخدام sample_limit للحماية؟
هو شبكة أمان مفيدة لكنه حاد: بحسب الوثائق، إذا تجاوز عدد العينات بعد إعادة الوسم الحد عُدّت عملية الجمع كلها فاشلة. الأفضل الجمع بينه وبين التنبيه على السلاسل الجديدة.
الخلاصة
إتقان كاردينالية المقاييس يعني تبكير الرقابة: الحساب في المراجعة، والتدقيق بـ promtool، والتنبيه على معدل الإنشاء، ووضع السقف في SDK. المخرجات المعروضة من مجموعة مخبرية وليست بيئة إنتاج، فأعد القياس على بياناتك قبل تحديد عتباتك.
span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC. Dynatrace علامة تجارية لشركة Dynatrace LLC. تحقق دائمًا من القيم (المنافذ والإصدارات والأحجام) في الوثائق الرسمية الخاصة بإصدارك.