Zum Hauptinhalt springen

Offline-Fehlerbehebung

Diagnose why a Level device shows offline — AV/EDR interference, network requirements, and the --check diagnostic command.

Einführung

Wenn ein Gerät in Level als offline angezeigt wird, tatsächlich aber eingeschaltet und verbunden ist, liegt die Ursache fast immer an AV/EDR-Interferenzen oder einer Firewall, die die ausgehenden Verbindungen des Agenten blockiert. Beginnen Sie mit dem --check Befehl — er identifiziert den genauen Fehlerpunkt ohne Rätselraten.

ℹ️ HINWEIS: In den meisten Fällen funktioniert Level ohne Firewall-Änderungen. Die folgenden Netzwerkanforderungen gelten nur, wenn Sie sich in einem restriktiven Netzwerk befinden und aktiv Verbindungsprobleme haben.


Offline-Fehlerbehebung

Schritt 1: Diagnoseprüfung ausführen

Ausführen von --check auf dem betroffenen Gerät, während es Netzwerkzugriff hat. Es testet jeden Teil der Agenten-Konnektivität zu Level und meldet genau, wo der Fehler liegt.

🖥️ PLATTFORMHINWEIS:

  • Windows:& 'C:\Program Files\Level\level.exe' --check

  • macOS:sudo /usr/local/bin/level --check

  • Linux:sudo /usr/local/bin/level --check

Windows --check Example

Die zwei Abschnitte, auf die Sie sich konzentrieren sollten:

Level-Prüfungen — zeigt an, ob der Agentendienst und die Watchdog-Aufgabe im erwarteten Zustand sind (Running / Ready). Wenn einer davon ein Problem anzeigt, hat AV/EDR höchstwahrscheinlich die Agenten-Binärdatei unter Quarantäne gestellt. Der Watchdog hält den Dienst unter normalen Bedingungen am Laufen — wenn er es nicht tut, hat ihn etwas Externes gestoppt.

Verbindungsprüfungen — zeigt den Status von online.level.io, agents.level.io, uptime monitor, und realtime client. Die ersten drei sind Ping-Prüfungen (ICMP), während realtime client meldet die separate Echtzeit-Verbindung des Agenten. Error: no ping stats bedeutet, dass die Ping-Prüfung keine ICMP-Antworten erhalten hat. Wenn der Echtzeit-Client Connected, hat der Agent nach wie vor seine Echtzeit-Verbindung, auch wenn eine oder mehrere Ping-Prüfungen fehlschlagen.


Schritt 2: AV/EDR-Interferenz

Wenn --check zeigt den Dienst oder Watchdog nicht im erwarteten Zustand, oder wenn --check überhaupt nicht ausgeführt wird, prüfen Sie, ob die Level-Binärdatei noch auf dem Datenträger vorhanden ist:

🖥️ PLATTFORMHINWEIS:

  • Windows: suchen Sie nach level.exe in C:\Program Files\Level\

  • macOS: suchen Sie nach level unter /Applications/Level.app/Contents/MacOS/level

  • Linux: suchen Sie nach level unter /usr/local/bin/level

Wenn die Binärdatei fehlt, hat AV/EDR sie entfernt. Level verfügt über keinen Mechanismus, um die eigene Binärdatei zu löschen — eine fehlende ausführbare Datei bedeutet, dass Ihre Sicherheitssoftware sie unter Quarantäne gestellt oder gelöscht hat.

Zur Untersuchung: Überprüfen Sie das Quarantäneprotokoll und den Aktivitätsverlauf Ihrer Sicherheitssoftware rund um den Zeitpunkt, zu dem das Gerät offline ging. Suchen Sie nach Aktionen, die gegen level.exe oder verwandte Prozesse. Einige Produkte — SentinelOne, ESET und bestimmte Defender-Konfigurationen — tun dies still und ohne sichtbare Warnung.

Zur Behebung: Stellen Sie die Binärdatei aus der Quarantäne wieder her, falls möglich, und fügen Sie dann die entsprechenden Ausschlüsse hinzu, bevor Sie sie neu installieren. Siehe AV/EDR-Fehlerkennungen nach Ausschlusspfaden, Zertifikatdetails und einer Windows Defender-Automatisierung, die Sie auf Geräten bereitstellen können. Wenn die Binärdatei noch vorhanden ist, der Dienst aber gestoppt ist, gelten dieselben Ausschlussschritte — das AV blockiert wahrscheinlich die Ausführung, anstatt die Datei zu entfernen.

