Migration vers `agenteye-collector`

La migration est non-destructive : elle n’entraîne aucune interruption de service ni perte de données, et elle libère le nom court agenteye pour l’interface en ligne de commande AgentEye, permettant ainsi au daemon collecteur et à la CLI de coexister sur la même machine. Le binaire du collecteur a été renommé de agenteye en agenteye-collector. Le nom court agenteye appartient désormais à la CLI AgentEye, un outil distinct permettant d’interroger les sessions, événements et évaluations depuis votre terminal. Ce guide vous accompagne dans la migration d’une installation existante du collecteur.

Ce qui a changé

	Avant	Après
Commande / binaire	`agenteye`	`agenteye-collector`
Chemin d’installation par défaut	`/usr/local/bin/agenteye`	`/usr/local/bin/agenteye-collector`
Sous-commandes	`start`, `flush`, `health`, `update`	`start`, `flush`, `health`
Mise à jour automatique (`agenteye update`)	intégrée	supprimée : téléchargez le nouveau binaire ou récupérez la nouvelle image
Script d’installation (`install.sh`)	fourni	supprimé : téléchargez directement le binaire (voir Installation du collecteur)
`AGENTEYE_TOKEN`	requis pour le téléchargement et les vérifications de mises à jour en arrière-plan	requis uniquement pour télécharger les binaires/images

La configuration est inchangée : le même fichier ~/.agenteye/config.json, les mêmes variables d’environnement AGENTEYE_URL / AGENTEYE_KEY / AGENTEYE_HOME / TLS, et le même répertoire de spool ~/.agenteye/events/. Aucune modification de configuration n’est requise.

Si vous exécutez le binaire renommé sous l’ancien nom agenteye, cela fonctionne toujours, mais un avertissement de dépréciation sur une seule ligne est affiché sur stderr pour vous rappeler de basculer vers agenteye-collector.

Avant de commencer

Votre installation agenteye existante continue de fonctionner ; rien ne se casse au moment où vous effectuez la mise à niveau. Procédez à la migration de manière délibérée, puis supprimez l’ancien binaire en dernier.
Respectez cet ordre pour éviter toute interruption de service :
1. Installez le nouveau binaire agenteye-collector (ou récupérez la nouvelle image).
2. Mettez à jour votre définition de service / sonde de santé / scripts pour appeler agenteye-collector.
3. Rechargez et redémarrez le service ; confirmez qu’il est opérationnel.
4. Seulement ensuite, supprimez l’ancien binaire /usr/local/bin/agenteye.

1. Installer le nouveau binaire

Téléchargez l’artefact correspondant à votre plateforme (agenteye-collector-linux-x86_64, agenteye-collector-darwin-arm64, etc. ; consultez Installation du collecteur → Option A pour la liste complète) depuis la dernière version collector/v<version> et placez-le à l’emplacement /usr/local/bin/agenteye-collector. Pour les utilisateurs Docker : docker pull ghcr.io/agenteye-enterprise/collector:beta-latest (ou un tag :v<version> épinglé, ce qui est recommandé ; :latest n’existe que pour les versions stables). Vérification :

agenteye-collector --version

2. Mettre à jour votre déploiement

systemd (Linux)

Modifiez /etc/systemd/system/agenteye-collector.service pour que ExecStart pointe vers le nouveau binaire :

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

Puis rechargez et redémarrez :

sudo systemctl daemon-reload
sudo systemctl restart agenteye-collector
sudo systemctl status agenteye-collector

launchd (macOS)

Renommage de marque : Si votre plist existant se trouve à l’ancien chemin ~/Library/LaunchAgents/host.exosphere.agenteye-collector.plist, renommez le fichier en ai.befailproof.agenteye-collector.plist et modifiez également la valeur <key>Label</key> dans le fichier pour utiliser le nouvel identifiant avant de recharger.

Dans ~/Library/LaunchAgents/ai.befailproof.agenteye-collector.plist, remplacez la première entrée ProgramArguments de /usr/local/bin/agenteye par /usr/local/bin/agenteye-collector, puis rechargez :

launchctl unload ~/Library/LaunchAgents/ai.befailproof.agenteye-collector.plist
launchctl load   ~/Library/LaunchAgents/ai.befailproof.agenteye-collector.plist

supervisord

Dans votre bloc de programme supervisord, définissez command avec le nouveau binaire :

[program:agenteye-collector]
command=/usr/local/bin/agenteye-collector start

Puis exécutez supervisorctl reread && supervisorctl update.

Docker / Kubernetes

