Wenn etwas mit einem Level-Agent nicht stimmt — ein Gerät zeigt sich offline, Remote-Verbindungen funktionieren nicht oder eine Automatisierung schlägt fehl — sind der Diagnosebefehl und die Automatisierungsschrittausgabe die beiden Ausgangspunkte. Levels Watchdog kümmert sich darum, den Service automatisch am Laufen zu halten, daher suchen Sie in den meisten Fällen nach einem Konnektivitäts- oder Konfigurationsproblem, nicht nach einem Service-Problem.
Ausführung des Diagnosebefehls
Wenn ein Gerät in Level offline angezeigt wird, aber tatsächlich eingeschaltet und verbunden ist, führen Sie --check auf dem betroffenen Gerät aus. Es gibt einen strukturierten Bericht aus, der den Agent, Systeminformationen, den Level-Service-Status, Verbindungsprüfungen, Energiespareinstellungen und aktive Vorgänge abdeckt.
Windows |
|
macOS |
|
Linux |
|
Interpretation der Ausgabe
Die Ausgabe ist in Abschnitte unterteilt. Hier ist, was jeder Abschnitt Ihnen mitteilt:
Agent — ID, Version, Build-Datum, Plattform und interner Status. Bestätigt, dass der Agent installiert ist und welche Version ausgeführt wird.
System — Hostname, Betriebssystem, Architektur und letzte Startzeit. Nützlicher Kontext beim Teilen der Ausgabe mit dem Support.
Level-Prüfungen — Zeigt, ob der Agent-Service und die Watchdog-Aufgabe im erwarteten Status sind (
Wird ausgeführt/Bereit).Verbindungsprüfungen — Der wichtigste Abschnitt für Offline-Probleme. Zeigt den Status jedes erforderlichen Endpunkts:
Prüfung | Was sie testet |
| Basis-Internet-Erreichbarkeitsprüfung |
| Primärer Kommunikationskanal des Agenten zu Level |
| Endpoint für Uptime-Berichte |
| WebSocket-Verbindungsstatus ( |
Wenn einer dieser zeigt, dass ein Fehler anstelle von OK / Verbunden vorliegt, haben Sie Ihre Grundursache gefunden.
Energiespareinstellungen — Zeigt die aktuelle Energiespar-/Timeout-Konfiguration des Geräts. Aggressive Energiespareinstellungen (besonders kurze DC-Timeouts) können dazu führen, dass Geräte intermittierend offline erscheinen.
Aktivitätsstatus — Zeigt aktive Vorgänge, die derzeit auf dem Agenten ausgeführt werden, wie
Remote-Verwaltung.
Triage nach dem, was Sie Sehen
Verbindungsprüfungen zeigen Fehler (online.level.io, agents.level.io, usw.):
Der Agent kann die Level-Server nicht erreichen. Die Ursache ist fast immer AV/EDR, das den Agenten blockiert, oder eine Firewall, die den ausgehenden Datenverkehr blockiert. Siehe AV/EDR Falschmeldungen und Offline-Fehlerbehebung.
Verbindungsprüfungen sind OK, aber Remote-Sessions sind auf Relais statt P2P:
Der Agent kann mit Level kommunizieren, aber direkte Peer-to-Peer-Verbindungen funktionieren nicht. Siehe Relais-/P2P-Fehlerbehebung.
Level-Prüfungen zeigen, dass der Service oder Watchdog nicht im erwarteten Status ist:
Etwas verhindert aktiv, dass der Agent läuft — höchstwahrscheinlich AV/EDR-Quarantäne. Siehe AV/EDR Falschmeldungen.
Automatisierungs- oder Skriptfehler
Bei Automatisierungsproblemen hilft --check nicht direkt. Öffnen Sie stattdessen die Automatisierungsausführung und erweitern Sie den fehlgeschlagenen Schritt. Jeder Schritt zeigt seine vollständige Ausgabe — Exitcodes, Fehlermeldungen und jede Skriptausgabe, die auf stdout oder stderr geschrieben ist.
In den meisten Fällen identifiziert der Fehler in der Schrittausgabe die Ursache, ohne dass Sie weiter gehen müssen.
Support Kontaktieren
Wenn Sie die Ursache nicht anhand von --check oder der Schrittausgabe identifizieren können, kann Level Support mit Ihnen helfen. Wenn Sie uns kontaktieren, fügen Sie ein:
Die vollständige Ausgabe von
--check(für Offline-/Konnektivitätsprobleme)Den Automatisierungsnamen und den spezifischen Schritt, der fehlgeschlagen ist (für Automatisierungsprobleme)
Die vollständige Fehlermeldung aus der Schrittausgabe
Häufig Gestellte Fragen
Level zeigt ein Gerät als offline an, aber ich kann es pinnen und über andere Tools erreichen. Wo soll ich anfangen? Führen Sie
--checkauf dem Gerät aus und schauen Sie sich den Abschnitt Verbindungsprüfungen an. Wennonline.level.iooderagents.level.ioFehler anzeigen, kann der Agent die Level-Server nicht erreichen — höchstwahrscheinlich AV/EDR oder eine Firewall. Wenn alle Verbindungsprüfungen erfolgreich sind, senden Sie die vollständige Ausgabe an Level Support.Ein Automatisierungsschritt ist fehlgeschlagen. Wie kann ich sehen, was schiefgelaufen ist? Öffnen Sie die Automatisierungsausführung und erweitern Sie den fehlgeschlagenen Schritt. Die vollständige Ausgabe, einschließlich aller Fehlermeldungen oder Exitcodes, wird dort angezeigt. Das reicht normalerweise aus, um das Problem zu identifizieren, ohne Support zu benötigen.
Das Gerät wird regelmäßig offline und kommt von selbst wieder online. Was verursacht das? Normalerweise AV/EDR-Interferenz — einige Produkte blockieren Level nach Signaturupdates intermittierend, ohne sichtbare Warnung zu generieren. Das Ausführen von
--check, während sich das Gerät im Offline-Status befindet, ergibt das klarste Bild. Siehe AV/EDR Falschmeldungen, wenn die Verbindungsprüfungen Fehler anzeigen.