Introduction

Lorsqu'un agent Level rencontre un problème — un appareil affiché hors ligne, des connexions à distance qui ne fonctionnent pas, ou une automatisation qui échoue — la commande de diagnostic et la sortie de l'étape d'automatisation sont les deux points de départ. Le chien de garde de Level se charge de maintenir le service en cours d'exécution automatiquement, donc dans la plupart des cas, vous cherchez un problème de connectivité ou de configuration, et non un problème de service.

Exécution de la commande de diagnostic

Si un appareil s'affiche hors ligne dans Level alors qu'il est effectivement allumé et connecté, exécutez --check sur l'appareil concerné. Elle génère un rapport structuré couvrant l'agent, les informations système, l'état du service Level, les vérifications de connexion, les paramètres de veille et les opérations en cours.

Windows	`& 'C:\Program Files\Level\level.exe' --check`
macOS	`sudo /usr/local/bin/level --check`
Linux	`sudo /usr/local/bin/level --check`

Lecture de la sortie

La sortie est divisée en sections. Voici ce que chacune vous indique :

Agent — Identifiant, version, date de compilation, plateforme et état interne. Confirme que l'agent est installé et quelle version est en cours d'exécution.
Système — Nom d'hôte, système d'exploitation, architecture et dernière heure de démarrage. Contexte utile lors du partage de la sortie avec le support.
Vérifications Level — Indique si le service de l'agent et la tâche du chien de garde sont dans l'état attendu (Running / Ready).
Vérifications de connexion — La section la plus importante pour les problèmes de déconnexion. Affiche le statut de chaque point de terminaison requis :

Vérification	Ce qu'elle teste
`online.level.io`	Vérification de connectivité de base accessible depuis Internet
`agents.level.io`	Canal de communication principal de l'agent vers Level
`uptime monitor`	Point de terminaison de rapport de disponibilité
`realtime client`	État de la connexion WebSocket (`Connected` ou en échec)

Si l'une de ces vérifications indique un échec au lieu de OK / Connected, c'est la cause racine.

Paramètres de veille — Affiche la configuration actuelle de veille/délai d'expiration de l'appareil. Des paramètres de veille agressifs (en particulier des délais d'expiration courts sur courant continu) peuvent provoquer l'apparition intermittente d'appareils hors ligne.
État de l'activité — Affiche les opérations actives en cours d'exécution sur l'agent, telles que Remote Management.

Triage selon ce que vous observez

Les vérifications de connexion affichent des échecs (online.level.io, agents.level.io, etc.) :
L'agent ne peut pas accéder aux serveurs de Level. La cause est presque toujours un blocage de l'agent par un antivirus/EDR ou un blocage du trafic sortant par un pare-feu. Voir Faux positifs Antivirus/EDR et Dépannage hors ligne.

Les vérifications de connexion sont correctes, mais les sessions à distance utilisent le relais au lieu du P2P :
L'agent peut communiquer avec Level, mais les connexions directes pair à pair ne fonctionnent pas. Voir Dépannage Relais/P2P.

Les vérifications Level indiquent que le service ou le chien de garde n'est pas dans l'état attendu :
Quelque chose empêche activement l'agent de s'exécuter — très probablement une mise en quarantaine par un antivirus/EDR. Voir Faux positifs Antivirus/EDR.

Erreurs d'automatisation ou de script

Pour les problèmes d'automatisation, --check ne sera pas directement utile. Ouvrez plutôt l'exécution de l'automatisation et développez l'étape en échec. Chaque étape affiche sa sortie complète — codes de sortie, messages d'erreur et toute sortie de script écrite sur stdout ou stderr.

Dans la plupart des cas, l'erreur dans la sortie de l'étape identifie la cause sans qu'il soit nécessaire d'aller plus loin.

Contacter le support

Si vous ne parvenez pas à identifier la cause à partir de --check ou la sortie de l'étape, le support Level peut approfondir l'analyse avec vous. Lorsque vous le contactez, incluez :

La sortie complète de --check (pour les problèmes de déconnexion/connectivité)
Le nom de l'automatisation et l'étape spécifique qui a échoué (pour les problèmes d'automatisation)
Le message d'erreur complet issu de la sortie de l'étape

FAQ

Level affiche un appareil comme hors ligne, mais je peux le pinguer et y accéder via d'autres outils. Par où commencer ? Exécutez --check sur l'appareil et consultez la section des vérifications de connexion. Si online.level.io ou agents.level.io affichent des échecs, l'agent ne peut pas accéder aux serveurs de Level — très probablement un antivirus/EDR ou un pare-feu. Si toutes les vérifications de connexion réussissent, envoyez la sortie complète au support Level.
Une étape d'automatisation a échoué. Comment voir ce qui s'est passé ? Ouvrez l'exécution de l'automatisation et développez l'étape en échec. La sortie complète, y compris tout message d'erreur ou code de sortie, y est affichée. C'est généralement suffisant pour identifier le problème sans avoir besoin du support.
L'appareil se déconnecte périodiquement, puis se reconnecte de lui-même. Qu'est-ce qui en est la cause ? Généralement une interférence d'un antivirus/EDR — certains produits bloquent Level de façon intermittente après des mises à jour de signatures sans générer d'alerte visible. Exécution de --check pendant que l'appareil est dans l'état hors ligne vous donne l'image la plus claire. Voir Faux positifs Antivirus/EDR si les vérifications de connexion affichent des échecs.

Résolution des problèmes liés à l'agent