Un agent n'apparaît pas ou reste hors ligne
Les vérifications à faire, dans l'ordre, quand un agent ne s'enregistre pas, passe hors ligne ou n'envoie plus rien.
La console affiche un agent En ligne quand il a donné signe de vie depuis moins de 5 minutes. Si ce n'est pas le cas, faites les vérifications dans l'ordre : chacune écarte une cause.
1. Le service tourne-t-il ?
Sur la machine, ouvrez Services (services.msc). First SI - FSI Agent doit être En cours d'exécution, avec un démarrage Automatique.
Get-Service | Where-Object DisplayName -like "First SI*"S'il est arrêté, démarrez-le. S'il s'arrête aussitôt, allez directement à l'étape 4 et lisez le journal.
2. La machine joint-elle le serveur ?
L'agent parle au serveur en HTTPS, en général sur le port 443.
Test-NetConnection console.exemple.fr -Port 443Si vous obtenez TcpTestSucceeded : False, un pare-feu ou un proxy bloque. Pour un réseau sans accès direct, configurez une sortie par relais ou proxy.
3. L'installation avait-elle les bonnes valeurs ?
SERVERURL doit être l'adresse exacte de la console, en https://. APIKEY doit être la clé d'enregistrement actuelle, celle de Paramètres → Organisation : si quelqu'un l'a régénérée entre-temps, l'ancienne ne permet plus d'enregistrer un agent.
Ces valeurs ne sont lues qu'à la première installation. Pour les corriger, désinstallez puis réinstallez avec la bonne ligne de commande (Installer l'agent).
4. Que dit le journal de l'agent ?
Le journal se trouve dans le dossier logs du dossier d'installation (C:\Program Files\First SI\FSI Agent\logs). Regardez les dernières erreurs. Un 401 veut dire que le serveur refuse la clé. Un délai dépassé pointe vers le réseau. Un certificat refusé signale le plus souvent un proxy qui inspecte le HTTPS.
5. Un antivirus l'a-t-il bloqué ?
L'agent lit des informations système (tables de connexions, processus, journaux d'événements), ce qui peut intriguer un antivirus. Le MSI pose par défaut une exclusion Windows Defender (DEFENDEREXCLUSION=true). Avec un autre antivirus, excluez vous-même le dossier d'installation (Program Files\First SI\FSI Agent) et le processus de l'agent.
L'agent est en ligne, mais un module n'envoie rien
Commencez par vérifier que le module est bien activé sur la carte de l'agent (Configurer). Ensuite, cela dépend du module :
| Module | À vérifier |
|---|---|
| FileMonitor | L'audit Windows et les SACL sont-ils en place ? Voir FileMonitor |
| SI-Tracer | L'agent est-il sur un contrôleur de domaine ? |
| DBMonitor | L'instance est-elle déclarée, avec les droits de lecture des vues système ? |
| Collector | Les équipements sont-ils déclarés avec la bonne adresse d'émission ? Voir Pare-feu |
| Annuaire | L'agent est-il sur un serveur membre du domaine, et non sur un contrôleur ? Voir Annuaire |
Si tous les agents d'un même site passent hors ligne en même temps, le problème vient plutôt du réseau du site (lien coupé, tunnel tombé) que des agents. Regardez du côté de NetworkMonitor.
Source : · Docs FirstSI · mis à jour le 10/10/2026