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

# Migration vers `agenteye-collector`

> Documentation AgentEye pour la 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](/fr/agenteye/cli), 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](/fr/agenteye/collector-installation)) |
| `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](/fr/agenteye/collector-installation#option-a-binary-recommended) 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 :

```bash theme={null}
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 :

```ini theme={null}
[Service]
ExecStart=/usr/local/bin/agenteye-collector start
```

Puis rechargez et redémarrez :

```bash theme={null}
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 :

```bash theme={null}
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 :

```ini theme={null}
[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` :

```yaml theme={null}
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](#upgrades-from-now-on)).

***

## 3. Supprimer l'ancien binaire (en dernier)

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

```bash theme={null}
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](/fr/agenteye/collector-installation#option-a-binary-recommended) 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

```bash theme={null}
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`. |