إتفاقيات OpenTelemetry لـ GenAI: مفردات مشتركة لقابلية الملاحظة في AI

Built for Speed: ~10ms Latency, Even Under Load
Blazingly fast way to build, track and deploy your models!
- Handles 350+ RPS on just 1 vCPU — no tuning needed
- Production-ready with full enterprise support
تمنح OpenTelemetry أنظمة GenAI مفردات قياس متلازمة مشتركة، لكنها ليست مخططًا عامًا مكتملًا. في يونيو 2026، نقل المشروع إتفاقياته الدلالية الخاصة بـ GenAI، والمزودين، و MCP إلى مستودع مخصص حتى تتمكن من التطوير والتطوير الإصداري بشكل مستقل. يحدد هذا المستودع حاليًا إتفاقيات GenAI على أنها Development (تحت التطوير)، وحتى 21 أغسطس 2026 ليس لديه أي إصدار رسمي. لا تزال الفرصة كبيرة: الأسماء المشتركة لعمليات النماذج، واستخدام Token، وخطوات Agent، واستدعاءات MCP، وأحداث المحتوى، ونتاجات التقييم يمكن أن تقلل من أعمال الترجمة عبر أدوات القياس وقواعد بيانات observability الخلفية. يجب أن يكون النهج الهندسي هو الاعتماد مع الوعي بالإصدارات - وليس افتراض أن gen_ai.* قد استقر بالفعل.
يمكن لفريقين إرسال بيانات OpenTelemetry صالحة ولا يزالان يختلفان حول ما يعنيه استدعاء LLM. التوافق التشغيلي للنقل والتوافق التشغيلي الدلالي هما مشكلتان مختلفتا. يمكن لـ OTLP نقل بيانات القياس بين الأنظمة؛ بينما تجعل الإتفاقيات الدلالية الحقول داخل تلك البيانات قابلة للتفسير بشكل أكثر اتساقًا. بالنسبة لـ GenAI، لا تزال المشكلة الثانية تخضع لمعايير نشطة.
1. لماذا تحتاج GenAI إلى أكثر من APM التقليدي
يظل APM التقليدي مفيدًا لمعدل الإنتاجية، وزمن الانتقال، والأخطاء، والتبعيات، وصحة الخدمة. وتضيف GenAI مفاهيم دلالية لا تصفها تلك الإشارات بمفردها.
السلوك الاحتمالي. يمكن لنفس الطلب المنطقي أن ينتج مخرجات مختلفة، لذلك غالبًا ما يتطلب تصحيح الأخطاء معرفة النموذج المطلوب والمستخدم، وإعدادات التوليد، ومعرفات الاستجابة، و—حيثما تسمح السياسة—السياق ذي الصلة للمدخلات أو المخرجات. المحتوى الكامل هو دليل مفيد، ولكنه ليس مناسبًا أو ضروريًا دائمًا للاحتفاظ به.
اقتصاديات الـ Tokens. لا تزال أعداد الطلبات مهمة لحجم الحمل وتحديد معدل الاستخدام (rate limiting)، ولكنها غير كافية لتحليل الإنفاق وكفاءة النموذج. فعدد قليل من الاستدعاءات ذات السياق الطويل (long-context) قد يكلف أكثر من عدد كبير من الاستدعاءات القصيرة. وتتضمن مقاييس GenAI الحالية استخدام الـ tokens ومدة العملية، إلى جانب مقاييس الوقت حتى أول جزء (time-to-first-chunk) والوقت لكل جزء مخرج (time-per-output-chunk).
هيكلية الـ Agent. استدعاء النموذج ليس سوى عملية واحدة من بين عمليات عديدة داخل الـ agents. إذ قد تحدد عمليات التخطيط (planning)، وتنفيذ الأدوات (tool execution)، والاسترجاع (retrieval)، وسلاسل أسر العمل (workflows)، واستدعاءات MCP النتيجة النهائية. لذلك، تحتاج القابلية للملاحظة (Observability) إلى مصطلحات خاصة بالتدفق التنفيذي المحيط بالاستدلال (inference)، وليس فقط عند حدود API الخاصة بالمزود.
حساسية المحتوى. غالباً ما تحتوي المدخلات (prompts) والمخرجات على بيانات خاصة بالمستخدم أو بالشركة. يمكن لـ OpenTelemetry توضيح كيفية تسجيل هذا المحتوى، ولكن تبقى مسألة التحديد بين التسجيل، أو الاحتفاظ، أو التصدير، أو الحجب (redact)، أو التقييد قراراً متعلقاً بحوكمة البيانات.
2. ما تغطيه الاتفاقيات القياسية حالياً
الطريقة الأكثر فائدة لقراءة العمل الحالي هي حسب الإشارة والعملية بدلاً من افتراض سلم نضج واحد. ويصنف مستودع GenAI المخصص الاتفاقيات العامة على أنها قيد التطوير (Development).
تتبعات (Spans) النموذج والاستدلال. تحدد الاتفاقيات الحالية عمليات عميل GenAI بما في ذلك الاستدلال، والضمين (embeddings)، والاسترجاع، وجلب الاستجابة، وعمليات الذاكرة، وتنفيذ الأدوات. وتتضمن الخصائص المشتركة gen_ai.provider.name، وgen_ai.operation.name، ومعرفات النموذج المطلوب والمستجيب، واستخدام الـ tokens للمدخلات والمخرجات. ويوفر توقيت الـ span مدة العملية؛ بينما تضع المقاييس المخصصة معايير قياسية لاستخدام الـ tokens والقياسات المتعلقة بالتأخير (latency).
تتبعات (Spans) الـ Agent وأطر العمل. تحدد اتفاقيات الـ agent عمليات مثل create_agent، وinvoke_agent، وinvoke_workflow، وplan، وexecute_tool. يمكن لهذه الـ spans جعل مسار التنفيذ المزود بأدوات القياس قابلاً لإعادة البناء. وهي لا تكشف عن التفكير الخاص بالنموذج، ولا تظهر تلقائياً ما لم يقم إطار العمل المعني أو أدوات القياس بإصدارها.
اتفاقيات MCP. يمتلك MCP اتفاقيات تطوير (Development) خاصة به لتتبعات العميل والخادم، وانتشار W3C Trace Context، والربط بالنقل، والخصائص المدركة للأدوات، والمقاييس مثل mcp.client.operation.duration وmcp.server.operation.duration. وتكمن الفائدة في الاستمرارية عبر حدود MCP — وليس وعداً بأن كل تطبيق لـ MCP يصدر هذه الاتفاقيات بالفعل.
المقاييس والاتفاقيات الخاصة بالمزودين. يحدد المستودع مقاييس العميل، والخادم، وسلسلة أثر العمل، والـ agent، والأداة، ويضيف اتفاقيات خاصة بالمزودين للأنظمة بما في ذلك OpenAI، وAnthropic، وAzure AI Inference، وAWS Bedrock.

