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

قابلية الرصد / المتوسط: الرصد والتفسير / الدرس 9

هوية المورد وميزانيات عدد السلاسل

وحّد هوية الخدمة عبر الإشارات، وميّز بيانات المورد الوصفية وسمات المشاهدات والمعرفات غير المحدودة التي تغير تكلفة القياس ومخاطر الخصوصية.

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

أهداف الدرس

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

صف الكيان المرتبط بالإشارة

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

حد القيم التي تنشئ تدفقات المقاييس

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

python ضرب محلي لتراكيب الأبعاد
bounded_dimensions = [4, 6, 3]
combinations = 1
for count in bounded_dimensions:
    combinations *= count
print("bounded", combinations)
print("with_event_ids", combinations * 50_000)
الناتج المتوقع
bounded 72
with_event_ids 3600000

تسمح المنطقة والعملية والنتيجة بـ72 تركيباً في النموذج. تتيح إضافة 50,000 معرف مميز 3,600,000 تركيب قبل حساب هويات مقاييس أخرى أو تغير القيم.

امنح كل بعد غرضاً ومالكاً

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

yaml سياسة تعليمية للأبعاد
metric_dimension_review: parcel-processing
keep: [bounded-region, operation-family, result-class]
reject: [parcel-id, customer-email, raw-url]
resource_identity: stable-service-and-reviewed-instance-context
owner: instrumentation-contract-review
removal_check: preserve-required-diagnostic-slices

السياسة قائمة سماح تحريرية. يعتمد تحويل سمات المورد إلى تسميات والحدود المطبقة عليها على المصدر والمخزن الفعليين.

افحص الترجمة بين نماذج البيانات

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

راجع العدد مع تطور النظام

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

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

ينشئ كل طلب تدفق مقياس جديداً.

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

تشير روابط الإشارات إلى خدمات غير مرتبطة.

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

يخفي حد عددي إخفاقات مهمة بصمت.

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

اختبر فهمك

1. هل يجب دائماً حذف معرف المثيل لتقليل التكلفة؟

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

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

2. لماذا يعد نص الخطأ الخام بعداً ضعيفاً للمقياس؟

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

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

أهم ما تعلمته

  • تختلف أدوار الهوية بين المورد ونطاق الرصد والمشاهدة.
  • حتى الأبعاد المحدودة تتضاعف وتتغير قيمها عبر الزمن.
  • الحدود وتحويلات الهوية جزء من عقد الأدلة.

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