Zum Hauptinhalt springen

Fehlerbehebung bei Offline-Geräten

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

Einleitung

Wenn ein Gerät in Level als offline angezeigt wird, aber tatsächlich eingeschaltet und verbunden ist, liegt die Ursache fast immer an AV/EDR-Interferenzen oder einer Firewall, die ausgehende 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.


Fehlerbehebung bei Offline-Geräten

Schritt 1: Diagnoseprüfung ausführen

Führen Sie --check auf dem betroffenen Gerät, während es Netzwerkzugang hat. Es testet jeden Teil der Konnektivität des Agenten 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 zu achten ist:

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 Agent-Binärdatei unter Quarantäne gestellt. Der Watchdog hält den Dienst unter normalen Bedingungen am Laufen — wenn dies nicht der Fall ist, hat etwas Externes ihn 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 seine Echtzeit-Verbindung noch, 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 werden kann, prüfen Sie, ob die Level-Binärdatei noch auf der Festplatte 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 hat keinen Mechanismus, um seine 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, als das Gerät offline ging. Achten Sie auf jede Aktion 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 neu installieren. Siehe AV/EDR-Fehlerkennungen für Ausschlusspfade, Zertifikatdetails und eine Windows Defender-Automatisierung, die Sie auf Geräten bereitstellen können. Wenn die Binärdatei noch vorhanden ist, aber der Dienst 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 zuerst Ausschlüsse hinzuzufügen, wird AV/EDR die Binärdatei erneut entfernen. Fügen Sie Ausschlüsse vor der Neuinstallation hinzu. Zusätzlicher Hinweis: AV/EDR-Erkennungen gegen Level basieren auf Verhalten, nicht auf Signaturen. Das bedeutet, dass dieselbe Sicherheitssoftware auf 50 Geräten laufen und Level nur auf einigen markieren kann — es hängt davon ab, was der Agent zum Zeitpunkt der Erkennung getan hat, nicht von einem Definitionsupdate. Gehen Sie nicht davon aus, dass ein sauberes Gerät bedeutet, dass Ihre Ausschlüsse korrekt funktionieren.


Schritt 3: Netzwerkzugang 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, kann der Agent möglicherweise die Level-Server nicht 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 folgende URLs:

URL

Zweck

agents.level.io

Agentenkommunikation mit Level

online.level.io

Konnektivitätsstatusprüfungen

builds.level.io

Agentenaktualisierungen

downloads.level.io

Erstinstallation des Agenten

realtime.ably.io
​main.realtime.ably.net

Echtzeit-WebSocket für Level API (Endpunkt und CNAME-Ziel)

prd-level-storage.s3.wasabisys.com

Dateispeicher 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, *.level.io und *.twilio.com decken die Level- und Twilio-Einträge oben ab.

Gefilterte WebSocket-Verbindungen beheben

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

Ably-Endpunkt-CNAMEs: Die Endpunkt-Hostnamen von Ably sind DNS-Aliase. Schließen Sie sowohl die Endpunkt-Hostnamen als auch deren CNAME-Ziele ein, wenn Sie Netzwerk-Erlaubnislisten und Ably-spezifische SSL/TLS-Entschlüsselungsausschlüsse konfigurieren.

Ably-Endpunkt

DNS-CNAME-Ziel

rest.ably.io
​realtime.ably.io

main.realtime.ably.net

a.ably-realtime.com

main.a.fallback.ably-realtime.com

b.ably-realtime.com

main.b.fallback.ably-realtime.com

c.ably-realtime.com

main.c.fallback.ably-realtime.com

d.ably-realtime.com

main.d.fallback.ably-realtime.com

e.ably-realtime.com

main.e.fallback.ably-realtime.com

