اللوحة خضراء ولم يلحظ أحد أي استثناء، ومع ذلك يحتاج سير عمل الوكلاء إلى 45 ثانية ليرد. من أين تبدأ؟ من هذا السؤال التشغيلي ينطلق AgentOps Center، وهو مستودع على GitHub صغير وُلد في هاكاثون حول SigNoz. قرأته ملفًا ملفًا دون نشره، ولذلك أفصل هنا بين ثلاثة أمور: ما تفعله الشيفرة فعلًا، وما يدّعيه ملف README، وما لم أستطع التحقق منه.
قيمة المشروع في النمط الذي يعرضه أكثر من كونه منتجًا. فهو يبيّن كيف تُسمّى السبانات (spans) في نظام متعدد الوكلاء، وإلى أين تُرسل، وكيف يُبنى جواب المساعد على بيانات حقيقية. سنتتبع هذه القرارات الثلاثة ثم نصل إلى الحدود.
ملاحظة منهجية: آخر commit قرأته يعود إلى 26 يوليو 2026. لا أذكر عدد النجوم لأنني لم أقرأه من المصدر. يذكر README رخصة MIT، لكنني لم أجد ملف LICENSE في شجرة المشروع، فتأكد قبل أي إعادة استخدام.
ماذا يقدّمه AgentOps Center لمن يشغّل الوكلاء
أدوات APM التقليدية تعدّ الطلبات وأخطاء HTTP. أما سير عمل الوكلاء فيتعطل بطريقة أخرى: يدور في حلقة، ويعيد استدعاء أداة، وينتظر مزوّد نموذج فرض حدًّا على المعدل. لا شيء ينكسر، لكن كل شيء يبطؤ وتتضخم فاتورة الرموز (tokens) بصمت.
يسرد README الأسئلة التي يريد فريق التشغيل حسمها: أي عقدة دخلت في حلقة، وأي أداة أعادت حدّ المعدل، وكم كلّف كل وكيل فرعي. وللإجابة تلزم سبانات لكل وكيل ولكل استدعاء نموذج ولكل أداة، مرتبطة في أثر (trace) واحد. وهذا ما تبنيه الشيفرة بالضبط.
القرار الأول: كيف تُسمّى سبانات الوكلاء المتعددين
يعرّف الملف backend/instrumentation/agent_spans.py ثوابت للسمات. يأخذ مفاتيح gen_ai.* لاستدعاءات النموذج، ثم يضيف مفاتيح خاصة بالوكلاء والأدوات.

الاختيار سليم: الجزء القياسي يسمح بمقارنة النماذج والمزوّدين، والجزء الخاص يحمل منطق العمل (أي وكيل، وأي سير عمل). ومعرّف سير العمل على كل سبان يتيح تجميع كل شيء حتى لو جاءت السبانات من مكتبات مختلفة. ولفهم ما يحمله السبان، اقرأ تشريح سبان OpenTelemetry.
تنبيهان:
- اصطلاحات GenAI في OpenTelemetry تتغير بسرعة. صفحة المواصفة تحيل الآن إلى مستودع مستقل لم أستطع قراءته (خطأ من الخادم لحظة المحاولة). وقد يكون
gen_ai.systemاستُبدل بسمة مزوّد أحدث: لم يتم التحقق. - السمة
gen_ai.usage.cost_usdمن ابتكار المشروع، وليست مفتاحًا قياسيًا على حد علمي. أي لوحة تعتمد عليها ستبقى خاصة بشيفرتك.
تفصيل آخر: السمتان gen_ai.prompt وgen_ai.completion تُقتطعان عند 500 حرف في الشيفرة. وضع نصوص الطلبات كاملة داخل السبانات مكلف ويعرّض البيانات، والاقتطاع حل وسط معقول، لكن حدّد سياستك قبل الإنتاج. وفي هذا الموضوع انظر أيضًا سمات OpenTelemetry في Dynatrace.
القرار الثاني: إلى أين تذهب التليمتري
تهيّئ الوحدة setup.py مزوّدًا للآثار وآخر للمقاييس، مع تصدير OTLP عبر gRPC إلى localhost:4317 افتراضيًا، ويمكن تغييره بالمتغير OTEL_EXPORTER_OTLP_ENDPOINT. وتُفعَّل أدوات FastAPI وhttpx، وكذلك LangChain عبر OpenInference الذي يغطي LangGraph أيضًا بحسب تعليق في الشيفرة. نسبة أخذ العينات 100%، وتصفها الشيفرة نفسها بأنها إعداد للعرض التجريبي.
يستقبل Collector المستودع بروتوكول OTLP ويكتب مباشرة في ClickHouse بمصدّرات SigNoz، بمسار مستقل لكل إشارة.

