Einführung
Wenn mit einem Level-Agenten etwas nicht stimmt — 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 Ausgangspunkte. Der Level-Watchdog sorgt automatisch dafür, dass der Dienst läuft, daher handelt es sich in den meisten Fällen um ein Verbindungs- oder Konfigurationsproblem, nicht um ein 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. Er gibt einen strukturierten Bericht aus, der den Agenten, 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 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 Startzeitpunkt. Nützlicher Kontext beim Teilen der Ausgabe mit dem Support.
Level-Prüfungen — Zeigt an, ob der Agentendienst und die Watchdog-Aufgabe im erwarteten Zustand sind (
Running/Ready).Verbindungsprüfungen — Der wichtigste Abschnitt bei Offline-Problemen. Zeigt den Status jedes erforderlichen Endpunkts:
Prüfung | Was wird getestet |
| Grundlegende Konnektivitätsprüfung über das Internet |
| Primärer Kommunikationskanal des Agenten zu Level |
| Endpunkt zur Betriebszeiterfassung |
| WebSocket-Verbindungsstatus ( |
Wenn eines davon einen Fehler anstelle von OK / Connected, 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 derzeit aktive Vorgänge, die auf dem Agenten ausgeführt werden, wie z. B.
Remote Management.
Triage anhand des Beobachteten
Verbindungsprüfungen zeigen Fehler (online.level.io, agents.level.io, usw.):
Der Agent kann die Level-Server nicht erreichen. Die Ursache ist fast immer ein AV/EDR, das den Agenten blockiert, oder eine Firewall, die ausgehenden Datenverkehr blockiert. Siehe AV/EDR-Fehlerkennungen und Offline-Fehlerbehebung.
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 Relay/P2P-Fehlerbehebung.
Verbindungsprüfungen sind in Ordnung, Terminal und Datei-Explorer funktionieren auf demselben Windows-Gerät, aber Remote-Steuerung bleibt bei „Verbindung wird hergestellt":
Erfolgreiche --check Verbindungsprüfungen zeigen, dass der Agent die geprüften Level-Endpunkte erreichen kann. Funktionierende Terminal und Datei-Explorer Sitzungen zeigen, dass die Hintergrundverwaltung kommunizieren kann. Remote-Steuerung benötigt außerdem Windows, um Desktop-Sitzungsinformationen zurückzugeben. Die --check Verbindungsprüfungen testen diesen Windows-Sitzungsenumerierungspfad nicht.
Im funktionierenden Terminal, führen Sie den integrierten Windows-Befehl
query session.Wenn eine Sitzungsliste oder ein Fehler zurückgegeben wird, senden Sie die Ausgabe und Ihren vollständigen
--checkBericht an den Level-Support. Eine zurückgegebene Sitzungsliste schließt andere Fehler bei der Remote-Steuerung nicht aus.Wenn nach 30 Sekunden keine Rückgabe erfolgt, drücken Sie Ctrl+C und teilen Sie dem Level-Support mit, dass es hängen geblieben ist. Dies kann auf ein Windows-Sitzungsverwaltungsproblem hinweisen. Verwenden Sie die Web-Konsole Ihres Hosting-Anbieters, die Hypervisor-Konsole oder eine lokale Konsole, um zu prüfen, ob Windows reagiert. Wenn die Sitzungsenumerierung weiterhin nicht reagiert, wenden Sie sich an Ihren Windows- oder Hosting-Administrator, um das Gerät zu untersuchen und eine kontrollierte Wiederherstellung zu veranlassen.
Wenn Terminal, Datei-Explorer, und Remote-Steuerung alle keine Verbindung herstellen können, befolgen Sie ebenfalls Relay/P2P-Fehlerbehebung.
Level-Prüfungen zeigen, dass Dienst oder Watchdog nicht im erwarteten Zustand sind:
Der Agentendienst oder Watchdog befindet sich nicht im erwarteten Zustand, und --check allein zeigt nicht warum. AV/EDR-Eingriffe sind eine mögliche Ursache, sollten aber nur dann als Ursache betrachtet werden, wenn es Hinweise auf eine Erkennung, Blockierung oder Quarantäne gibt. Siehe AV/EDR-Fehlerkennungen.
Automatisierungs- oder Skriptfehler
Bei Automatisierungsproblemen hilft --check hilft hier nicht direkt weiter. Öffnen Sie stattdessen den Automatisierungslauf und klappen Sie den fehlgeschlagenen Schritt aus. 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 lässt sich die Ursache aus dem Fehler in der Schrittausgabe erkennen, ohne weiter nachforschen zu müssen.
Support kontaktieren
Wenn Sie die Ursache anhand von --check oder der Schrittausgabe 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
Häufig gestellte Fragen
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 schauen 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 bestanden werden, senden Sie die vollständige Ausgabe an den Level-Support.Ein Automatisierungsschritt ist fehlgeschlagen. Wie sehe ich, was schiefgelaufen ist? Öffnen Sie den Automatisierungslauf und klappen Sie den fehlgeschlagenen Schritt aus. Die vollständige Ausgabe, einschließlich etwaiger Fehlermeldungen oder Exit-Codes, 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 wieder online. Was verursacht das? Meistens AV/EDR-Eingriffe — einige Produkte blockieren Level zeitweise nach Signaturaktualisierungen, ohne einen sichtbaren Alarm zu erzeugen. Führen Sie
--checkwährend sich das Gerät im Offline-Zustand befindet, liefert das klarste Bild. Siehe AV/EDR-Fehlerkennungen wenn die Verbindungsprüfungen Fehler anzeigen.
