> For the complete documentation index, see [llms.txt](https://wiki.datadike.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.datadike.com/fr/sonar/deploy-operate/troubleshooting.md).

# Dépanner les agents

Diagnostiquez les agents Offline, Overdue ou Remote Offline, les actions en attente bloquées et les erreurs d'installateur, avec journaux et commandes par système.

## Ce que c'est et quand l'utiliser

Utilisez cette page lorsqu'un appareil ne remonte pas d'informations, les remonte en retard, ne peut pas être joint pour la prise de contrôle à distance, ou lorsqu'une installation échoue. Elle part de ce qu'affiche la console, puis passe à l'appareil : ses services, son journal et son chemin réseau jusqu'à SONAR.

## Avant de commencer

* Votre rôle vous permet de voir l'appareil dans **Dashboard › Sysadmin**. L'onglet **Debug** nécessite **View Debug Logs** ; **Agents › Pending Actions** nécessite **List Pending Actions**, et l'annulation d'une action nécessite **Manage Pending Actions** ; **Restart Remote Service** nécessite **Use Mesh**.
* Pour les vérifications sur l'appareil lui-même, il vous faut les droits d'administrateur sur Windows, ou `root` sur Linux et macOS.

## Comment la console détermine l'état d'un appareil

L'agent envoie un signal de vie (heartbeat) à SONAR toutes les 30 à 60 secondes par sa connexion à l'adresse de l'API. **Last Response**, dans la liste des appareils, est l'heure à laquelle SONAR a reçu le dernier. L'heure est relevée par SONAR à l'arrivée, si bien que l'horloge de l'appareil n'a aucun effet sur l'état.

**Agent Status** compare **Last Response** à deux seuils définis par appareil dans **Edit** (menu d'actions de l'appareil) :

| État        | Signification                                                                                                                    |
| ----------- | -------------------------------------------------------------------------------------------------------------------------------- |
| **Online**  | Dernier contact plus récent que **Offline after (minutes)**                                                                      |
| **Offline** | Aucun contact depuis plus longtemps que **Offline after (minutes)**                                                              |
| **Overdue** | Aucun contact depuis plus longtemps que **Overdue after (minutes)**. Les alertes de retard sont déclenchées à partir de cet état |

Les seuils peuvent être longs, c'est pourquoi **Last Response** est le signal le plus rapide : un **Last Response** vieux de plus de quelques minutes signifie que l'agent n'est pas connecté en ce moment, quel que soit l'état affiché.

Le panneau **Filters** de la liste des appareils regroupe les appareils par fenêtres fixes sous **Availability** : **Online**, **Offline 12+ hours**, **Offline 24+ hours**, **Offline 7+ days**, **Overdue** et **Maintenance Mode**.

Le panneau de détails ajoute l'état de l'agent d'accès à distance : **Remote Online**, **Remote Offline** ou **Remote Unknown**.

## Étapes

### Un appareil apparaît Offline ou Overdue

1. **L'appareil est-il allumé et connecté ?** Vérifiez qu'il est sous tension et sur un réseau. Un appareil éteint ou en veille apparaît **Offline** puis **Overdue**, et c'est le comportement prévu.
2. **Le service de l'agent s'exécute-t-il ?** Sur l'appareil :

   | Plateforme | Vérifier                                                                 | Démarrer ou redémarrer                                                 |
   | ---------- | ------------------------------------------------------------------------ | ---------------------------------------------------------------------- |
   | Windows    | `sc query sonarrmm`, ou **Sonar Agent Service** dans la console Services | `net start sonarrmm`, ou `net stop sonarrmm` puis `net start sonarrmm` |
   | Linux      | `systemctl status sonaragent`                                            | `sudo systemctl restart sonaragent`                                    |
   | macOS      | `sudo launchctl print system/sonaragent`                                 | `sudo launchctl kickstart -k system/sonaragent`                        |

   Si le service n'existe pas, l'agent a été désinstallé : réinstallez-le.
3. **L'appareil joint-il SONAR ?** Depuis l'appareil, testez le port 443/tcp vers l'adresse de l'API : `Test-NetConnection api.example.com -Port 443` sur Windows, `curl` sur Linux et macOS. Un proxy ou une inspection TLS sur le chemin peut laisser passer le HTTPS tout en cassant la connexion WebSocket de longue durée. Consultez [Prérequis réseau](https://wiki.datadike.com/fr/sonar/deploy-operate/network-requirements.md).
4. **Que dit le journal de l'agent ?** Lisez les dernières lignes du journal (voir [Journaux de l'agent](#journaux-de-lagent)). Les erreurs de connexion à l'adresse de l'API désignent le réseau ; les erreurs juste après le démarrage désignent la configuration locale.
5. Après une correction, redémarrez le service de l'agent. **Last Response** se met à jour en moins d'une minute et **Agent Status** revient à **Online**.

### Un appareil apparaît Remote Offline

**Remote Offline** signifie que l'agent SONAR est connecté, mais pas l'agent d'accès à distance. **Take Control** reste désactivé jusqu'à ce que l'agent d'accès à distance se reconnecte.

1. Sélectionnez l'appareil. Tant que l'agent est **Online** et que l'agent d'accès à distance est hors ligne, l'en-tête du panneau de détails propose **Restart Remote Service**.
2. Cliquez dessus. SONAR demande à l'agent de redémarrer l'agent d'accès à distance sur l'appareil (*Attempting to repair Mesh Agent*), puis indique *Repaired mesh agent on \<hostname>* une fois l'opération terminée.
3. Si l'indicateur ne passe pas à **Remote Online** en quelques minutes, redémarrez l'agent d'accès à distance sur l'appareil :

   | Plateforme | Commande                                              |
   | ---------- | ----------------------------------------------------- |
   | Windows    | `net stop "Mesh Agent"` puis `net start "Mesh Agent"` |
   | Linux      | `sudo systemctl restart meshagent`                    |
   | macOS      | `sudo launchctl kickstart -k system/meshagent`        |
4. S'il reste hors ligne, vérifiez que l'appareil joint l'adresse d'accès à distance en 443/tcp, avec l'upgrade WebSocket autorisé.
5. Si l'agent d'accès à distance est absent de l'appareil, réinstallez l'agent SONAR (voir [Réinstaller par-dessus un agent existant](#reinstaller-par-dessus-un-agent-existant)).

Sur macOS, *Operation not permitted* dans **Terminal** ou **File Browser** à l'intérieur des dossiers Desktop, Documents ou Downloads d'un utilisateur est une question d'autorisations, pas de connexion. Consultez [Installer l'agent sur macOS](https://wiki.datadike.com/fr/sonar/deploy-operate/install-agent-macos.md#dossiers-proteges-par-macos).

### Les actions en attente ne se terminent pas

**Agents › Pending Actions** (**All Pending Actions**) liste le travail que SONAR tient en réserve pour les appareils : mises à jour de l'agent (*Agent update to \<version>*), redémarrages planifiés (*Device pending reboot*), installations de logiciels (*\<name> software install*) et autres tâches en file d'attente. Pour un seul appareil, utilisez **Pending Agent Actions** dans son menu d'actions, ou regardez la colonne **Pending Actions** de la liste des appareils.

1. Ouvrez la liste et repérez l'appareil.
2. Consultez la colonne **Due**. Une mise à jour de l'agent est prévue au prochain cycle de mise à jour, à la 35e minute de l'heure ; un redémarrage planifié, à l'heure pour laquelle il a été fixé.
3. Une action en attente le reste tant que l'appareil est hors ligne. Commencez par remettre l'appareil en ligne (voir ci-dessus).
4. Pour une installation de logiciel terminée, **View output** affiche ce que l'installateur a produit en sortie (**Pending Action Output Details**).
5. Pour abandonner une action, faites un clic droit sur sa ligne, choisissez **Cancel Action** et confirmez **Delete this pending action?**. L'annulation d'un redémarrage planifié le retire aussi de l'appareil.
6. **Show N Completed** et **Hide N Completed** affichent et masquent les actions terminées dans la liste.

Consultez [Mettre à jour les agents](https://wiki.datadike.com/fr/sonar/deploy-operate/agent-updates.md) pour savoir comment les mises à jour de l'agent sont clôturées.

### Lire l'onglet Debug

L'onglet **Debug** du panneau de détails affiche ce que SONAR a enregistré au sujet de l'appareil, du plus récent au plus ancien, dans la limite des 1000 dernières entrées.

1. Sélectionnez l'appareil et ouvrez **Debug**.
2. Choisissez un **Log Level** : **Info** (la valeur par défaut), **Warning**, **Error** ou **Critical**.
3. Si vous le souhaitez, choisissez un **Log Type** : **Agent Update**, **Agent Issues**, **Windows Updates**, **System Issues** ou **Scripting**.
4. Utilisez **Search** pour filtrer les lignes, ou **CSV** pour les exporter.

C'est dans les entrées de type **Agent Update** et **Agent Issues** que sont consignés, côté SONAR, les problèmes de mise à jour et de connexion de l'appareil.

### Journaux de l'agent

| Plateforme | Fichier journal                                                                                                            |
| ---------- | -------------------------------------------------------------------------------------------------------------------------- |
| Windows    | `C:\Program Files\Sonar\agent.log` (`C:\Program Files (x86)\Sonar\agent.log` pour un agent 32 bits sur un Windows 64 bits) |
| Linux      | `/var/log/sonaragent.log`                                                                                                  |
| macOS      | `/var/log/sonaragent.log`                                                                                                  |

Pour une sortie détaillée, arrêtez le service et exécutez l'agent au premier plan avec une journalisation de débogage, puis arrêtez-le avec Ctrl+C et redémarrez le service :

| Plateforme              | Commandes                                                                                                                                                                                                                       |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Windows (invite élevée) | `net stop sonarrmm`, puis `"C:\Program Files\Sonar\sonarrmm.exe" -m rpc -log debug -logto stdout`, puis `net start sonarrmm`                                                                                                    |
| Linux                   | `sudo systemctl stop sonaragent`, puis `sudo /usr/local/bin/sonaragent -m svc -log debug -logto stdout`, puis `sudo systemctl start sonaragent`                                                                                 |
| macOS                   | `sudo launchctl bootout system /Library/LaunchDaemons/sonaragent.plist`, puis `sudo /opt/sonaragent/sonaragent -m svc -log debug -logto stdout`, puis `sudo launchctl bootstrap system /Library/LaunchDaemons/sonaragent.plist` |

Sous Windows, exécuter `"C:\Program Files\Sonar\sonarrmm.exe"` sans argument affiche une boîte **Sonar RMM** avec la version de l'agent et l'état des services de l'agent et de l'agent d'accès à distance.

### Réinstaller par-dessus un agent existant

| Plateforme | Que faire                                                                                                                                                                                                                                              |
| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Windows    | Désinstallez d'abord avec `"C:\Program Files\Sonar\uninstall.exe" /S`, puis exécutez un nouvel installateur. Un installateur lancé par-dessus un agent existant propose de le supprimer (mode interactif) ou s'arrête sans installer (mode silencieux) |
| Linux      | Exécutez de nouveau le script d'installation. Il supprime l'agent précédent et l'agent d'accès à distance avant l'installation                                                                                                                         |
| macOS      | Exécutez de nouveau la commande d'installation. Elle supprime l'agent précédent et l'agent d'accès à distance avant l'installation                                                                                                                     |

Un appareil réinstallé s'enregistre sous une nouvelle fiche. Retirez l'ancienne fiche, désormais hors ligne, avec **Remove Agent**. Consultez [Retirer des agents](https://wiki.datadike.com/fr/sonar/deploy-operate/remove-agents.md).

La réinstallation est aussi le moyen de modifier les fonctionnalités optionnelles d'un appareil Windows : générez un installateur avec la nouvelle sélection.

## Comment vérifier que cela a fonctionné

* Dans **Dashboard › Sysadmin**, vérifiez que l'appareil affiche **Agent Status** **Online** et un **Last Response** d'il y a un instant.
* Dans le panneau de détails, vérifiez que l'indicateur affiche **Remote Online** et que **Take Control** est activé.
* Dans **Agents › Pending Actions**, vérifiez que les actions de l'appareil passent à l'état terminé.
* Sur l'appareil, vérifiez que le journal de l'agent ne montre aucune nouvelle erreur de connexion après le redémarrage.

## Erreurs courantes

| Symptôme ou message                                                                                                                                      | Cause                                                                                                | Correction                                                                                                                          |
| -------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| *Installer token has expired. Please generate a new one.*                                                                                                | L'installateur ou le lien de déploiement a dépassé son expiration, ou son déploiement a été supprimé | Générez un nouvel installateur ou un nouveau déploiement                                                                            |
| *Old installer detected (version …). Latest version is … Please generate a new installer from the RMM*                                                   | L'installateur a été généré avant la version actuelle de l'agent                                     | Générez un nouvel installateur                                                                                                      |
| *This application requires a 64-bit Windows operating system.*                                                                                           | Installateur 64 bits sur un Windows 32 bits                                                          | Utilisez un installateur **32-bit**                                                                                                 |
| *Existing installation found* (boîte de message), ou *Existing installation found and must be removed before attempting to reinstall.* (mode silencieux) | Un agent, ou ce qu'il en reste, est déjà présent sur l'appareil Windows                              | Désinstallez avec `uninstall.exe /S`, puis réinstallez                                                                              |
| *Sonar RMM Is Already Installed*                                                                                                                         | L'installateur PowerShell a trouvé le service `sonarrmm`                                             | Désinstallez d'abord, ou laissez l'appareil tel quel                                                                                |
| *Waiting for network* répété, puis *Unable to connect to server*                                                                                         | L'installateur PowerShell ne joint pas l'adresse de l'API en 443/tcp                                 | Corrigez le chemin réseau ; consultez [Prérequis réseau](https://wiki.datadike.com/fr/sonar/deploy-operate/network-requirements.md) |
| *Unable to download the mesh agent from the RMM.* / *Failed to download mesh agent*                                                                      | L'installateur n'a pas pu obtenir l'agent d'accès à distance par l'adresse de l'API                  | Vérifiez la connectivité vers l'adresse de l'API, puis relancez l'installateur                                                      |
| *Invalid URL (must contain https or http)*                                                                                                               | La valeur `-api` d'une commande manuelle a été modifiée ou tronquée                                  | Copiez de nouveau la commande depuis la console                                                                                     |
| *ERROR: Must be run as root* / *must run as root*                                                                                                        | Script Linux ou agent macOS exécuté sans root                                                        | Exécutez avec `sudo`                                                                                                                |
| *This install script only supports systemd*                                                                                                              | Distribution Linux sans systemd                                                                      | Non pris en charge ; consultez [Prérequis des appareils](https://wiki.datadike.com/fr/sonar/deploy-operate/requirements.md)         |
| *ERROR: Display detected. Installer only supports running headless, i.e from ssh.*                                                                       | Script Linux lancé depuis une session graphique                                                      | Exécutez-le par SSH, depuis une console texte, ou après `unset DISPLAY`                                                             |
| *ERROR: Unable to download sonar agent*                                                                                                                  | L'appareil Linux ne peut pas télécharger depuis l'adresse de l'API                                   | Vérifiez le port 443/tcp et la résolution de noms                                                                                   |
| Boîte de dialogue **Agent offline**, *… cannot be contacted*                                                                                             | L'appareil n'a pas répondu lorsque vous avez choisi **Remove Agent**                                 | Consultez [Retirer des agents](https://wiki.datadike.com/fr/sonar/deploy-operate/remove-agents.md)                                  |
| *Unable to contact the agent*                                                                                                                            | Une action attendait une réponse de l'appareil et aucune n'est arrivée                               | Vérifiez **Agent Status** et **Last Response** ; remettez l'appareil en ligne                                                       |
| Appareil **Online** mais **Remote Offline**                                                                                                              | L'agent d'accès à distance est arrêté ou ne joint pas l'adresse d'accès à distance                   | Utilisez **Restart Remote Service**, puis vérifiez le chemin réseau                                                                 |
| L'appareil apparaît deux fois dans la liste                                                                                                              | Il a été réinstallé et l'ancienne fiche a été conservée                                              | Retirez la fiche hors ligne avec **Remove Agent**                                                                                   |

## Pages associées

* [Prérequis réseau](https://wiki.datadike.com/fr/sonar/deploy-operate/network-requirements.md)
* [Mettre à jour les agents](https://wiki.datadike.com/fr/sonar/deploy-operate/agent-updates.md)
* [Retirer des agents](https://wiki.datadike.com/fr/sonar/deploy-operate/remove-agents.md)
* [Détails de l'appareil](https://wiki.datadike.com/fr/sonar/administration/devices/device-details.md)
* [La liste des appareils](https://wiki.datadike.com/fr/sonar/administration/devices/device-list.md)