⚠️ WARNUNG: Wenn Sie den Agenten neu installieren, ohne vorher Ausschlüsse hinzuzufügen, wird AV/EDR die Binärdatei erneut entfernen. Fügen Sie Ausschlüsse hinzu, bevor Sie neu installieren. Beachten Sie außerdem: AV/EDR-Erkennungen gegen Level sind verhaltensbasiert, nicht signaturbasiert. Das bedeutet, dass dieselbe Sicherheitssoftware auf 50 Geräten laufen und Level nur auf einigen wenigen markieren kann — es hängt davon ab, was der Agent zu dem Zeitpunkt getan hat, als die Erkennung ausgelöst wurde, nicht von einem Definitionsupdate. Gehen Sie nicht davon aus, dass ein sauberes Gerät bedeutet, dass Ihre Ausschlüsse korrekt funktionieren.


Schritt 3: Netzwerkzugriff prüfen

Wenn der Level-Prüfungen Abschnitt sieht fehlerfrei aus, aber Verbindungsprüfungen Fehler anzeigen, vergleichen Sie die drei Ping-Prüfungen mit realtime client:

  • Wenn realtime client ebenfalls einen Fehler anzeigt, ist der Agent möglicherweise nicht in der Lage, die Level-Server zu erreichen. Prüfen Sie, ob eine Firewall oder ein Proxy die folgenden ausgehenden Verbindungen blockiert.

  • Wenn die Ping-Prüfungen Error: no ping stats während realtime client ist Connected, prüfen Sie, ob das Gerät oder die Netzwerk-Firewall ICMP blockiert. Dieses Ergebnis allein bedeutet nicht, dass die Echtzeit-Verbindung des Agenten blockiert ist.

Der Agent benötigt ausgehenden Zugriff auf diese URLs:

URL

Zweck

agents.level.io

Agentenkommunikation mit Level

online.level.io

Konnektivitätsstatusüberprüfungen

builds.level.io

Agentenaktualisierungen

downloads.level.io

Erstinstallation des Agenten

realtime.ably.io

Echtzeit-WebSocket für die Level-API

prd-level-storage.s3.wasabisys.com

Dateispeicherung für Automatisierungen

global.turn.twilio.com

TURN-Relay (wird verwendet, wenn P2P fehlschlägt)

global.stun.twilio.com

STUN (wird verwendet, wenn P2P fehlschlägt)

logs.logdna.com

Protokollerfassung zur Fehlerbehebung

💡 TIPP: Für Firewalls, die Platzhalterregeln unterstützen, decken *.level.io und *.twilio.com decken die Level- und Twilio-Einträge oben ab.

Gefilterte WebSocket-Verbindungen beheben

Das Erlauben eines Hostnamens erlaubt nicht immer die Echtzeit-Verbindung. Ein Inhaltsfilter, eine Firewall oder ein Proxy kann den WebSocket-Datenverkehr dennoch blockieren, untersuchen, umschreiben oder schließen.

Wenn realtime client einen Fehler in einem gefilterten Netzwerk meldet, bitten Sie den Netzwerkadministrator oder Filteranbieter:

  • Ausgehende TCP-443-WebSocket-Verbindungen zu *.ably.io und *.ably-realtime.com.

  • Das WebSocket-Upgrade für diese Hosts zulassen.

  • SSL/TLS-Inspektion, Deep Packet Inspection (DPI), Bedrohungsinspektion und Inhaltsumschreibung für diese Hosts umgehen.

  • Sicherstellen, dass Proxy- und Sitzungs-Timeout-Richtlinien langlebige WebSocket-Verbindungen nicht beenden.

Diese Einstellungen sind Fehlerbehebungsanforderungen für gefilterte Netzwerke. Ein Echtzeit-Client-Fehler beweist für sich allein nicht, dass die Filterung die Ursache ist. Nachdem Sie die Netzwerkrichtlinie geändert haben, führen Sie --check erneut und bestätigen Sie, dass realtime client meldet Connected.

Erforderliche Ports (nur ausgehend):

Port

Protokoll

