Migración 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, 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)
`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 para la lista completa) desde la última versión collector/v<version> 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<version>, que es preferible; :latest solo existe para versiones estables). Verifica:

agenteye-collector --version

2. Actualiza tu despliegue

systemd (Linux)

Edita /etc/systemd/system/agenteye-collector.service para que ExecStart apunte al nuevo binario:

[Service]
ExecStart=/usr/local/bin/agenteye-collector start

Luego recarga y reinicia:

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 <key>Label</key> 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:

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:

[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<version>, 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:

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).

3. Elimina el binario antiguo (al final)

Una vez que el servicio esté ejecutándose con agenteye-collector y reportado como saludable:

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 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<version>, 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

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`.

​Qué cambió

​Antes de comenzar

​1. Instala el nuevo binario

​2. Actualiza tu despliegue

​systemd (Linux)

​launchd (macOS)

​supervisord

​Docker / Kubernetes

​Cron / scripts manuales

​3. Elimina el binario antiguo (al final)

​Actualizaciones a partir de ahora

​Verificar

​Reversión

​Solución de problemas