Récupérez la nouvelle image (ghcr.io/agenteye-enterprise/collector:beta-latest ou un tag :v<version> épinglé, ce qui est recommandé ; :latest n’existe que pour les versions stables). Le point d’entrée de l’image est déjà agenteye-collector, donc la même commande docker run avec le sous-commande start continue de fonctionner sans modification. Important : mettez à jour les sondes de santé. Si vous utilisez une sonde de vivacité/disponibilité Kubernetes (ou tout docker exec) qui exécute le binaire par son nom, modifiez la commande pour utiliser agenteye-collector :

livenessProbe:
  exec:
    command: ["agenteye-collector", "health"]

La nouvelle image ne contient pas d’alias agenteye, donc une sonde qui appelle encore agenteye échouera. Mettez à jour la sonde dans le même déploiement que la nouvelle image.

Cron / scripts manuels

Remplacez toutes les invocations agenteye start|flush|health par la commande correspondante agenteye-collector start|flush|health. Supprimez toutes les tâches cron agenteye update ; ce sous-commande n’existe plus (voir Mises à niveau à partir de maintenant).

3. Supprimer l’ancien binaire (en dernier)

Une fois que le service fonctionne avec agenteye-collector et signale un état sain :

sudo rm /usr/local/bin/agenteye

Cela est particulièrement important si vous utilisez également la CLI AgentEye, qui installe sa propre commande agenteye ; laisser l’ancien binaire du collecteur à /usr/local/bin/agenteye rendrait le nom agenteye ambigu dans votre PATH.

Mises à niveau à partir de maintenant

Le collecteur ne se met plus à jour automatiquement. Pour effectuer une mise à niveau :

Binaire : téléchargez le nouvel artefact pour votre plateforme (par exemple agenteye-collector-linux-x86_64 ; consultez Installation du collecteur → Option A pour la liste complète), remplacez /usr/local/bin/agenteye-collector et redémarrez le service.
Docker : docker pull ghcr.io/agenteye-enterprise/collector:beta-latest (ou un tag :v<version> épinglé, ce qui est recommandé ; :latest n’existe que pour les versions stables) et recréez le conteneur.

AGENTEYE_TOKEN est toujours requis pour télécharger depuis le dépôt de versions privé, mais le daemon en cours d’exécution n’en a plus besoin.

Vérification

agenteye-collector --version    # le nouveau binaire est dans le PATH
agenteye-collector health       # code de sortie 0 = opérationnel
agenteye-collector flush        # transfère les événements en file d'attente et se termine proprement

Confirmez ensuite que les nouveaux événements apparaissent dans votre tableau de bord.

Retour arrière

La migration est non-destructive. Si vous devez effectuer un retour arrière, pointez à nouveau votre définition de service vers l’ancien binaire /usr/local/bin/agenteye (tant que vous ne l’avez pas encore supprimé) et redémarrez. Le spool d’événements et la configuration sont partagés et non affectés.

Résolution des problèmes

Symptôme	Cause	Solution
`warning: the collector binary is now agenteye-collector …` à chaque exécution	Vous invoquez le binaire sous l’ancien nom `agenteye`	Appelez `agenteye-collector` à la place ; mettez à jour les fichiers de service et les scripts.
systemd échoue : `.../agenteye: No such file or directory`	Vous avez supprimé l’ancien binaire avant de mettre à jour `ExecStart`	Définissez `ExecStart=/usr/local/bin/agenteye-collector start`, puis exécutez `sudo systemctl daemon-reload`.
Le pod Kubernetes redémarre en boucle après la mise à jour de l’image	La sonde de vivacité exécute encore `agenteye`	Modifiez la commande de la sonde en `["agenteye-collector", "health"]`.
`agenteye: command not found`, mais `agenteye-collector` fonctionne	Les scripts/alias référencent encore l’ancien nom	Mettez-les à jour pour utiliser `agenteye-collector`.
L’exécution de `agenteye` lance la CLI, pas le collecteur	La CLI AgentEye est installée et possède `agenteye`	Utilisez `agenteye-collector` pour le daemon et supprimez tout ancien binaire du collecteur présent à `/usr/local/bin/agenteye`.

​Ce qui a changé

​Avant de commencer

​1. Installer le nouveau binaire

​2. Mettre à jour votre déploiement

​systemd (Linux)

​launchd (macOS)

​supervisord

​Docker / Kubernetes

​Cron / scripts manuels

​3. Supprimer l’ancien binaire (en dernier)

​Mises à niveau à partir de maintenant

​Vérification

​Retour arrière

​Résolution des problèmes