AI Observer لمساعدي البرمجة: التكاليف والتتبعات محليًا

AI Observer لمساعدي البرمجة: تابع الرموز والتكاليف وتتبعات Claude Code وCodex وGemini على جهازك باستخدام Docker، وأحكم تأمين الوصول إليه.
AI Observer assistants de code : coûts et traces en local

ينتهي الشهر فتصل فاتورة مزوّد النماذج مرتفعة، ولا أحد يعرف أيّ جلسة من Claude Code أو Codex CLI أو Gemini CLI تسببت في ذلك. للإجابة دون بناء منصة كاملة، هناك AI Observer لمساعدي البرمجة، وهو المستودع المفتوح المصدر tobilg/ai-observer: واجهة خلفية للمراقبة تعمل على جهازك، تستقبل القياسات من هذه الأدوات وتعرضها في لوحة واحدة.

أبدأ بما هو أثقل وزنًا، أي الأمان ومكان وجود البيانات، ثم أنتقل إلى التثبيت. كل ما يرد هنا مصدره المستودع وملف README، وقد اطلعت عليهما في 9 نوفمبر 2026. لم أثبّت الأداة بنفسي، ولقطات الشاشة هي التي ينشرها المستودع.

قرّر أولًا أين تعيش بيانات القياس

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

  • للفرد أو الفريق الصغير، يوفّر حفظها على الجهاز بناء مسار بيانات كامل، ويقلّص ما يغادر الجهاز.
  • أما لأسطول من المطوّرين فالأنسب النهج المركزي مع ضبط الوصول والاحتفاظ على مستوى المنصة.

يستهدف AI Observer الحالة الأولى بوضوح.

ما هو AI Observer بحسب المستودع

يصف المشروع نفسه بأنه واجهة خلفية للمراقبة ذاتية الاستضافة، في ملف تنفيذي واحد ومتوافقة مع OpenTelemetry. يدعم Claude Code وGemini CLI وOpenAI Codex CLI وGitHub Copilot وOpenCode. هذا ما تحققت منه في المستودع بتاريخ 9 نوفمبر 2026:

  • الترخيص MIT بحسب ملف LICENSE؛
  • نحو 291 نجمة و26 نسخة متفرعة (fork) على صفحة GitHub في ذلك اليوم؛
  • آخر commit في 6 نوفمبر 2026، وهو يصدر الإصدار 0.7.0 (خادم MCP وتحديث الأسعار وإصلاحات)؛ الوسم v0.7.0 موجود، لكن GitHub لم يعرض أي «release»؛
  • التخزين في DuckDB، واستقبال OTLP عبر HTTP/JSON وHTTP/Protobuf، وتحديث اللوحة عبر WebSocket؛
  • ملف تنفيذي بحجم 54 MB تقريبًا مع الواجهة المضمّنة، وصورة Docker بحجم 97 MB تقريبًا لمنصتي linux/amd64 وlinux/arm64 (أرقام README ولم أقِسها بنفسي).

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

كيف تؤمّنه: ما يفترضه README وما لا يفترضه

يقرّ README نفسه بأن AI Observer لا يوفر مصادقة افتراضيًا، وبأن قاعدة البيانات قد تحوي طلبات وشيفرة ومخرجات أدوات. لذلك يستمع الملف التنفيذي إلى 127.0.0.1 فقط. أما وسائل الحماية التي يصفها فهي:

  • رمز مشترك هو AI_OBSERVER_AUTH_TOKEN مطلوب على OTLP وعلى واجهة API؛
  • فحص ترويسة Host والأصل (origin) للحماية من DNS rebinding ومن صفحات ويب قد تحقن قياسات مزيفة؛
  • حجب للبيانات قبل التخزين عبر AI_OBSERVER_REDACT، يستبدل افتراضيًا الأسرار (مفاتيح API والرموز وكلمات المرور)، وتضيف القيمة all البيانات الشخصية؛
  • مدة احتفاظ AI_OBSERVER_RETENTION_DAYS تحذف البيانات القديمة؛
  • نقطة وصول MCP اختيارية، معطّلة افتراضيًا، تتيح لوكيل أن يعيد قراءة محادثاتك السابقة. وما تعيده يذهب إلى مزوّد النموذج، فلا تفعّلها إلا عن دراية.

لم أدقّق أيًّا من هذه الحمايات. جرّبها على بياناتك أنت قبل أن تثق بها.

تشغيل AI Observer لمساعدي البرمجة بواسطة Docker