ℹ️ HINWEIS: Eine Regel für *.ably.io enthält nicht main.realtime.ably.net. Wenn die SSL/TLS-Inspektion die Echtzeit-Verbindung beeinträchtigt, stellen Sie sicher, dass Ihre gezielten Ably-Entschlüsselungsausschlüsse dieses CNAME-Ziel sowie den Endpunkt-Hostnamen einschließen. Beschränken Sie Ausschlüsse auf die Ably-Hosts, anstatt die Inspektion im gesamten Netzwerk zu deaktivieren. Überprüfen Sie die aktuelle Endpunkt- und CNAME-Liste in Netzwerkanforderungen von Ably.

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

  • Ausgehende TCP 443 WebSocket-Verbindungen zu *.ably.io, main.realtime.ably.net, und *.ably-realtime.com. Stellen Sie sicher, dass Platzhalterregeln auch die oben aufgeführten Fallback-CNAME-Ziele abdecken.

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

  • SSL/TLS-Inspektion, Deep Packet Inspection (DPI), Bedrohungsinspektion und Inhaltsumschreibung für sowohl die Endpunkt-Hostnamen als auch die oben aufgeführten CNAME-Ziele umgehen.

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

Diese Einstellungen sind Anforderungen zur Fehlerbehebung für gefilterte Netzwerke. Ein Echtzeit-Client-Fehler beweist für sich allein nicht, dass Filterung die Ursache ist. Führen Sie nach der Änderung der Netzwerkrichtlinie --check erneut aus und bestätigen, dass realtime client meldet Connected.

Erforderliche Ports (nur ausgehend):

Port

Protokoll

Zweck

Hinweise

80

TCP

HTTP

Grundlegende Konnektivität

443

TCP

HTTPS

Primärer Agentendatenverkehr

3478

TCP & UDP

TURN

Wird verwendet, wenn P2P fehlschlägt

5349

TCP

TURN TLS

Nur als letzter Ausweg

10.000–60.000

UDP

TURN-Relay-Ports

Von Twilio zugeteilt, wenn TURN verwendet wird

ℹ️ HINWEIS: 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 Fernverbindungen im Besonderen fehlschlagen.


Schritt 4: Support kontaktieren

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

  • Die vollständige Ausgabe von --check

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

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


FAQ

  • Warum sendet der Agent Pings an 8.8.8.8, und warum zeigt --check „Fehler: keine Ping-Statistiken" an, während die Echtzeit-Verbindung als Verbunden gilt? Der Agent führt eine integrierte Latenzprüfung durch (ICMP an 8.8.8.8, etwa alle 50 Sekunden). Diese Prüfung ist separat vom 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 kann melden Error: no ping stats für online.level.io, agents.level.io, und der Verfügbarkeitsmonitor sowie der Durchschnittspingwert können leer bleiben — auch 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 sie überhaupt nicht ausgeführt werden kann, prüfen Sie, ob level.exe (Windows) oder die level Binärdatei (macOS/Linux) noch auf der Festplatte vorhanden ist — wenn sie fehlt, hat AV/EDR sie entfernt. Wenn die Binärdatei vorhanden ist, aber --check zeigt den Dienst als gestoppt oder Verbindungsprüfungsfehler an, siehe AV/EDR-Fehlerkennungen für die Untersuchung des Quarantäneprotokolls 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-Zugang (iDRAC, iLO, KVM usw.), um die Untersuchung durchzuführen. Sobald Sie Zugang haben, führen Sie --check um die Ursache zu ermitteln, bevor Sie sonst etwas tun.

  • Muss ich all diese Ports in meiner Firewall öffnen? Nur wenn Sie Probleme haben. Die meisten Netzwerke funktionieren nur mit 80 und 443 ausgehend. Die TURN-Ports (3478, 5349) und der UDP-Bereich sind nur relevant, wenn P2P-Verbindungen fehlschlagen — siehe Relay/P2P-Fehlerbehebung bevor Sie zusätzliche Ports öffnen.

  • Die --check-Ausgabe sieht gut aus, aber das Gerät wird in Level noch immer als offline angezeigt. Die Konsole kann nach der Wiederherstellung der Konnektivität ein bis zwei Minuten verzögert sein. Wenn sie sich nicht aktualisiert, könnte das Problem vorübergehend sein — versuchen Sie, --check erneut aus, wenn der Offline-Status wieder auftritt, um den Fehler in Echtzeit zu erfassen.

Hat dies deine Frage beantwortet?