3. التقاط المحتوى هو قرار سياسة اختياري (Opt-In)
يمكن للحدث الحالي gen_ai.client.inference.operation.details أن يحمل سجل المحادثة، والمعلمات، والمدخلات، والمخرجات بشكل مستقل عن التتبع الرئيسي. ومستوى متطلباته هو Opt-In (اختياري) صراحةً، وتحذر وثائق OpenTelemetry من أن دعم الأحداث ليس متوفراً بعد في كل لغات البرمجة.
وهذا يعتبر خياراً افتراضياً أفضل من التعامل مع المدخلات (prompts) والإكمال كـ نص تشخيصي عادي. يحدد OpenTelemetry شكل القياس عن بُعد؛ ولكنه لا يقرر فترة الاحتفاظ لديك، أو التخزين الإقليمي، أو سياسة الوصول، أو الأساس القانوني، أو متطلبات الحجب. وتبقى هذه الأمور من مسؤوليات المشغل والأنظمة الخلفية (backend).
بالنسبة لنشر الإنتاج، قم بكتابة السياسة قبل تشغيل تقاط المحتوى: ما هي البيئات التي يمكنها التقاط المحتوى الكامل، وما الذي يتم تصفيته أو اقتطاعه، وإلى أين يُسمح بنقل البيانات المقاسة المصدّرة، وكم فترة الاحتفاظ بها، ومن يمكنه استرجاعها.
4. ماذا يعني هذا للبوابة (Gateway)
تُعد الـ gateway نقطة انبعاث قوية لحركة مرور الـ model التي تمر عبرها بالفعل. فهي ترصد الـ models المطلوبة والمُقدمة، و الـ latency، ونتائج الـ provider، واستهلاك الـ token، وسلوك الـ routing، ومدخلات الـ cost دون مطالبة كل فريق تطبيقات بإعادة بناء عملية الجمع تلك بشكل مستقل. وهي ليست، في حد ذاتها، الـ agent trace بالكامل: فالـ planning المحلي للتطبيق، أو الـ retrieval، أو عمل الـ tool، أو الاستدعاءات التي تتجاوز الـ gateway تتطلب إعداد الـ instrumentation عند تلك الطبقات.
تُصدّر TrueFoundry بالفعل عبر OpenTelemetry. يدعم AI Gateway تصدير OTLP للتتبعات والمقاييس إلى منصات القابلية للملاحظة المتوافقة. وتُوثّق المواد الهندسية الحالية لـ TrueFoundry أيضًا النطاقات الممتدة للزود باستخدام سمات معاصرة مثل gen_ai.provider.name وgen_ai.operation.name وgen_ai.request.model وgen_ai.response.model وgen_ai.usage.input_tokens وgen_ai.usage.output_tokens، إلى جانب التوسعات الخاصة بـ TrueFoundry لسياق البوابة والتكلفة. (وثائق تصدير OpenTelemetry؛ دليل أدوات بوابة TrueFoundry.)
يمكن أن توجد رؤية MCP في المستوى التشغيلي نفسه. تتبع Metrics Dashboard الخاصة بـ TrueFoundry حركة مرور MCP، والخوادم، والأدوات، والإخفاقات، وزمن الانتقال للمكالمات الموجهة عبر AI/MCP Gateway. وهذا يكمل — ولا يستبدل — أدوات التطبيق أو التسخير لخطوات الوكيل المحلية. (Metrics Dashboard؛ نظرة عامة على MCP Gateway.)
وقت تشغيل الوكيل هو حد القابلية للملاحظة التكميلي. يُشغّل TrueForge، تسخير الوكيل مفتوح المصدر من TrueFoundry، حلقة النموذج/الأداة مع أدوات MCP، والمهارات، وبيئة Sandbox، والموافقات، وإدارة السياق، والجلسات المستمرة. ويكشف نموذج SDK الخاص به عن تسلسل هرمي صريح: Agent ← Session ← Turn ← Event، مع أحداث متدفقة لتهيئة MCP، ورسائل النموذج، واستجابات الأدوات، والموافقات، وإكمال الدورة. تحمل أحداث وقت التشغيل تلك سياقًا على مستوى الوكيل لا يمكن للبوابة استنتاجه من حركة مرور النموذج وMCP وحدها.
الادعاء الآمن للنشر أصغر عمداً من ادعاء التكامل: هذا المقال لا يؤكد أن TrueForge يصدر حاليًا أحدث اتفاقيات دلالية لـ GenAI من OpenTelemetry. بدلاً من ذلك، يوفر TrueForge سطح وقت تشغيل مفتوحًا وقابلاً للفحص يمكن إضافته بأدوات أو ربطه بتتبعات OTLP التي يصدرها TrueFoundry AI Gateway بالفعل. هذا الفصل هو هندسة معمارية مفيدة: التسخير يعرف ما يفعله الوكيل؛ والبوابة تعرف ما عبر حد سياستها؛ وOpenTelemetry يعطي تلك الطبقات المزودة بالأدوات وسيلة نقل مشتركة ومفردات مشتركة بشكل متزايد.
يتضمن تصدير التتبع الخارجي تحكمًا صريحًا في المحتوى. تُوثّق أدلة تكامل OTel الخاصة بـ TrueFoundry خيار Exclude Request Data الذي يزيل tfy.input وtfy.output وtfy.input_short_hand من النطاقات الممتدة المصدرة مع الاحتفاظ بالقياس عن بعد الهيكلي مثل الرموز، وزمن الانتقال، والبيانات التعريفية للنموذج. يُعد ذلك تحكمًا مفيدًا في الخروج لحقول محتوى TrueFoundry تلك؛ ولا يزال يتعين على الفرق مراجعة أي سمات قياسية أو مخصصة إضافية تنبعث منها. (وثائق التكامل التوضيحية.)
يظل التقييم عملية حسابية منفصلة. تدعم TrueFoundry سير عمل التقييم الخارجي عبر التتبعات، بينما توفر اتفاقية OpenTelemetry مكانًا قياسيًا لتمثيل نتيجة المقيم. لا تدمج تلك في ادعاء واحد: القياس عن بعد يحمل الأدلة؛ والمقيمون يفسرونها. (التقييم عبر الإنترنت.)

