> ## Documentation Index
> Fetch the complete documentation index at: https://docs.befailproof.ai/llms.txt
> Use this file to discover all available pages before exploring further.

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

> وثائق AgentEye حول الهجرة إلى `agenteye-collector`.

الهجرة غير مدمرة: لا تسبب أي توقف للخدمة ولا فقدان بيانات، وتحرر الاسم القصير `agenteye` ل[واجهة سطر أوامر AgentEye](/ar/agenteye/cli) بحيث يمكن لخادم جامع البيانات والواجهة أن يعملا معاً على نفس الجهاز.

تم **إعادة تسمية ملف التنفيذ من `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`)      | مقدم                                           | **محذوف**: قم بتنزيل الملف الثنائي مباشرة (انظر [تثبيت جامع البيانات](/ar/agenteye/collector-installation)) |
| `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`، وما إلى ذلك؛ انظر [تثبيت جامع البيانات → الخيار أ](/ar/agenteye/collector-installation#option-a-binary-recommended) للحصول على القائمة الكاملة) من أحدث إصدار `collector/v<version>` وضعها في `/usr/local/bin/agenteye-collector`. مستخدمو Docker: `docker pull ghcr.io/agenteye-enterprise/collector:beta-latest` (أو علامة `:v<version>` محددة، وهي مفضلة؛ `:latest` موجودة فقط للإصدارات المستقرة).

تحقق:

```bash theme={null}
agenteye-collector --version
```

***

## 2. حدّث نشرك

### systemd (Linux)

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

```ini theme={null}
[Service]
ExecStart=/usr/local/bin/agenteye-collector start
```

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

```bash theme={null}
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`، ثم أعد التحميل:

```bash theme={null}
launchctl unload ~/Library/LaunchAgents/ai.befailproof.agenteye-collector.plist
launchctl load   ~/Library/LaunchAgents/ai.befailproof.agenteye-collector.plist
```

### supervisord

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

```ini theme={null}
[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`:

```yaml theme={null}
livenessProbe:
  exec:
    command: ["agenteye-collector", "health"]
```

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

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

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

***

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

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

```bash theme={null}
sudo rm /usr/local/bin/agenteye
```

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

***

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

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

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

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

***

## تحقق

```bash theme={null}
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`. |