هذا المخطط خاص بـ SigNoz المستضاف ذاتيًا. وإن كان الواجهة الخلفية لديك غيره (Dynatrace مثلًا) فالمصدّر وحده يتغير، أما بروتوكول OTLP والسمات فتبقى. يعرض دليلنا عن Collector في OpenTelemetry نحو Dynatrace هذه الصيغة، ولم أجرّب هذا المستودع مع Dynatrace.
من زاوية التشغيل، تتضمن الإعدادات memory_limiter ودفعات من 10 000 عنصر كل 10 ثوانٍ. وهذا تصرف حسن، لأن نظام الوكلاء قد ينتج آلاف السبانات في التشغيل الواحد، ويذكر README في اختبارات الدخان ما بين 2 340 و3 559 سبانًا في كل تشغيل.
القرار الثالث: مساعد يشخّص لكن بالأدلة
هذه أطرف الأفكار. فـ «Root Cause Copilot» لا يسأل نموذجًا في الفراغ. يستعلم محرك الأدلة أولًا خادم MCP الخاص بـ SigNoz ليجلب الآثار وسجلات الأخطاء والمقاييس والتنبيهات، ثم يبني سياقًا موسومًا بالأداة المصدر، وبعدها يقدّر مستوى الثقة.
تؤكد وثائق SigNoz أن هذا الخادم يتيح من بين أدوات أخرى signoz_search_traces وsignoz_search_logs وsignoz_query_metrics وsignoz_list_alert_rules. ويُفعَّل وضع HTTP بالقيمة TRANSPORT_MODE=http ونقطة الوصول هي /mcp. وللإطار العام للبروتوكول اقرأ مراقبة وكلاء MCP باستخدام OpenTelemetry.
يظهر تقدير الثقة في الملف reasoning.py:
- خادم MCP لا يمكن بلوغه: ثقة LOW بالسياق المحلي في الذاكرة فقط؛
- آثار مع إشارة أخرى (سجلات أو مقاييس أو تنبيهات): HIGH؛
- إشارة واحدة فقط: MEDIUM؛
- لا بيانات قابلة للاستعمال: NONE.
قراءة نقدية: القاعدة تقدير لكمية الإشارات لا مقياس للصحة. بل إن شرطًا في الشيفرة يمنح HIGH متى ردّ خادم MCP بإشارتين على الأقل أيًّا كانتا. فالشارة تعني «وجدتُ ما يسند جوابي» لا «جوابي صحيح».
اختبار المراقبة بأعطال محقونة
يسحب محرك الفوضى (chaos/injector.py) أعطالًا عشوائيًا بحسب شدة بين 0 و1: انتهاء المهلة، وخطأ 429 أو 500، وفشل أداة، وبطء من 2 إلى 8 ثوانٍ، وتعطل وكيل، وخرج تالف. يذكر README خمسة أنواع بينما في الشيفرة ستة مع الخرج غير الصالح. وكل عطل ينشئ سبان خطأ يحمل chaos.mode وchaos.injected.
فائدته لمهندس SRE أن يتأكد من أن التنبيهات واللوحات ترى التدهور قبل أن يحدث فعلًا. كما أن الوسم chaos.injected يمنع الخلط بين التمرين والحادثة. وعن الضوابط المرتبطة اقرأ ضوابط وكلاء الذكاء الاصطناعي في الإنتاج.
ما هو حقيقي وما هو مكتوب سلفًا
هذا هو الحد الرئيسي: «الحوادث» في سير العمل مكتوبة سلفًا. ففي graph.py تُصدر الشيفرة، بحسب كلمات في نص السيناريو، سبانات Redis وSQL وواجهة طرف ثالث بقيم ثابتة: 48 اتصالًا من 50، وحالة 429 لدى خدمة دفع، وانتظارات محاكاة بالدالة asyncio.sleep.

