Einführung
Wenn ein Level-Agent Probleme aufweist – ein Gerät erscheint offline, Remote-Verbindungen funktionieren nicht oder eine Automatisierung schlägt fehl – sind der Diagnosebefehl und die Ausgabe des Automatisierungsschritts die beiden ersten Anlaufstellen. Level's Watchdog sorgt automatisch dafür, dass der Dienst weiterläuft. In den meisten Fällen sucht man daher nach einem Verbindungs- oder Konfigurationsproblem, nicht nach einem Dienstproblem.
Den Diagnosebefehl ausführen
Wenn ein Gerät in Level als offline angezeigt wird, aber tatsächlich eingeschaltet und verbunden ist, führen Sie --check auf dem betroffenen Gerät. Die Ausgabe enthält einen strukturierten Bericht über den Agenten, Systeminformationen, den Level-Dienststatus, Verbindungsprüfungen, Energiespareinstellungen und aktive Vorgänge.
Windows |
|
macOS |
|
Linux |
|
Die Ausgabe lesen
Die Ausgabe ist in Abschnitte unterteilt. Das teilt Ihnen jeder Abschnitt mit:
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 letzter Startzeit. Nützlicher Kontext beim Weitergeben der Ausgabe an den Support.
Level-Prüfungen — Zeigt an, ob der Agent-Dienst und die Watchdog-Aufgabe den erwarteten Status aufweisen (
Running/Ready).Verbindungsprüfungen — Der wichtigste Abschnitt bei Offline-Problemen. Zeigt den Status jedes erforderlichen Endpunkts an:
Prüfung | Was getestet wird |
| Grundlegende Verbindungsprüfung über das Internet |
| Primärer Kommunikationskanal des Agenten zu Level |
| Endpunkt für die Betriebszeiterfassung |
| WebSocket-Verbindungsstatus ( |
Wenn eine dieser Prüfungen einen Fehler anstelle von OK / Connected, ist das die eigentliche Ursache.
Energiespareinstellungen — Zeigt die aktuelle Energiespar-/Timeoutkonfiguration des Geräts. Aggressive Energiespareinstellungen (insbesondere kurze DC-Timeouts) können dazu führen, dass Geräte zeitweise als offline erscheinen.
Aktivitätsstatus — Zeigt aktive Vorgänge, die derzeit auf dem Agenten ausgeführt werden, z. B.
Remote Management.
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, dass AV/EDR den Agenten blockiert oder eine Firewall ausgehenden Datenverkehr blockiert. Siehe AV/EDR-Fehlerkennungen und Fehlerbehebung bei Offline-Problemen.
Verbindungsprüfungen sind in Ordnung, aber Remote-Sitzungen laufen über Relay statt P2P:
Der Agent kann mit Level kommunizieren, aber direkte Peer-to-Peer-Verbindungen funktionieren nicht. Siehe Fehlerbehebung bei Relay/P2P.
Level-Prüfungen zeigen, dass der Dienst oder Watchdog nicht den erwarteten Status hat:
Etwas verhindert aktiv die Ausführung des Agenten – höchstwahrscheinlich eine AV/EDR-Quarantäne. Siehe AV/EDR-Fehlerkennungen.
Fehler bei Automatisierungen oder Skripten
Bei Automatisierungsproblemen --check hilft hier nicht direkt weiter. Öffnen Sie stattdessen die Automatisierungsausführung und erweitern Sie den fehlgeschlagenen Schritt. Jeder Schritt zeigt seine vollständige Ausgabe – Exit-Codes, Fehlermeldungen und alle Skriptausgaben, die in stdout oder stderr geschrieben wurden.
In den meisten Fällen identifiziert der Fehler in der Schrittausgabe die Ursache, ohne dass weitere Maßnahmen erforderlich sind.
Support kontaktieren
Wenn Sie die Ursache anhand von --check oder die Schrittausgabe die Ursache nicht ermitteln können, kann der Level-Support gemeinsam mit Ihnen nachforschen. Wenn Sie sich melden, geben Sie bitte Folgendes an:
Die vollständige Ausgabe von
--check(bei Offline-/Verbindungsproblemen)Den Namen der Automatisierung und den spezifischen Schritt, der fehlgeschlagen ist (bei Automatisierungsproblemen)
Die vollständige Fehlermeldung aus der Schrittausgabe
FAQ
Level zeigt ein Gerät als offline an, aber ich kann es anpingen und über andere Tools erreichen. Wo fange ich an? Führen Sie
--checkauf dem Gerät und sehen Sie sich den Abschnitt „Verbindungsprüfungen" an. Wennonline.level.iooderagents.level.ioFehler anzeigen, kann der Agent die Level-Server nicht erreichen – höchstwahrscheinlich aufgrund von AV/EDR oder einer Firewall. Wenn alle Verbindungsprüfungen erfolgreich sind, senden Sie die vollständige Ausgabe an den Level-Support.Ein Automatisierungsschritt ist fehlgeschlagen. Wie sehe ich, was schiefgelaufen ist? Öffnen Sie die Automatisierungsausführung und erweitern Sie den fehlgeschlagenen Schritt. Die vollständige Ausgabe, einschließlich Fehlermeldung oder Exit-Code, wird dort angezeigt. Das reicht in der Regel aus, um das Problem zu identifizieren, ohne den Support zu benötigen.
Das Gerät geht periodisch offline und kommt von selbst zurück. Was verursacht das? In der Regel handelt es sich um AV/EDR-Interferenzen – einige Produkte blockieren Level zeitweise nach Signatur-Updates, ohne einen sichtbaren Alarm zu erzeugen. Wenn Sie
--checkwährend das Gerät offline ist, gibt Ihnen das klarste Bild. Siehe AV/EDR-Fehlerkennungen wenn die Verbindungsprüfungen Fehler zeigen.