> ## 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](/ru/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`)    | предоставляется                                               | **удалено**: загрузите бинарный файл напрямую (см. [Установка сборщика](/ru/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](/ru/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` продолжает работать без изменений.

**Важно: обновите зонды здоровья.** Если вы используете зонд живучести/готовности 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`**; эта подкоманда больше не существует (см. [Обновления с этого момента](#обновления-с-этого-момента)).

***

## 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](/ru/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       # 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 зависает в цикле сбоев после обновления образа                  | Зонд живучести всё ещё запускает `agenteye`                   | Измените команду зонда на `["agenteye-collector", "health"]`.                                                               |
| `agenteye: command not found`, но `agenteye-collector` работает                | Скрипты/псевдонимы всё ещё ссылаются на старое имя            | Обновите их на `agenteye-collector`.                                                                                        |
| Запуск `agenteye` запускает CLI, а не сборщик                                  | У вас установлен AgentEye CLI; он владеет `agenteye`          | Используйте `agenteye-collector` для демона и удалите оставшийся старый бинарный файл сборщика в `/usr/local/bin/agenteye`. |