Introduction

Quand quelque chose ne va pas avec un agent Level — un appareil montrant hors ligne, les connexions à distance ne fonctionnant pas, ou une automation échouant — la commande de diagnostic et la sortie de l'étape d'automation sont les deux endroits où commencer. Le chien de garde de Level gère le fonctionnement automatique du service, donc dans la plupart des cas, vous recherchez un problème de connectivité ou de configuration, pas un problème de service.

Exécuter la commande de diagnostic

Si un appareil s'affiche hors ligne dans Level mais est réellement allumé 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	`& '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 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 heure du dernier démarrage. Contexte utile lors du partage de la sortie avec le support.
Vérifications Level — Montre si le service d'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. Montre l'état de chaque point de terminaison requis :

Vérification	Ce qu'elle teste
`online.level.io`	Vérification de connectivité basique accessible par 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 échouée)

Si l'une d'elles affiche un échec au lieu de OK / Connected, c'est votre cause racine.

Paramètres de mise en veille — Montre la configuration actuelle de mise en veille/délai d'expiration de l'appareil. Les paramètres de mise en veille agressifs (surtout les délais d'expiration CC courts) peuvent faire que les appareils s'affichent intermittent hors ligne.
Statut d'activité — Montre les opérations actives en cours d'exécution sur l'agent, comme Remote Management.

Trier par ce que vous voyez

Les vérifications de connexion montrent des échecs (online.level.io, agents.level.io, etc.) :
L'agent ne peut pas atteindre les serveurs de Level. La cause est presque toujours l'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 à distance sont sur relais au lieu de P2P :
L'agent peut communiquer avec Level, mais les connexions pair-à-pair directes ne fonctionnent pas. Voir Dépannage relais/P2P .

Les vérifications Level montrent le service ou le chien de garde non dans l'état attendu :
Quelque chose empêche activement l'agent de fonctionner — probablement la mise en quarantaine AV/EDR. Voir Fausses détections AV/EDR .

Erreurs d'automation ou de script

Pour les problèmes d'automation, --check n'aidera pas directement. Au lieu de cela, ouvrez l'automation exécutée et développez l'étape qui a échoué. 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 avoir besoin d'aller plus loin.

Contacter le support

Si vous ne pouvez pas identifier la cause à partir de --check ou de la sortie de l'étape, Level Support peut creuser avec vous. Quand vous nous contactez, incluez :

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

FAQ

Level montre un appareil hors ligne mais je peux le pinger et l'atteindre via d'autres outils. Par où commencer ? Exécutez --check sur l'appareil et regardez la section 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 — 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'automation a échoué. Comment voir ce qui ne va pas ? Ouvrez l'automation exécutée et développez l'étape qui a échoué. 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 revient de lui-même. Qu'est-ce que cela cause ? Généralement l'interférence AV/EDR — certains produits bloquent Level de manière intermittente après les mises à jour de signature sans générer d'alerte visible. Exécuter --check pendant que l'appareil est dans l'état hors ligne vous donne l'image la plus claire. Voir Fausses détections AV/EDR si les vérifications de connexion affichent des échecs.

Dépannage des problèmes d'agent