Introduction

Lorsqu'un problème survient avec un agent Level — un appareil affiché hors ligne, des connexions à distance qui ne fonctionnent pas, ou une automatisation qui échoue — la commande de diagnostic et la sortie des étapes d'automatisation sont les deux premiers endroits à examiner. Le chien de garde de Level se charge de maintenir le service en marche 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 est affiché hors ligne dans Level mais est en réalité sous tension 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 heure du dernier 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 hors ligne. Affiche l'état 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 avec Level
`uptime monitor`	Point de terminaison de rapport de disponibilité
`realtime client`	État de la connexion WebSocket (`Connected` ou en échec)

Si l'un de ces éléments affiche un échec au lieu de OK / Connected, c'est la cause principale.

Paramètres de veille — Affiche la configuration actuelle de veille/délai d'inactivité de l'appareil. Des paramètres de veille agressifs (notamment de courts délais sur batterie) 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 atteindre les serveurs de Level. La cause est presque toujours un antivirus/EDR bloquant l'agent ou un pare-feu bloquant le trafic sortant. Voir Faux positifs des antivirus/EDR et Résolution des problèmes hors ligne.

Les vérifications de connexion sont correctes, mais les sessions à distance passent par un relais au lieu du pair-à-pair :
L'agent peut communiquer avec Level, mais les connexions directes pair-à-pair ne fonctionnent pas. Voir Résolution des problèmes de relais/pair-à-pair.

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'exécution de l'agent — très probablement une mise en quarantaine par un antivirus/EDR. Voir Faux positifs des 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 dans 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 les contactez, incluez :

La sortie complète de --check (pour les problèmes hors ligne/de 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 atteindre les serveurs de Level — très probablement à cause d'un antivirus/EDR ou d'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 mal passé ? Ouvrez l'exécution de l'automatisation et développez l'étape en échec. La sortie complète, incluant 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 revient de lui-même. Quelle en est la cause ? Généralement une interférence d'un antivirus/EDR — certains produits bloquent Level de manière intermittente après des mises à jour de signatures sans générer d'alerte visible. Exécutez --check pendant que l'appareil est dans l'état hors ligne vous donne l'image la plus claire. Voir Faux positifs des antivirus/EDR si les vérifications de connexion affichent des échecs.

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