تصميم بيانات رصد وكلاء الذكاء الاصطناعي

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

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

ابدأ بالقرار ثم اختر الإشارة

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

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

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

اكتب عقد حقول قابلاً للتنفيذ

عقد حقول توضيحي للمهمة AC-91

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

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

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

أبعد المعرفات الفريدة عن أبعاد المؤشرات التجميعية

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

في حساب توضيحي للحد المحتمل، تسمح 6 أنواع خدمات و2 بيئتي تشغيل و4 فئات نتائج و3 فئات لغوية بعدد 144 تركيبة لمؤشر واحد. إضافة بعد يحوي 10,000 معرف مهمة تجعل حاصل الضرب المحتمل 1,440,000 تركيبة. لن تظهر كلها بالضرورة، وقد يضيف تمثيل المدرج التكراري سلاسل أخرى. هذا تنبيه تصميم، لا توقع سعة.

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

ضع ضوابط المحتوى عند الحد الصحيح

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

في AC-91، سجل فئة الصلاحية ومرجع المصدر اللازم للتحقيق. لا تصدر رموز المصادقة أو بيانات اعتماد الدليل أو تفاصيل موظفين غير ضرورية. راجع الاستثناءات؛ فقد تعيد رسالة خطأ جسم الطلب رغم تقليل الاستجابات المعتادة.

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

لا تضع محتوى ربط حساساً في Baggage لتجنب إعداد الخصائص. فقد تعبر Baggage حدود الخدمات. حدد المفاتيح والوجهات المسموحة، وافصل فحص السلطة عن القيم الممررة. ويتناول دليل بيانات AgentOps وحماية البيانات الشخصية مراجعة التدفقات الشخصية المعنية بصورة مستقلة.

افصل اكتمال السجل عن أخذ العينات

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

يميز OpenTelemetry العينة المبكرة Head Sampling والعينة المتأخرة Tail Sampling بحسب توقيت القرار وأدلته. لا تضمن الأولى حفظ كل خطأ يظهر لاحقاً. وتحتاج الثانية إلى تخزين مؤقت وقرارات وقت وسعة، ولا تستعيد ما أسقط سابقاً. وقد تمتد المهمة عبر آثار متعددة وتتجاوز نافذة القرار.

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

احسب الحجم قبل التفاوض على الفاتورة

قس حجم الأحداث بعد تحويلها لصيغة النقل في اختبار ممثل، ثم احسب الحمل. في مثال توضيحي، نفترض 2,400 مهمة يومياً و14 مقطعاً لكل مهمة و1,800 بايت للمقطع. حاصل الضرب 60,480,000 بايت، أي 60.48 ميغابايت عشرية يومياً. وخلال 30 يوماً افتراضية للاحتفاظ يصبح الحجم نحو 1.81 غيغابايت عشرية.

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

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

صمم الاحتفاظ كدورة حياة

حدد الاحتفاظ بحسب الغرض وتصنيف البيانات. قد تختلف التفاصيل التشخيصية المؤقتة وحالات الاختبار والاتجاهات المجمعة وسجلات المساءلة. تتبع المدة متطلبات المؤسسة وقراراتها؛ ومثال 30 يوماً الحسابي ليس توصية نظامية أو تشغيلية.

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

احفظ قابلية التفسير بعد انتهاء التفاصيل. يحتفظ الاتجاه بتعريفه وفترته وحدود التغطية، وتحتفظ حالة الاختبار بمصدرها المعتمد ونتيجتها المتوقعة ما دامت مستخدمة. تجنب بقاء درجة لا تستطيع المؤسسة تفسير ما قيمته.

احم الوصول إلى الأدلة كالوصول إلى التطبيق

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

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

نسق أدلة المساءلة مع عقد سجل التدقيق المستقل. ولإسناد التكلفة، احفظ مصدر القياس ووحداته اللازمة لـإدارة تكاليف AgentOps. يدعم التصميم العمليتين دون الادعاء بأن تيار تشخيص واحد بالعينة يلبي كل المتطلبات.

اقبل التصميم بمراجعة الحقول

راجع مهمة عادية وتوصية مرفوضة واستثناء أداة وتصديراً منقطعاً. افحص الحقول والوجهات والوصول ومؤشرات الفقد والانتهاء لكل منها. اطلب تفسير AC-91 بالأدلة المسموحة فقط. وإذا تعذر، فحسن العقد بدلاً من تشغيل التقاط غير مقيد.

احفظ عقد الحقول ونموذج الحجم وحالات المراجعة مع الخدمة. تحول المراقبة الإنتاجية الإشارات المعتمدة إلى قرارات واستجابات. ويمكن تحديد نطاق خدمات AgentOps حول بنية الأدلة والتسليم المطلوب.

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