Einführung
Wenn etwas mit einem Level-Agent nicht stimmt — ein Gerät wird offline angezeigt, Remote-Verbindungen funktionieren nicht oder eine Automation schlägt fehl — sind der Diagnosebefehl und die Automation-Schrittausgabe die beiden Ausgangspunkte. Levels Watchdog kümmert sich automatisch um das Beibehalten des Service am Laufen, daher suchen Sie in den meisten Fällen nach einem Konnektivitäts- oder Konfigurationsproblem, nicht nach einem Service-Problem.
Den Diagnosebefehl ausführen
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 Agenten, Systeminformationen, Level-Service-Status, Verbindungsprüfungen, Schlafeinstellungen und aktive Operationen abdeckt.
Windows |
|
macOS |
|
Linux |
|
Ausgabe lesen
Die Ausgabe ist in Abschnitte unterteilt. Hier ist, was jeder Ihnen sagt:
Agent — ID, Version, Erstellungsdatum, 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 (
Running/Ready).Verbindungsprüfungen — Der wichtigste Abschnitt für Offline-Probleme. Zeigt den Status jedes erforderlichen Endpunkts:
Prüfung | Was es testet |
| Grundlegende Internetverbindungsprüfung |
| Primärer Kommunikationskanal des Agenten zu Level |
| Uptime-Berichtsendpunkt |
| WebSocket-Verbindungsstatus ( |
Wenn eine davon einen Fehler anstelle von OK / Connected anzeigt, ist das Ihr grundlegendes Problem.
Schlafeinstellungen — Zeigt die aktuelle Sleep-/Timeout-Konfiguration des Geräts. Aggressive Schlafeinstellungen (besonders kurze DC-Timeouts) können dazu führen, dass Geräte intermittierend offline angezeigt werden.
Aktivitätsstatus — Zeigt aktive Operationen, die derzeit auf dem Agent ausgeführt werden, z. B.
Remote Management.
Nach dem Gesehenen sortieren
Verbindungsprüfungen zeigen Fehler (online.level.io, agents.level.io usw.):
Der Agent kann Level's Server nicht erreichen. Die Ursache ist fast immer Antivirus/EDR, das den Agenten blockiert, oder eine Firewall, die ausgehenden Datenverkehr blockiert. Siehe Antivirus/EDR-Fehlerkennungen und Offline-Troubleshooting.
Verbindungsprüfungen sind OK, aber Remote-Sitzungen sind auf Relay statt P2P:
Der Agent kann mit Level kommunizieren, aber direkte Peer-to-Peer-Verbindungen funktionieren nicht. Siehe Relay/P2P-Troubleshooting.
Level-Prüfungen zeigen Service oder Watchdog nicht im erwarteten Status:
Etwas verhindert aktiv, dass der Agent läuft — wahrscheinlich Antivirus/EDR-Quarantäne. Siehe Antivirus/EDR-Fehlerkennungen.
Automations- oder Skriptfehler
Bei Automationsproblemen hilft --check nicht direkt. Öffnen Sie stattdessen die Automation-Ausführung und erweitern Sie den fehlgeschlagenen Schritt. Jeder Schritt zeigt seine vollständige Ausgabe — Abgangscodes, Fehlermeldungen und alle Skriptausgaben, die auf stdout oder stderr geschrieben wurden.
In den meisten Fällen identifiziert der Fehler in der Schritt-Ausgabe die Ursache ohne weitere Schritte.
Support kontaktieren
Wenn Sie die Ursache nicht von --check oder der Schritt-Ausgabe identifizieren können, kann Level Support mit Ihnen tiefer graben. Wenn Sie uns kontaktieren, fügen Sie folgende Punkte ein:
Die vollständige Ausgabe von
--check(für Offline/Konnektivitätsprobleme)Der Automationsname und der spezifische Schritt, der fehlgeschlagen ist (für Automationsprobleme)
Die vollständige Fehlermeldung aus der Schritt-Ausgabe
FAQ
Level zeigt ein Gerät als offline an, aber ich kann es pingen und über andere Tools erreichen. Wo beginne ich? Führen Sie
--checkauf dem Gerät aus und sehen Sie sich den Abschnitt Verbindungsprüfungen an. Wennonline.level.iooderagents.level.ioFehler anzeigen, kann der Agent Level's Server nicht erreichen — wahrscheinlich Antivirus/EDR oder eine Firewall. Wenn alle Verbindungsprüfungen bestanden werden, senden Sie die vollständige Ausgabe an Level Support.Ein Automationsschritt ist fehlgeschlagen. Wie sehe ich, was schiefgelaufen ist? Öffnen Sie die Automationsausführung und erweitern Sie den fehlgeschlagenen Schritt. Die vollständige Ausgabe, einschließlich aller Fehlermeldungen oder Abgangscodes, wird dort angezeigt. Das reicht normalerweise aus, um das Problem ohne Support zu identifizieren.
Das Gerät wird periodisch offline, und dann kommt es von selbst zurück. Was verursacht das? Normalerweise Antivirus/EDR-Interferenz — einige Produkte blockieren Level intermittierend nach Signaturaktualisierungen, ohne eine sichtbare Warnung zu generieren. Ausführen
--checkwährend sich das Gerät im Offline-Status befindet, gibt Ihnen das klarste Bild. Siehe Antivirus/EDR-Fehlerkennungen wenn Verbindungsprüfungen Fehler anzeigen.