> ## 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 CLI](/he/agenteye/cli) כך שדמון המאספן ו-CLI יכולים להתקיים באותה מכונה.

קובץ המאספן קיבל **שינוי שם מ-`agenteye` ל-`agenteye-collector`**. השם הקצר `agenteye` שייך כעת ל-AgentEye CLI, כלי נפרד לשאילתות על הפעלות, אירועים והערכות מהטרמינל שלך.

המדריך הזה מובילך דרך עברה של התקנה קיימת של מאספן.

***

## מה השתנה

|                                | לפני                                    | אחרי                                                                                               |
| ------------------------------ | --------------------------------------- | -------------------------------------------------------------------------------------------------- |
| פקודה / קובץ בינארי            | `agenteye`                              | `agenteye-collector`                                                                               |
| נתיב התקנה ברירת מחדל          | `/usr/local/bin/agenteye`               | `/usr/local/bin/agenteye-collector`                                                                |
| תת-פקודות                      | `start`, `flush`, `health`, `update`    | `start`, `flush`, `health`                                                                         |
| עדכון עצמי (`agenteye update`) | מובנה                                   | **הוסר**: הורד את הקובץ הבינארי החדש או שלוף את התמונה החדשה                                       |
| סקריפט התקנה (`install.sh`)    | מסופק                                   | **הוסר**: הורד את הקובץ הבינארי ישירות (ראה [התקנה של מאספן](/he/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`, וכו'; ראה [התקנה של מאספן → אפשרות A](/he/agenteye/collector-installation#option-a-binary-recommended) לרשימה המלאה) מהרלease `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` ממשיכה לעבוד ללא שינוי.

**חשוב: עדכן בדיקות בריאות.** אם אתה משתמש בבדיקת Kubernetes liveness/readiness (או כל `docker exec`) שמריצה את הקובץ הבינארי לפי שם, שנה את הפקודה ל-`agenteye-collector`:

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

התמונה החדשה **לא** משלחת כינוי `agenteye`, אז בדיקה שעדיין קוראת ל-`agenteye` תכשל. עדכן את הבדיקה באותו rollout כמו התמונה החדשה.

### 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 CLI, שמתקין את הפקודה `agenteye` שלו; השארת קובץ המאספן הישן ב-`/usr/local/bin/agenteye` תעשה את שם `agenteye` דו-משמעי ב-`PATH` שלך.

***

## שדרוגים מעכשיו והלאה

המאספן כבר לא מעדכן את עצמו. כדי לשדרג:

* **קובץ בינארי:** הורד את התוצר החדש עבור הפלטפורמה שלך (לדוגמה `agenteye-collector-linux-x86_64`; ראה [התקנה של מאספן → אפשרות A](/he/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` עדיין נדרש להורדה מאחסן ה-releases הפרטי, אך דמון ריצה כבר לא צריך אותו.

***

## אשר

```bash theme={null}
agenteye-collector --version    # קובץ בינארי חדש ב-PATH
agenteye-collector health       # exit 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`.           |
| Pod של Kubernetes נכנס ללולאות קריסה אחרי שדרוג התמונה               | בדיקת liveness עדיין מריצה `agenteye`             | שנה את פקודת הבדיקה ל-`["agenteye-collector", "health"]`.                                               |
| `agenteye: command not found`, אבל `agenteye-collector` עובד         | סקריפטים/כינויים עדיין מתייחסים לשם הישן          | עדכן אותם ל-`agenteye-collector`.                                                                       |
| הרצת `agenteye` מתחילה את ה-CLI, לא את המאספן                        | אתה בעל AgentEye CLI מותקן; הוא בעלי `agenteye`   | השתמש ב-`agenteye-collector` עבור דמון והסר כל קובץ בינארי מאספן ישן שנותר ב-`/usr/local/bin/agenteye`. |