> ## 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. # Migración a `agenteye-collector` > Documentación de AgentEye para migrar a `agenteye-collector`. La migración no es destructiva: no genera tiempo de inactividad ni pérdida de datos, y libera el nombre corto `agenteye` para la [CLI de AgentEye](/es/agenteye/cli), de modo que el demonio collector y la CLI puedan coexistir en el mismo equipo. El binario del collector ha sido **renombrado de `agenteye` a `agenteye-collector`**. El nombre corto `agenteye` ahora pertenece a la CLI de AgentEye, una herramienta independiente para consultar sesiones, eventos y evaluaciones desde tu terminal. Esta guía te orienta en el proceso de migración de una instalación existente del collector. *** ## Qué cambió | | Antes | Después | | -------------------------------------- | ------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------- | | Comando / binario | `agenteye` | `agenteye-collector` | | Ruta de instalación predeterminada | `/usr/local/bin/agenteye` | `/usr/local/bin/agenteye-collector` | | Subcomandos | `start`, `flush`, `health`, `update` | `start`, `flush`, `health` | | Auto-actualización (`agenteye update`) | integrada | **eliminada**: descarga el nuevo binario o extrae la nueva imagen | | Script de instalación (`install.sh`) | incluido | **eliminado**: descarga el binario directamente (consulta [Instalación del Collector](/es/agenteye/collector-installation)) | | `AGENTEYE_TOKEN` | necesario para descargar **y** para comprobaciones de actualización en segundo plano | necesario solo para **descargar** binarios/imágenes | La configuración no cambia: el mismo `~/.agenteye/config.json`, las mismas variables de entorno `AGENTEYE_URL` / `AGENTEYE_KEY` / `AGENTEYE_HOME` / TLS, y el mismo spool `~/.agenteye/events/`. **No se requieren cambios en la configuración.** > Si ejecutas el binario renombrado con el nombre antiguo `agenteye`, seguirá funcionando, pero imprimirá una advertencia de deprecación de una línea en stderr recordándote que debes cambiar a `agenteye-collector`. *** ## Antes de comenzar * Tu **instalación existente de `agenteye` seguirá funcionando**; nada se rompe en el momento en que actualices. Migra de forma deliberada y elimina el binario antiguo al final. * Sigue este orden para evitar tiempos de inactividad: 1. Instala el nuevo binario `agenteye-collector` (o extrae la nueva imagen). 2. Actualiza tu definición de servicio, sondas de salud y scripts para que llamen a `agenteye-collector`. 3. Recarga y reinicia el servicio; confirma que está en buen estado. 4. **Solo entonces** elimina el binario antiguo `/usr/local/bin/agenteye`. *** ## 1. Instala el nuevo binario Descarga el artefacto para tu plataforma (`agenteye-collector-linux-x86_64`, `agenteye-collector-darwin-arm64`, etc.; consulta [Instalación del Collector → Opción A](/es/agenteye/collector-installation#option-a-binary-recommended) para la lista completa) desde la última versión `collector/v` y colócalo en `/usr/local/bin/agenteye-collector`. Usuarios de Docker: `docker pull ghcr.io/agenteye-enterprise/collector:beta-latest` (o una etiqueta fija `:v`, que es preferible; `:latest` solo existe para versiones estables). Verifica: ```bash theme={null} agenteye-collector --version ``` *** ## 2. Actualiza tu despliegue ### systemd (Linux) Edita `/etc/systemd/system/agenteye-collector.service` para que `ExecStart` apunte al nuevo binario: ```ini theme={null} [Service] ExecStart=/usr/local/bin/agenteye-collector start ``` Luego recarga y reinicia: ```bash theme={null} sudo systemctl daemon-reload sudo systemctl restart agenteye-collector sudo systemctl status agenteye-collector ``` ### launchd (macOS) > **Cambio de nombre:** Si tu plist existente se encuentra en la ruta anterior > `~/Library/LaunchAgents/host.exosphere.agenteye-collector.plist`, renombra > el archivo a `ai.befailproof.agenteye-collector.plist` y cambia también el > valor de `Label` dentro del archivo al nuevo identificador antes > de recargarlo. En `~/Library/LaunchAgents/ai.befailproof.agenteye-collector.plist`, cambia la primera entrada de `ProgramArguments` de `/usr/local/bin/agenteye` a `/usr/local/bin/agenteye-collector` y luego recarga: ```bash theme={null} launchctl unload ~/Library/LaunchAgents/ai.befailproof.agenteye-collector.plist launchctl load ~/Library/LaunchAgents/ai.befailproof.agenteye-collector.plist ``` ### supervisord En tu bloque de programa `supervisord`, establece `command` con el nuevo binario: ```ini theme={null} [program:agenteye-collector] command=/usr/local/bin/agenteye-collector start ``` Luego ejecuta `supervisorctl reread && supervisorctl update`. ### Docker / Kubernetes Extrae la nueva imagen (`ghcr.io/agenteye-enterprise/collector:beta-latest` o una etiqueta fija `:v`, que es preferible; `:latest` solo existe para versiones estables). El punto de entrada de la imagen ya es `agenteye-collector`, por lo que el mismo comando `docker run` con el subcomando `start` seguirá funcionando sin ningún cambio. **Importante: actualiza las sondas de salud.** Si usas una sonda de liveness/readiness de Kubernetes (o cualquier `docker exec`) que ejecuta el binario por nombre, cambia el comando a `agenteye-collector`: ```yaml theme={null} livenessProbe: exec: command: ["agenteye-collector", "health"] ``` La nueva imagen **no** incluye un alias `agenteye`, por lo que una sonda que siga llamando a `agenteye` fallará. Actualiza la sonda en el mismo despliegue que la nueva imagen. ### Cron / scripts manuales Reemplaza cualquier invocación de `agenteye start|flush|health` por el comando equivalente `agenteye-collector start|flush|health`. **Elimina cualquier cron job de `agenteye update`**; ese subcomando ya no existe (consulta [Actualizaciones a partir de ahora](#upgrades-from-now-on)). *** ## 3. Elimina el binario antiguo (al final) Una vez que el servicio esté ejecutándose con `agenteye-collector` y reportado como saludable: ```bash theme={null} sudo rm /usr/local/bin/agenteye ``` Esto es especialmente importante si también usas la CLI de AgentEye, que instala su propio comando `agenteye`; dejar el binario antiguo del collector en `/usr/local/bin/agenteye` haría que el nombre `agenteye` fuera ambiguo en tu `PATH`. *** ## Actualizaciones a partir de ahora El collector ya no se actualiza a sí mismo. Para actualizar: * **Binario:** descarga el nuevo artefacto para tu plataforma (por ejemplo `agenteye-collector-linux-x86_64`; consulta [Instalación del Collector → Opción A](/es/agenteye/collector-installation#option-a-binary-recommended) para la lista completa), reemplaza `/usr/local/bin/agenteye-collector` y reinicia el servicio. * **Docker:** ejecuta `docker pull ghcr.io/agenteye-enterprise/collector:beta-latest` (o una etiqueta fija `:v`, que es preferible; `:latest` solo existe para versiones estables) y vuelve a crear el contenedor. `AGENTEYE_TOKEN` sigue siendo necesario para descargar desde el repositorio de versiones privado, pero el demonio en ejecución ya no lo necesita. *** ## Verificar ```bash theme={null} agenteye-collector --version # el nuevo binario está en PATH agenteye-collector health # código de salida 0 = saludable agenteye-collector flush # reenvía los eventos en cola y termina correctamente ``` Luego confirma que los nuevos eventos aparecen en tu panel de control. *** ## Reversión La migración no es destructiva. Si necesitas revertirla, apunta la definición de tu servicio de nuevo al binario antiguo `/usr/local/bin/agenteye` (siempre que aún no lo hayas eliminado) y reinicia. El spool de eventos y la configuración son compartidos y no se ven afectados. *** ## Solución de problemas | Síntoma | Causa | Solución | | ----------------------------------------------------------------------------- | ---------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ | | `warning: the collector binary is now agenteye-collector …` en cada ejecución | Estás invocando el binario con el nombre antiguo `agenteye` | Llama a `agenteye-collector` en su lugar; actualiza los archivos de servicio y scripts. | | systemd falla: `.../agenteye: No such file or directory` | Eliminaste el binario antiguo antes de actualizar `ExecStart` | Establece `ExecStart=/usr/local/bin/agenteye-collector start` y luego ejecuta `sudo systemctl daemon-reload`. | | El pod de Kubernetes entra en crash-loop después de actualizar la imagen | La sonda de liveness sigue ejecutando `agenteye` | Cambia el comando de la sonda a `["agenteye-collector", "health"]`. | | `agenteye: command not found`, pero `agenteye-collector` funciona | Los scripts/alias siguen haciendo referencia al nombre antiguo | Actualízalos a `agenteye-collector`. | | Ejecutar `agenteye` inicia la CLI, no el collector | Tienes la CLI de AgentEye instalada; esta es propietaria de `agenteye` | Usa `agenteye-collector` para el demonio y elimina cualquier binario antiguo del collector en `/usr/local/bin/agenteye`. |