هذا ليس عيبًا في عرض تجريبي، لكنه يغيّر طريقة قراءة لقطات README: فهي تثبت أن سلسلة التليمتري تعمل، لا أن الأداة تكتشف أعطالًا حقيقية. وتعرفة النماذج جدول مكتوب في الشيفرة أيضًا (أربعة نماذج وسعر افتراضي لما سواها). ولمتابعة تكلفة حقيقية انظر تكلفة وكيل الذكاء الاصطناعي بالرموز في OpenTelemetry.
ويعترف README نفسه بقيود أخرى في قائمة التحسينات: لا مصادقة ولا تعدد مستأجرين، ولا تنبيهات مدمجة، ولا احتفاظ طويل بالبيانات. ولا أعيد استخدام لقطاته هنا لغياب ملف الرخصة.
نقل النمط إلى مشروعك خطوة بخطوة
- عرّف مفاتيح السمات: معرّف سير العمل، واسم الوكيل، واسم الأداة، ومفاتيح
gen_ai.*للنماذج. - لُفّ كل استدعاء نموذج وكل أداة بسبان، مع حالة الخطأ وتسجيل الاستثناء.
- أرسل كل شيء عبر OTLP إلى Collector مع
memory_limiterودفعات. - للتجربة المحلية يطلب README نسخ
.env.exampleووضع مفتاح Groq أو OpenAI ثم تنفيذdocker compose up -d(يعلن تسع حاويات). - تحقق من استجابة
localhost:3000(الواجهة) و8000(واجهة البرمجة) و8080(SigNoz) بحسب README.
ولفهم كيف يُتتبع مخطط الوكلاء من جهة الشيفرة، يشرح مقالنا عن تتبع LangChain وLangGraph الأدوات اللازمة.
ممارسات جيدة
- معرّف سير عمل على كل سبان، وفي السجلات أيضًا.
- مفاتيح قياسية لما يُقارَن ومفاتيح خاصة موثّقة لما عداه.
- خذ عينات في الإنتاج: نسبة 100% تصلح لعرض تجريبي لا لأسطول وكلاء.
- لا تضع نصوص الطلبات كاملة ولا الأسرار في السمات أبدًا.
- سِم الأعطال المحقونة لتميّزها عن الحوادث الحقيقية.
الأسئلة الشائعة
هل يعمل AgentOps Center مع Dynatrace؟
كُتب من أجل SigNoz: يصدّر الـ Collector إلى ClickHouse ويستعلم المساعد خادم MCP الخاص بـ SigNoz. أما السبانات فهي OpenTelemetry قياسية ويمكن توجيهها إلى وجهة أخرى، لكنني لم أجرّب هذا المسار.
هل تضمن شارة الثقة تشخيصًا سليمًا؟
لا. هي تقيس كمية التليمتري المسترجعة لا صحة الاستنتاج. أعد قراءة الآثار المستشهد بها دائمًا.
هل هو جاهز للإنتاج؟
يقدّمه README كعرض هاكاثون، ويضع بنفسه المصادقة والتنبيهات والاحتفاظ ضمن الأعمال المقبلة. استعمله مصدرًا للأفكار.
الخلاصة
يجيب AgentOps Center عن سؤال تشغيلي حقيقي بنمط واضح: سبانات حسنة التسمية، ومسار OTLP، ومساعد مُلزم بذكر مصادره. حوادثه مكتوبة سلفًا وشيفرته شيفرة هاكاثون، لكن بنيته تُقرأ في ساعة وتنتقل بسهولة. خذ الأفكار لا الشيفرة كما هي.
span.observer مدوّنة مجتمعية مستقلة وغير تابعة لمشروع AgentOps Center ولا لمؤلفيه ولا لشركة SigNoz ولا لشركة Dynatrace LLC. العلامات المذكورة ملك لأصحابها. الأدوات تتغير بسرعة: تحقق من الأوامر والخيارات في وثائقها الرسمية.