Einführung
Wenn etwas mit einem Level-Agent nicht stimmt — ein Gerät wird als offline angezeigt, Remote-Verbindungen funktionieren nicht oder eine Automatisierung schlägt fehl — sind der Diagnosebefehl und die Ausgabe des Automatisierungsschritts die beiden Ausgangspunkte. Level's Watchdog sorgt dafür, dass der Dienst automatisch am Laufen bleibt. In den meisten Fällen suchen Sie daher nach einem Verbindungs- oder Konfigurationsproblem und 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. Es gibt einen strukturierten Bericht aus, der den Agent, Systeminformationen, den Level-Dienststatus, Verbindungsprüfungen, Energiespareinstellungen und aktive Vorgänge abdeckt.
Windows |
|
macOS |
|
Linux |
|
Die Ausgabe lesen
Die Ausgabe ist in Abschnitte unterteilt. Folgendes sagt Ihnen jeder Abschnitt:
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 Startzeitpunkt. Nützlicher Kontext beim Teilen der Ausgabe mit dem 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:
Prüfung | Was getestet wird |
| Grundlegende Verbindungsprüfung zur Erreichbarkeit im Internet |
| Primärer Kommunikationskanal des Agents zu Level |
| Endpunkt für die Betriebszeiterfassung |
| WebSocket-Verbindungsstatus ( |
Wenn eines davon einen Fehler anstelle von OK / Connected, dann ist das Ihre Grundursache.
Energiespareinstellungen — Zeigt die aktuelle Energiespar-/Timeout-Konfiguration 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 Agent ausgeführt werden, wie 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 Agent blockiert oder eine Firewall ausgehenden Datenverkehr blockiert. Siehe AV/EDR-Falscherkennung und Offline-Fehlerbehebung.
Verbindungsprüfungen sind OK, aber Remote-Sitzungen laufen über Relay statt P2P:
Der Agent kann mit Level kommunizieren, aber direkte Peer-to-Peer-Verbindungen funktionieren nicht. Siehe Relay/P2P-Fehlerbehebung.
Level-Prüfungen zeigen, dass Dienst oder Watchdog nicht im erwarteten Status sind:
Etwas verhindert aktiv das Ausführen des Agents — höchstwahrscheinlich AV/EDR-Quarantäne. Siehe AV/EDR-Falscherkennung.
Automatisierungs- oder Skriptfehler
Bei Automatisierungsproblemen --check hilft hier nicht direkt weiter. Öffnen Sie stattdessen den Automatisierungslauf und erweitern Sie den fehlgeschlagenen Schritt. Jeder Schritt zeigt seine vollständige Ausgabe — Exit-Codes, Fehlermeldungen und alle Skriptausgaben, die nach stdout oder stderr geschrieben wurden.
In den meisten Fällen identifiziert der Fehler in der Schrittausgabe die Ursache, ohne dass weitere Schritte erforderlich sind.
Support kontaktieren
Wenn Sie die Ursache anhand von --check oder die Schrittausgabe kann der Level-Support gemeinsam mit Ihnen tiefer einsteigen. 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 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 bestanden werden, senden Sie die vollständige Ausgabe an den Level-Support.Ein Automatisierungsschritt ist fehlgeschlagen. Wie kann ich sehen, was schiefgelaufen ist? Öffnen Sie den Automatisierungslauf und erweitern Sie den fehlgeschlagenen Schritt. Die vollständige Ausgabe, einschließlich aller Fehlermeldungen oder Exit-Codes, wird dort angezeigt. Das reicht in der Regel aus, um das Problem ohne Support-Einbindung zu identifizieren.
Das Gerät geht periodisch offline und kommt dann von selbst wieder online. Was verursacht das? Meistens AV/EDR-Interferenz — einige Produkte blockieren Level zeitweise nach Signaturaktualisierungen, ohne einen sichtbaren Alarm zu generieren. Wenn Sie
--checkwährend sich das Gerät im Offline-Zustand befindet, liefert das klarste Bild. Siehe AV/EDR-Falscherkennung wenn die Verbindungsprüfungen Fehler anzeigen.