يوصي README باستخدام Docker. يُنشر المنفذان على 127.0.0.1 فقط، وهذه هي القيمة الصحيحة، ويحفظ وحدة تخزين (volume) قاعدة البيانات.

  1. شغّل الحاوية:
    docker run -d \
      -p 127.0.0.1:8080:8080 \
      -p 127.0.0.1:4318:4318 \
      -v ai-observer-data:/app/data \
      --name ai-observer \
      tobilg/ai-observer:latest
  2. افتح http://localhost:8080. يخدم المنفذ 8080 الواجهة وAPI، ويستقبل المنفذ 4318 بيانات OTLP.
  3. مع Claude Code يطلب README هذه المتغيرات البيئية، والأفضل وضعها في ملف تعريف الصدفة (shell):
    export CLAUDE_CODE_ENABLE_TELEMETRY=1
    export OTEL_METRICS_EXPORTER=otlp
    export OTEL_LOGS_EXPORTER=otlp
    export OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf
    export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318
  4. أعد تشغيل المساعد، وافتح جلسة، ثم راقب العدّادات وهي ترتفع.
نافذة طرفية فيها أمر docker run الخاص بـ AI Observer ومتغيرات OTEL لـ Claude Code، مأخوذة من README
Source : github.com

دون Docker يذكر README أيضًا Homebrew (على macOS بمعالج Apple Silicon)، أو ملفًا تنفيذيًا من صفحة Releases، أو البناء بالأمرين make setup ثم make all. لم أتحقق من هذه الطرق.

دون تصدير OTLP: وضع watch

مع Claude Code وCodex CLI وGemini CLI يمكنك الاستغناء عن متغيرات OTEL، إذ يقرأ الأمر ai-observer watch ملفات الجلسات المحلية ويستوردها أولًا بأول. عند أول تشغيل يسجّل الموضع الحالي فقط، ويحمّل الخيار --backfill السجل السابق. ويؤدي الأمر import العمل نفسه دفعة واحدة، بينما يكتب export ملفات Parquet.

انتبه إلى فخ موثّق: لا يجوز الجمع بين watch وserve (استقبال OTLP) على قاعدة واحدة، وإلا تكررت البيانات. أما GitHub Copilot وOpenCode فيعملان عبر OTLP وحده.

ما الذي تعرضه اللوحة

تجمع واجهة «All Tools» في README الإجماليات (التتبعات والسجلات والمقاييس ومعدل الأخطاء)، وتحتها التكلفة والزمن الفعلي والرموز لكل أداة.

لوحة All Tools في AI Observer تعرض التتبعات والسجلات والمقاييس والتكلفة واستهلاك الرموز لكل أداة
Source : github.com

تعرض واجهة التتبعات شجرة الـ spans الخاصة بمهمة ما. وفي لقطة README تُظهر مهمة من Codex CLI تضم 371 span كل خطوة استدلال واستدعاء دالة مع مدتها.

واجهة التتبعات في AI Observer: شجرة spans لمهمة من Codex CLI مع مدة كل خطوة
Source : github.com

إذا احتجت إلى ما هو أبعد من الجهاز المحلي

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

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

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

ممارسات جيدة

  • انشر المنفذين على 127.0.0.1 واحفظ القاعدة في volume مسمّى.
  • أبقِ حجب الأسرار مفعّلًا وحدّد مدة احتفاظ قصيرة.
  • اختر وضعًا واحدًا فقط، watch أو serve، لكل قاعدة بيانات.
  • قارن التكلفة المعروضة بفاتورة المزوّد مرة كل شهر.

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

هل يرسل AI Observer بياناتي إلى خدمة طرف ثالث؟

يقدّمه README أداةً محلية لا تحتاج إلى خدمة خارجية. المخرج الوحيد الممكن هو ما تفعّله أنت، مثل نقطة وصول MCP نحو وكيل.

ما مساعدو البرمجة الذين يدعمهم AI Observer؟

Claude Code وGemini CLI وOpenAI Codex CLI وGitHub Copilot وOpenCode. ويمكن للثلاثة الأولى الدخول أيضًا بقراءة ملفات الجلسات.

هل يمكنني نشره لفريق كامل؟

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

الخلاصة

قبل أن تثبّت أي شيء، أجب عن سؤال واحد: أين ينبغي أن تعيش بيانات قياس مساعديك؟ فإن كان الجواب «على الجهاز»، فشغّل AI Observer بواسطة Docker، وتأكد من تحرك العدّادات، وعامل الأمان بوصفه لبّ النشر. وللمتابعة اقرأ المستودع الرسمي وملف CHANGELOG.

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

Total
0
Shares
Leave a Reply

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

Previous Post
Dynatrace OTel Collector : migrer de Contrib sans mauvaise surprise

Dynatrace OTel Collector: الانتقال من Contrib دون مفاجآت

Next Post
Observal observabilité agents de code : sessions et traces

مراقبة وكلاء البرمجة باستخدام Observal: الجلسات والآثار

Related Posts