Lorsque quelque chose ne va pas avec un agent Level — un appareil hors ligne, les connexions distantes ne fonctionnent pas ou une automatisation échoue — la commande de diagnostic et la sortie de l'étape d'automatisation sont les deux endroits par où commencer. Le chien de garde de Level s'occupe de maintenir le service en fonctionnement automatiquement, donc dans la plupart des cas, vous recherchez un problème de connectivité ou de configuration, pas un problème de service.
Exécution de la Commande de Diagnostic
Si un appareil s'affiche hors ligne dans Level mais est en réalité sous tension et connecté, exécutez --check sur l'appareil affecté. Il 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 mise en veille et les opérations actives.
Windows |
|
macOS |
|
Linux |
|
Lecture de la Sortie
La sortie est divisée en sections. Voici ce que chacune vous dit :
Agent — ID, version, date de compilation, plateforme et état interne. Confirme que l'agent est installé et quelle version s'exécute.
Système — Nom d'hôte, OS, architecture et dernière heure de démarrage. Contexte utile lors du partage de la sortie avec le support.
Vérifications de Level — Montre si le service d'agent et la tâche de chien de garde sont dans l'état attendu (
En cours d'exécution/Prêt).Vérifications de connexion — La section la plus importante pour les problèmes hors ligne. Montre l'état de chaque point de terminaison requis :
Vérification | Ce qu'elle teste |
| Vérification de connectivité accessible sur Internet |
| Canal de communication principal de l'agent vers Level |
| Point de terminaison de rapport de disponibilité |
| État de la connexion WebSocket ( |
Si l'une d'elles montre un échec au lieu de OK / Connecté, c'est votre cause racine.
Paramètres de mise en veille — Montre la configuration actuelle de veille/délai d'expiration de l'appareil. Les paramètres de mise en veille agressifs (en particulier les délais d'expiration DC courts) peuvent faire apparaître les appareils intermittents hors ligne.
État de l'activité — Montre les opérations actives actuellement exécutées sur l'agent, telles que
Gestion à Distance.
Triage par Ce Que Vous Voyez
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 AV/EDR bloquant l'agent ou un pare-feu bloquant le trafic sortant. Voir Fausses Détections AV/EDR et Dépannage Hors Ligne.
Les vérifications de connexion sont OK mais les sessions distantes sont sur relais au lieu de P2P :
L'agent peut communiquer avec Level, mais les connexions directes de pair à pair ne fonctionnent pas. Voir Dépannage Relais/P2P.
Les vérifications de Level montrent que le service ou le chien de garde ne sont pas dans l'état attendu :
Quelque chose empêche activement l'agent de fonctionner — très probablement une quarantaine AV/EDR. Voir Fausses Détections AV/EDR.
Erreurs d'Automatisation ou de Script
Pour les problèmes d'automatisation, --check n'aidera pas directement. Au lieu de cela, ouvrez l'exécution de l'automatisation et développez l'étape défaillante. Chaque étape montre 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 d'étape identifie la cause sans avoir besoin d'aller plus loin.
Contacter le Support
Si vous ne pouvez pas identifier la cause à partir de --check ou de la sortie d'étape, le Support de Level peut vous aider. Lorsque vous nous 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 de la sortie d'étape
FAQ
Level montre un appareil comme hors ligne mais je peux le pincer et y accéder via d'autres outils. Par où commencer ? Exécutez
--checksur l'appareil et regardez la section Vérifications de connexion. Sionline.level.ioouagents.level.ioaffichent des échecs, l'agent ne peut pas atteindre les serveurs de Level — très probablement AV/EDR ou un pare-feu. Si toutes les vérifications de connexion réussissent, envoyez la sortie complète au Support de Level.Une étape d'automatisation a échoué. Comment puis-je voir ce qui s'est mal passé ? Ouvrez l'exécution de l'automatisation et développez l'étape défaillante. La sortie complète, y compris tout message d'erreur ou code de sortie, s'affiche là. C'est généralement suffisant pour identifier le problème sans avoir besoin de support.
L'appareil se déconnecte périodiquement, puis se reconnaît automatiquement. Qu'est-ce qui cause cela ? Généralement une interférence AV/EDR — certains produits bloquent Level par intermittence après les mises à jour de signature sans générer d'alerte visible. L'exécution de
--checktandis que l'appareil est hors ligne vous donne l'image la plus claire. Voir Fausses Détections AV/EDR si les vérifications de connexion affichent des échecs.