مراقبة وكلاء الذكاء الاصطناعي مع traceroot: الترخيص والتشغيل والحدود

مراقبة وكلاء الذكاء الاصطناعي مع traceroot: تتبعات وكواشف وتكلفة، تشغيل Docker بأربعة أوامر، ترخيص Apache 2.0 ومجلدات Enterprise، وحدود تمت مراجعتها.
traceroot observabilité agents IA : licence, démarrage et limites

أخطأ وكيل الذكاء الاصطناعي لديك مع ثلاثة عملاء الليلة الماضية، ولا أحد يعرف أي استدعاء أداة هو الذي انحرف. أمامك خياران: قراءة التتبعات يدويًا أو ربط أداة تفرزها لك. مشروع traceroot (traceroot-ai/traceroot) يختار الخيار الثاني. وهذه قراءتي له من زاوية مراقبة وكلاء الذكاء الاصطناعي: ما يحتويه المستودع، وكيف تشغّله، وما الذي يسمح به ترخيصه فعلًا.

المعطيات بتاريخ 10 نوفمبر 2026، وقد تحققت منها في المستودع بعد استنساخه: آخر commit بتاريخ 10 نوفمبر 2026، وترخيص Apache 2.0 لمعظم الشيفرة، وترخيص «Enterprise» للمجلدات المسماة ee. لم أستطع قراءة عدد النجوم فلا أذكره. ولم أنشر المنصة بنفسي: كل ما يلي مصدره ملف README والوثائق والشيفرة، والصور مأخوذة من المستودع.

المشكلة: الوكيل في بيئة الإنتاج يُقاس بآلاف التتبعات

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

يصف ملف README حلقة تبدأ من التتبع وتنتهي بإصلاح متحقَّق منه، وتقسمها الصفحة الرئيسية للمستودع إلى أربع مراحل.

  • Trace: كل استدعاء للنموذج أو لأداة، مع المدخلات والمخرجات وزمن الاستجابة والتكلفة.
  • Detect: «كواشف» تعلّم التنفيذات التي خرجت عن المطلوب في بيئة الإنتاج.
  • Signals: تُجمَّع النتائج المتكررة في إشارات، ويقترح وكيل يعمل في الخلفية مسارات للتحقيق انطلاقًا من التتبعات ومن شيفرة GitHub المربوطة.
  • Verify: تقييمات على مجموعات بيانات لمقارنة الإصدارات.

مراقبة وكلاء الذكاء الاصطناعي: ما تعرضه الواجهة

تعرض وثائق المستودع عرضًا زمنيًا: شجرة الجلسة على اليسار، وأشرطة على اليمين. تحتوي أدوار الوكيل على استدعاءات للنموذج (ChatCompletion) وللأدوات (get_weather وcalculate). ويُظهر كل استدعاء للنموذج عدد الرموز (tokens) في المدخل والمخرج وتكلفته.

عرض Timeline في traceroot: شجرة الجلسة مع أدوار الوكيل واستدعاءات النموذج والأدوات، والمدة وعدد الرموز والتكلفة لكل استدعاء
Source : github.com

وتظهر التكلفة مفصَّلة في لقطة ثانية: تفصل نافذة منبثقة بين تكلفة المدخل (دون ذاكرة مؤقتة، وقراءة الذاكرة المؤقتة، وكتابتها) وتكلفة المخرج. وهذا التفصيل مفيد لفهم سبب غلاء الموجّه الطويل. القيم من عرض تجريبي للمشروع، ويظهر الإصدار v1.2.2 على الصورة.

تتبع في traceroot مع نافذة تفصل تكلفة استدعاء النموذج: المدخل والذاكرة المؤقتة والمخرج والمجموع
Source : github.com

وفي المراقبة آليتان مختلفتان. يقرأ الكاشف تتبعًا بواسطة نموذج حَكَم ويجيب بنعم أو لا، والجواب «نعم» يصبح نتيجة. أما التنبيه فيراقب رقمًا عبر الزمن (مثل p95 لزمن استدعاءات النموذج خلال عشر دقائق) ويكتب في Slack عند تغيّر الحالة. وتذكر الوثائق أن التنبيهات تعمل في جميع الباقات بما فيها الاستضافة الذاتية، وكذلك الكواشف، مع 100 تنفيذ مشمولة في الباقة المجانية للخدمة السحابية.

التشغيل محليًا: أربعة أوامر

بحسب README تحتاج إلى Git وDocker Compose وMake. يولّد الهدف prod-lite أولًا الأسرار الناقصة في ملف .env (قرأت ذلك في Makefile) ثم يشغّل المنظومة.

أوامر README في traceroot: git clone وcp .env.example .env وmake prod-lite ثم رسالة البدء على localhost:3000
Source : github.com

