الهجرة إلى `agenteye-collector`

الهجرة غير مدمرة: لا تسبب أي توقف للخدمة ولا فقدان بيانات، وتحرر الاسم القصير agenteye لواجهة سطر أوامر AgentEye بحيث يمكن لخادم جامع البيانات والواجهة أن يعملا معاً على نفس الجهاز. تم إعادة تسمية ملف التنفيذ من agenteye إلى agenteye-collector. الاسم القصير agenteye ينتمي الآن إلى واجهة سطر أوامر AgentEye، وهي أداة منفصلة للاستعلام عن الجلسات والأحداث والتقييمات من الطرفية. يرشدك هذا الدليل عبر هجرة تثبيت جامع البيانات الموجود.

ما الذي تغير

	قبل	بعد
الأمر / ملف التنفيذ	`agenteye`	`agenteye-collector`
مسار التثبيت الافتراضي	`/usr/local/bin/agenteye`	`/usr/local/bin/agenteye-collector`
الأوامر الفرعية	`start`, `flush`, `health`, `update`	`start`, `flush`, `health`
التحديث الذاتي (`agenteye update`)	مدمج	محذوف: قم بتنزيل الملف الثنائي الجديد أو اسحب الصورة الجديدة
سكريبت التثبيت (`install.sh`)	مقدم	محذوف: قم بتنزيل الملف الثنائي مباشرة (انظر تثبيت جامع البيانات)
`AGENTEYE_TOKEN`	مطلوب للتنزيل و لفحوصات التحديث في الخلفية	مطلوب فقط لتنزيل الملفات الثنائية والصور

الإعدادات لم تتغير: نفس ~/.agenteye/config.json، ونفس متغيرات البيئة AGENTEYE_URL / AGENTEYE_KEY / AGENTEYE_HOME / TLS، ونفس سبول ~/.agenteye/events/. لا تحتاج إلى تحرير أي إعدادات.

إذا قمت بتشغيل الملف الثنائي المعاد تسميته تحت الاسم القديم agenteye، فإنه لا يزال يعمل لكنه يطبع رسالة تحذير إهمال بسطر واحد على stderr تذكرك بالتبديل إلى agenteye-collector.

قبل أن تبدأ

تثبيت agenteye الموجود يبقى قيد التشغيل؛ لا يتعطل شيء في لحظة التحديث. قم بالهجرة بعناية، ثم أزل الملف الثنائي القديم في النهاية فقط.
اتبع هذا الترتيب لتجنب توقف الخدمة:
1. ثبّت الملف الثنائي الجديد agenteye-collector (أو اسحب الصورة الجديدة).
2. حدّث تعريف الخدمة / مسبار الصحة / السكريبتات لاستدعاء agenteye-collector.
3. أعد تحميل الخدمة وأعد تشغيلها؛ تحقق من أنها سليمة.
4. فقط بعد ذلك أزل ملف الثنائي القديم /usr/local/bin/agenteye.

1. ثبّت الملف الثنائي الجديد

قم بتنزيل القطعة الأثرية لنظامك (agenteye-collector-linux-x86_64, agenteye-collector-darwin-arm64، وما إلى ذلك؛ انظر تثبيت جامع البيانات → الخيار أ للحصول على القائمة الكاملة) من أحدث إصدار collector/v<version> وضعها في /usr/local/bin/agenteye-collector. مستخدمو Docker: docker pull ghcr.io/agenteye-enterprise/collector:beta-latest (أو علامة :v<version> محددة، وهي مفضلة؛ :latest موجودة فقط للإصدارات المستقرة). تحقق:

agenteye-collector --version

2. حدّث نشرك

systemd (Linux)

عدّل /etc/systemd/system/agenteye-collector.service بحيث يشير ExecStart إلى الملف الثنائي الجديد:

[Service]
ExecStart=/usr/local/bin/agenteye-collector start

ثم أعد التحميل والتشغيل:

sudo systemctl daemon-reload
sudo systemctl restart agenteye-collector
sudo systemctl status agenteye-collector

launchd (macOS)

إعادة تسمية العلامة التجارية: إذا كان ملف plist الموجود لديك في المسار الأقدم ~/Library/LaunchAgents/host.exosphere.agenteye-collector.plist، أعد تسمية الملف إلى ai.befailproof.agenteye-collector.plist وغيّر أيضاً قيمة <key>Label</key> داخل الملف إلى المعرّف الجديد قبل إعادة التحميل.

في ~/Library/LaunchAgents/ai.befailproof.agenteye-collector.plist، غيّر إدخال ProgramArguments الأول من /usr/local/bin/agenteye إلى /usr/local/bin/agenteye-collector، ثم أعد التحميل:

launchctl unload ~/Library/LaunchAgents/ai.befailproof.agenteye-collector.plist
launchctl load   ~/Library/LaunchAgents/ai.befailproof.agenteye-collector.plist

supervisord

في كتلة برنامج supervisord الخاصة بك، عيّن command إلى الملف الثنائي الجديد:

[program:agenteye-collector]
command=/usr/local/bin/agenteye-collector start

ثم supervisorctl reread && supervisorctl update.

Docker / Kubernetes

