Миграция на `agenteye-collector`

Миграция не деструктивна: она не вызывает простоев и потери данных, а также освобождает короткое имя agenteye для 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`)	предоставляется	удалено: загрузите бинарный файл напрямую (см. Установка сборщика)
`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 для полного списка) из последнего релиза 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 продолжает работать без изменений. Важно: обновите зонды здоровья. Если вы используете зонд живучести/готовности 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 CLI, который устанавливает собственную команду agenteye; оставление старого бинарного файла сборщика в /usr/local/bin/agenteye сделает имя agenteye неоднозначным в вашем PATH.

Обновления с этого момента

Сборщик больше не обновляет себя. Для обновления:

Бинарный файл: загрузите новый артефакт для вашей платформы (например agenteye-collector-linux-x86_64; см. Установка сборщика → Вариант A для полного списка), замените /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       # 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`.

​Что изменилось

​Прежде чем начать

​1. Установите новый бинарный файл

​2. Обновите ваше развёртывание

​systemd (Linux)

​launchd (macOS)

​supervisord

​Docker / Kubernetes

​Cron / ручные скрипты

​3. Удалите старый бинарный файл (последним)

​Обновления с этого момента

​Проверка

​Откат

​Поиск и устранение неисправностей