بعد ذلك افتح localhost:3000. يعلن الملف docker-compose.prod.yml عن PostgreSQL وClickHouse وMinIO وRedis، إضافة إلى خدمات التطبيق (الويب وAPI وworker والكاشف والوكيل). فأعدّ ذاكرة وقرصًا كافيين، فلم أقس هذه المتطلبات.

لإرسال أول تتبع يقترح README الأمر npx -y traceroot-cli@latest setup (يتطلب Node.js بإصدار 20.12 أو أحدث)، وهو يكتب مفتاح API في ملف البيئة ويطلب من وكيل برمجي إضافة SDK. أما يدويًا فتستخدم SDK لـ Python أو TypeScript مع TRACEROOT_API_KEY وTRACEROOT_HOST_URL، وفي الاستضافة الذاتية يشير العنوان إلى نسختك. ويسرد README تكاملات مع LangChain وLlamaIndex وCrewAI وOpenAI Agents SDK وVercel AI SDK وMastra، ومع مزوّدي Anthropic وOpenAI وGemini وMistral وOpenRouter.

مسألة الترخيص: اقرأها قبل أن تقول «مفتوح المصدر»

يعلن ملف LICENSE نظامين. كل شيء تحت Apache 2.0 عدا المجلدات المسماة ee المشمولة بترخيص Enterprise. ويقول نص ee/LICENSE إن هذه الشيفرة لا تُستخدم في الإنتاج إلا بالموافقة على شروط خدمة الناشر أو بعقد، ومع مفتاح ترخيص يناسب عدد المقاعد.

في الشيفرة يُسمى المفتاح TRACEROOT_EE_LICENSE_KEY، ويذكر تعليق الملف ee/license.py أن SSO وسجلات التدقيق وRBAC من الوظائف المعنية. الخلاصة الحذرة: النواة حرة وبعض وظائف المؤسسات ليست كذلك. قبل النشر، اكتب الوظائف التي تحتاجها واسأل الناشر عمّا يقع ضمن ee، فلم أطابق كل شيء بنفسي.

الحدود والنقاط المفتوحة

  • النضج. يشير pyproject.toml إلى الإصدار 0.1.0 بينما تعرض الواجهة v1.2.2، والفارق غير مشروح. ويذكر README مرورًا بـ Y Combinator (S25) عبر شارة.
  • النشر. تصف الوثائق مسار Kubernetes مع Helm وTerraform لكنها تعدّه تجريبيًا، وتحيل إلى مجلد deploy لم أره في نسختي المستنسخة. أنقل ذلك كما هو.
  • البيانات. تمر الموجّهات والمخرجات عبر المنصة. اقرأ SECURITY.md وأخفِ الأسرار قبل الإرسال.
  • الكواشف. النموذج الحَكَم يستهلك رموزًا، فهو يُحاسَب عليه، وقد يخطئ، ويقرأ تتبعاتك.
  • Dynatrace. لا توجد أي صلة رسمية بين traceroot وDynatrace.

كيف تدمجه في منظومة المراقبة لديك

الأسئلة الشائعة

هل traceroot مفتوح المصدر فعلًا؟

في معظمه: Apache 2.0 لكل ما هو خارج مجلدات ee، وهذه تخضع لترخيص Enterprise بمفتاح. تحقق من الوظائف التي تستهدفها.

هل يمكن استضافته ذاتيًا دون حساب سحابي؟

يصف README تشغيلًا محليًا عبر Docker Compose ووضعًا مستضافًا ذاتيًا لأداة CLI (الخياران --host و--auth-host). لم أجرّبه من البداية إلى النهاية.

هل يحل محل Dynatrace؟

لا. يركّز على سلوك الوكلاء (الاستدعاءات والتكلفة والكواشف)، أما الربط بالبنية التحتية وأهداف مستوى الخدمة (SLO) والسبب الجذري فتبقى من شأن منصة المراقبة لديك.

الخلاصة

يستحق traceroot التجربة إن كانت وكلاؤك تعمل أصلًا وتريد رؤية إخفاقاتها وفرزها. اقرأ الترخيص قبل أن تلزم فريقًا به، وعامل نشر Kubernetes على أنه تجريبي. وللاطلاع على سمات span التي ينبغي إصدارها، راجع إطار GenAI في OpenTelemetry.

span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC. Dynatrace علامة تجارية لشركة Dynatrace LLC. traceroot ملك لأصحابه. الصور مأخوذة من مستودع المشروع (ترخيص Apache 2.0) ولم أجرّبها بنفسي.

Total
0
Shares
Leave a Reply

Your email address will not be published. Required fields are marked *

Previous Post
Crossplane Dynatrace : piloter l'observabilité as code depuis Kubernetes

Crossplane Dynatrace: إدارة المراقبة ككود انطلاقًا من Kubernetes

Next Post
mcp-migrate serveur MCP : vérifier avant la révision 2026-07-28

فحص خادم MCP باستخدام mcp-migrate قبل مراجعة 2026-07-28

Related Posts