Zweck

Hinweise

80

TCP

HTTP

Grundlegende Konnektivität

443

TCP

HTTPS

Primärer Agentenverkehr

3478

TCP & UDP

TURN

Wird verwendet, wenn P2P fehlschlägt

5349

TCP

TURN TLS

Nur als letzter Ausweg als Fallback

10.000–60.000

UDP

TURN-Relay-Ports

Wird von Twilio zugewiesen, wenn TURN verwendet wird

ℹ️ HINWEIS: Die Ports 3478, 5349 und der UDP-Bereich werden nur benötigt, wenn P2P-Verbindungen nicht hergestellt werden können. Beginnen Sie mit 80 und 443 — das deckt die große Mehrheit der Szenarien ab. Siehe Relay/P2P-Fehlerbehebung wenn speziell Remote-Verbindungen fehlschlagen.


Schritt 4: Support kontaktieren

Wenn --check nicht auf eine klare Ursache hindeutet, wenden Sie sich mit folgenden Informationen an den Level-Support:

  • Die vollständige Ausgabe von --check

  • Verwendete AV/EDR-Software (Name und Version)

  • Jede Firewall- oder Proxy-Software zwischen dem Gerät und dem Internet


Häufig gestellte Fragen

  • Warum pingt der Agent 8.8.8.8 an, und warum zeigt --check „Fehler: keine Ping-Statistiken", obwohl die Echtzeit-Verbindung verbunden ist? Der Agent führt eine integrierte Latenzmessung durch (ICMP an 8.8.8.8, etwa alle 50 Sekunden). Diese Prüfung ist von der Netzwerk-Ping-Monitor und ist heute fest kodiert — es gibt keine Einstellung, um das Ziel zu ändern oder nur diese Prüfung zu deaktivieren. ICMP ist für die Kern-API oder Echtzeit-Verbindung des Agenten nicht erforderlich. Wenn das Gerät oder Netzwerk ICMP blockiert, --check meldet möglicherweise Error: no ping stats für online.level.io, agents.level.io, und der Betriebszeitmonitor sowie der Durchschnittspingwert können leer bleiben — selbst wenn realtime client zeigt Connected. Siehe Netzwerk-Ping-Monitor.

  • Das Gerät war gestern online und ist gerade offline gegangen. Wo fange ich an? Führen Sie --check zuerst. Wenn er überhaupt nicht ausgeführt wird, prüfen Sie, ob level.exe (Windows) oder die level Binärdatei (macOS/Linux) noch auf dem Datenträger vorhanden ist — wenn sie fehlt, hat AV/EDR sie entfernt. Wenn die Binärdatei vorhanden ist, aber --check den Dienst als gestoppt oder Verbindungsprüfungsfehler anzeigt, siehe AV/EDR-Fehlerkennungen für die Quarantäneprotokoll-Untersuchung und die Ausschlussschritte.

  • Ich habe derzeit keine Möglichkeit, remote auf das Gerät zuzugreifen. Was kann ich tun? Wenn Level Ihr einziges Fernzugriffswerkzeug auf dem Gerät ist, benötigen Sie physischen oder Out-of-Band-Zugriff (iDRAC, iLO, KVM usw.) zur Untersuchung. Sobald Sie Zugriff haben, führen Sie --check um die Ursache zu ermitteln, bevor Sie irgendetwas anderes tun.

  • Muss ich all diese Ports in meiner Firewall öffnen? Nicht, es sei denn, Sie haben Probleme. Die meisten Netzwerke funktionieren nur mit den ausgehenden Ports 80 und 443. Die TURN-Ports (3478, 5349) und der UDP-Bereich sind nur relevant, wenn P2P-Verbindungen fehlschlagen — siehe Relay/P2P-Fehlerbehebung bevor Sie weitere Ports öffnen.

  • Die --check-Ausgabe sieht korrekt aus, aber das Gerät wird in Level immer noch als offline angezeigt. Die Konsole kann nach der Wiederherstellung der Verbindung ein bis zwei Minuten verzögert sein. Wenn sie sich nicht aktualisiert, kann das Problem zeitweise auftreten — versuchen Sie, --check erneut aus, wenn der Offline-Status erneut auftritt, um den Fehler in flagranti zu erwischen.

Hat dies deine Frage beantwortet?