5. موقف قابل للنشر
افصل بين قابلية نقل OTLP ونضج الاتفاقيات الدلالية. من المفيد تصدير التتبعات والمقاييس عبر OpenTelemetry اليوم حتى مع استمرار تطور أسماء حقول GenAI.
ثبّت واختبر الدلالات التي تطلقها بالفعل. مستودع GenAI قيد التطوير (Development)، وانتقلت التعريفات الأساسية القديمة، والدعم اللغوي غير متكافئ. تعامل مع مجموعة السمات المنبعثة لديك كواجهة ذات إصدارات واختبرها مقابل المكتبات الخلفية ومكتبات الأدوات التي تشغلها.
زود كل حد إنفاذ أو تنفيذ بالأدوات بما يمكنه رؤيته بالفعل. تُعد البوابة ممتازة لحركة مرور MCP الموجهة عبر النموذج والبوابة. ولا تزال هناك حاجة لأدوات الوكيل/التسخير للتخطيط، والأدوات المحلية، والاسترجاع، وتحولات الحالة، والأعمال الأخرى التي لا تعبر تلك البوابة أبدًا.
زود حد التسخير بالأدوات عندما تحتاج إلى دلالات الوكيل. إذا كنت تستخدم TrueForge، فإن نموذج الجلسة والدورة والحدث الخاص به يقدم لك معرفات وقت تشغيل صريحة وأحداث أدوات/موافقات لربطها بتتبعات البوابة. احمل فقط البيانات التعريفية للارتباط التي تسمح بها سياسة القابلية للملاحظة لديك؛ ولا تنسخ حمولات الأحداث الحساسة في سمات النطاق الممتد بشكل افتراضي.
اجعل التقاط المحتوى اختياريًا بموجب السياسة. قم بتقليل المحتوى وتصفيته قبل التصدير، ثم حدد عناصر التحكم في الاحتفاظ والوصول في الخلفية القابلة للملاحظة. لا تخلط بين اسم حقل OpenTelemetry وسياسة حوكمة البيانات.
حافظ على التقييم منفصلاً، ولكن قم بربطه. احسب الجودة أو الأمان باستخدام المقيم المناسب لحجم العمل، ثم استخدم حدث نتيجة تقييم قياسي حيثما كان مدعومًا لإرفاق النتيجة بالعملية التي أنتجت الاستجابة.
استخدم السمات المخصصة كتوسعات وليس كبدائل. الحقول الخاصة بالمنتج مثل البيانات التعريفية للبوابة والتكلفة الخاصة بـ TrueFoundry مفيدة. احتفظ بالسمات القياسية جنباً إلى جنب معها حتى لا تزال الأدوات العامة تمتلك سطحاً مشتركاً.
6. حيث يتوقف المعيار
تحل الاتفاقيات الدلالية مشكلة المفردات، وليس كل مشكلة قابلية للملاحظة. لا يزال مستودع OpenTelemetry GenAI المخصص قيد التطوير (Development)؛ وتغطية التنفيذ تتفاوت حسب اللغة والمكتبة؛ ويمكن أن تختلف الخلفيات في كيفية فهرسة القياس عن بعد نفسه أو الاستعلام عنه أو عرضه أو الاحتفاظ به أو تسعيره. حتى التغطية الكاملة للاتفاقيات الدلالية تصف فقط ما يمكن للأدوات ملاحظته — فهي لا تكشف عن تفكير النموذج الخفي أو تجعل التنفيذ غير المزود بأدوات مرئيًا.
بالنسبة لـ TrueFoundry، فإن الادعاء المفيد ملموس: يمكن لـ AI Gateway تصدير التتبعات والمقاييس عبر OTLP وتوثيق سمات gen_ai.* بالنمط الحالي إلى جانب التوسعات الخاصة بـ TrueFoundry. يمنح ذلك الفرق مسار تصدير قائمًا على المعايير دون التظاهر بأن اتفاقيات GenAI التي تتطور بشكل مستقل مجمدة. إذا كان إصدار اتفاقية دلالية معين شرطًا للمشتريات أو الحوكمة، فقم بالتحقق من صحة مجموعة السمات المنبعثة بالضبط ودعم اللغة/الخلفية الذي تعتمد عليه.
المراجع
- OpenTelemetry — نظرة عامة على الاتفاقيات الدلالية لـ GenAI (الحالة الحالية: قيد التطوير - Development).
- OpenTelemetry — النطاقات الممتدة لعميل GenAI، والمقاييس، والنطاقات الممتدة للوكيل/الإطار.
- OpenTelemetry — الاتفاقيات الدلالية لـ MCP للنطاقات الممتدة للعميل/الخادم، والانتشار، والمقاييس.
- OpenTelemetry — أحداث GenAI، بما في ذلك تفاصيل الاستدلال الاختيارية و
gen_ai.evaluation.result. - OpenTelemetry — الاتفاقيات الدلالية الأساسية v1.42.0، والتي نقلت تعريفات GenAI إلى المستودع المخصص.
- TrueFoundry — تصدير تتبع ومقاييس OpenTelemetry؛ دليل أدوات AI Gateway؛ Metrics Dashboard؛ نظرة عامة على MCP Gateway.
- TrueFoundry — التقييم عبر الإنترنت، كعملية حسابية منفصلة عبر أدلة القابلية للملاحظة.
- TrueForge — نظرة عامة على تسخير الوكيل ومفاهيم SDK، لتوثيق التسلسل الهرمي Agent ← Session ← Turn ← Event وأحداث وقت التشغيل لنشاط النموذج، وMCP، والأداة، والموافقة، والإكمال. لا يدعي هذا المنشور التوافق الأصلي لتلك الأحداث مع أحدث الاتفاقيات الدلالية لـ GenAI.
تم وصف حالة OpenTelemetry GenAI وأسماء الحقول من مستودع الاتفاقيات الدلالية المخصص لـ GenAI الحالي كما تم فحصها في 21 أغسطس 2026. ينتمي المستودع إلى فئة Development ولا يوجد له إصدار رسمي في ذلك التاريخ. تقتصر بيانات منتج TrueFoundry على الوثائق العامة الحالية والمواد الهندسيّة: تصدير OTLP، وإمكانية تتبع Gateway، ومقاييس MCP، وسمات gen_ai.* الموثقة، وتصفية حقول محتوى tfy.* المحددة وقت التصدير. لا تدعي هذه التدوينة التوافق مع إيداع محدد لم يتم إصداره في مستودع OpenTelemetry GenAI.
TrueFoundry AI Gateway delivers ~3–4 ms latency, handles 350+ RPS on 1 vCPU, scales horizontally with ease, and is production-ready, while LiteLLM suffers from high latency, struggles beyond moderate RPS, lacks built-in scaling, and is best for light or prototype workloads.



