اسحب الصورة الجديدة (ghcr.io/agenteye-enterprise/collector:beta-latest أو علامة :v<version> محددة، وهي مفضلة؛ :latest موجودة فقط للإصدارات المستقرة). نقطة الدخول في الصورة هي بالفعل agenteye-collector، لذا فإن نفس أمر docker run مع الأمر الفرعي start يستمر في العمل بدون أي تغيير. مهم: حدّث مسابير الصحة. إذا كنت تستخدم مسبار liveness/readiness في Kubernetes (أو أي docker exec) ينفذ الملف الثنائي بالاسم، غيّر الأمر إلى agenteye-collector:

livenessProbe:
  exec:
    command: ["agenteye-collector", "health"]

الصورة الجديدة لا تشحن بـ agenteye مستعار، لذا فإن مسبار يستدعي agenteye سيفشل. حدّث المسبار في نفس الإطلاق مع الصورة الجديدة.

Cron / السكريبتات اليدوية

استبدل أي استدعاء agenteye start|flush|health بأمر agenteye-collector start|flush|health المطابق. احذف أي وظائف cron لـ agenteye update؛ هذا الأمر الفرعي لم يعد موجوداً (انظر الترقيات من الآن فصاعداً).

3. أزل الملف الثنائي القديم (الأخير)

بعد أن تعمل الخدمة على agenteye-collector وتُبلّغ عن صحتها:

sudo rm /usr/local/bin/agenteye

هذا مهم خاصة إذا كنت تستخدم أيضاً واجهة سطر أوامر AgentEye، التي تثبت أمرها الخاص agenteye؛ ترك ملف جامع البيانات القديم في /usr/local/bin/agenteye سيجعل اسم agenteye غامضاً على PATH الخاص بك.

الترقيات من الآن فصاعداً

جامع البيانات لم يعد يحدث نفسه. للترقية:

الملف الثنائي: قم بتنزيل القطعة الأثرية الجديدة لنظامك (على سبيل المثال agenteye-collector-linux-x86_64؛ انظر تثبيت جامع البيانات → الخيار أ للحصول على القائمة الكاملة)، استبدل /usr/local/bin/agenteye-collector، وأعد تشغيل الخدمة.
Docker: docker pull ghcr.io/agenteye-enterprise/collector:beta-latest (أو علامة :v<version> محددة، وهي مفضلة؛ :latest موجودة فقط للإصدارات المستقرة) وأنشئ الحاوية مجدداً.

لا تزال AGENTEYE_TOKEN مطلوبة للتنزيل من مستودع الإصدارات الخاص، لكن الخادم قيد التشغيل لم يعد يحتاج إليها.

تحقق

agenteye-collector --version    # الملف الثنائي الجديد موجود على PATH
agenteye-collector health       # الخروج 0 = سليم
agenteye-collector flush        # يرسل أي أحداث في الطابور ويخرج بنظافة

ثم تأكد من ظهور الأحداث الجديدة في لوحة المعلومات الخاصة بك.

العودة للإصدار السابق

الهجرة غير مدمرة. إذا كنت بحاجة إلى العودة، وجّه تعريف الخدمة الخاص بك مرة أخرى إلى ملف الثنائي القديم /usr/local/bin/agenteye (طالما لم تزله بعد) وأعد التشغيل. سبول الأحداث والإعدادات مشتركة وغير متأثرة.

استكشاف الأخطاء والتحديث

الأعراض	السبب	الحل
`warning: the collector binary is now agenteye-collector …` في كل تشغيل	تستدعي الملف الثنائي تحت اسم `agenteye` القديم	استدعِ `agenteye-collector` بدلاً من ذلك؛ حدّث ملفات الخدمة والسكريبتات.
systemd يفشل: `.../agenteye: No such file or directory`	أزلت الملف الثنائي القديم قبل تحديث `ExecStart`	عيّن `ExecStart=/usr/local/bin/agenteye-collector start`، ثم `sudo systemctl daemon-reload`.
حاوية Kubernetes تدخل حلقة توقف بعد ترقية الصورة	مسبار liveness لا يزال يشغل `agenteye`	غيّر أمر المسبار إلى `["agenteye-collector", "health"]`.
`agenteye: command not found`، لكن `agenteye-collector` يعمل	السكريبتات/الأسماء المستعارة لا تزال تشير إلى الاسم القديم	حدّثها إلى `agenteye-collector`.
تشغيل `agenteye` يبدأ الواجهة وليس جامع البيانات	لديك واجهة سطر أوامر AgentEye مثبتة؛ تمتلك `agenteye`	استخدم `agenteye-collector` للخادم وأزل أي ملف جامع بيانات قديم متبقي في `/usr/local/bin/agenteye`.

​ما الذي تغير

​قبل أن تبدأ

​1. ثبّت الملف الثنائي الجديد

​2. حدّث نشرك

​systemd (Linux)

​launchd (macOS)

​supervisord

​Docker / Kubernetes

​Cron / السكريبتات اليدوية

​3. أزل الملف الثنائي القديم (الأخير)

​الترقيات من الآن فصاعداً

​تحقق

​العودة للإصدار السابق

​استكشاف الأخطاء والتحديث