Zum Hauptinhalt springen

Fehlerbehebung bei Offline-Problemen

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, aber tatsächlich eingeschaltet und verbunden ist, liegt die Ursache fast immer an einer AV/EDR-Interferenz oder einer Firewall, die die ausgehenden Verbindungen des Agents blockiert. Beginnen Sie mit dem --check Befehl — er identifiziert den genauen Fehlerpunkt ohne Raten.

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


Fehlerbehebung bei Offline-Problemen

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 Verbindung des Agents 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 Agent-Dienst und die Watchdog-Aufgabe im erwarteten Zustand sind (Running / Ready). Wenn einer von beiden ein Problem zeigt, 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 das 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 Echtzeitverbindung des Agents. Error: no ping stats bedeutet, dass die Ping-Prüfung keine ICMP-Antworten erhalten hat. Wenn der Realtime-Client Connected, hat der Agent weiterhin seine Echtzeitverbindung, auch wenn eine oder mehrere Ping-Prüfungen fehlschlagen.


Schritt 2: AV/EDR-Interferenz

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

🖥️ PLATTFORMHINWEIS:

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

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

  • Linux: suchen nach level bei /usr/local/bin/level

Wenn die Binärdatei fehlt, wurde sie von AV/EDR entfernt. Level verfügt über keinen Mechanismus zum Löschen der eigenen Binärdatei — 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 gegangen ist. Achten Sie auf jegliche Aktionen gegen level.exe oder verwandte Prozesse. Einige Produkte — SentinelOne, ESET und bestimmte Defender-Konfigurationen — tun dies still ohne sichtbare Warnung.

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

⚠️ WARNUNG: Wenn Sie den Agent ohne vorherige Ausschlüsse neu installieren, wird AV/EDR die Binärdatei erneut entfernen. Fügen Sie Ausschlüsse hinzu, bevor Sie neu installieren. Außerdem zu beachten: 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 wenigen markieren kann — es hängt davon ab, was der Agent zum Zeitpunkt der Erkennung getan hat, nicht von einem Definitionsupdate. Nehmen Sie nicht an, dass ein sauberes Gerät bedeutet, dass Ihre Ausschlüsse korrekt funktionieren.


Schritt 3: Netzwerkzugriff prüfen

Wenn der Level-Prüfungen Abschnitt gesund aussieht, 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 Echtzeitverbindung des Agents blockiert ist.

Der Agent benötigt ausgehenden Zugriff auf diese URLs:

URL

Zweck

agents.level.io

Agent-Kommunikation mit Level

online.level.io

Verbindungsstatusüberprüfungen

builds.level.io

Agent-Aktualisierungen

downloads.level.io

Erstinstallation des Agents

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

Fehlerbehebung bei gefilterten WebSocket-Verbindungen

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

Ably-Endpunkt-CNAMEs: Die Endpunkt-Hostnamen von Ably sind DNS-Aliase. Schließen Sie beim Konfigurieren von Netzwerk-Allowlists und Ably-spezifischen SSL/TLS-Entschlüsselungsausschlüssen sowohl die Endpunkt-Hostnamen als auch ihre CNAME-Ziele ein.

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 Echtzeitverbindung beeinträchtigt, stellen Sie sicher, dass Ihre gezielten Ably-Entschlüsselungsausschlüsse dieses CNAME-Ziel sowie den Endpunkt-Hostnamen umfassen. 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 den 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 Fehlerbehebungsanforderungen für gefilterte Netzwerke. Ein Realtime-Client-Fehler beweist allein nicht, dass Filterung die Ursache ist. Führen Sie nach einer Änderung der Netzwerkrichtlinie --check erneut ausführen 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 Agent-Datenverkehr

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 zugewiesen, 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 überwiegende Mehrheit der Szenarien ab. Siehe Fehlerbehebung bei Relay/P2P wenn speziell Fernverbindungen fehlschlagen.


Schritt 4: Support kontaktieren

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

  • 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


FAQ

  • Warum pingt der Agent 8.8.8.8 an, und warum zeigt --check „Error: no ping stats", obwohl Realtime verbunden ist? Der Agent führt eine integrierte Latenzprüfung aus (ICMP an 8.8.8.8, etwa alle 50 Sekunden). Diese Prüfung ist getrennt von der Netzwerk-Ping-Monitor und ist heute fest codiert — es gibt keine Einstellung, um das Ziel zu ändern oder nur diese Prüfung zu deaktivieren. ICMP ist nicht für die Kern-API oder Echtzeitverbindung des Agents erforderlich. Wenn das Gerät oder Netzwerk ICMP blockiert, --check kann Error: no ping stats für online.level.io, agents.level.io, und der Uptime-Monitor 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? Ausführen von --check zuerst. Wenn sie überhaupt nicht ausgeführt wird, prüfen Sie, ob level.exe (Windows) oder die level Binärdatei (macOS/Linux) noch auf der Festplatte vorhanden ist — wenn sie fehlt, wurde sie von AV/EDR entfernt. Wenn die Binärdatei vorhanden ist, aber --check zeigt den Dienst als gestoppt oder Verbindungsprüfungsfehler, siehe AV/EDR-Fehlalarme 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-Zugang (iDRAC, iLO, KVM usw.) zur Untersuchung. Sobald Sie Zugang haben, führen Sie --check um die Ursache zu identifizieren, bevor Sie irgendetwas anderes tun.

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

  • Die --check-Ausgabe sieht gut aus, aber das Gerät wird in Level weiterhin als offline angezeigt. Die Konsole kann nach Wiederherstellung der Verbindung ein bis zwei Minuten verzögert sein. Wenn sie sich nicht aktualisiert, könnte das Problem intermittierend sein — versuchen Sie, --check erneut ausführen, wenn der Offline-Status erneut auftritt, um den Fehler im Moment des Auftretens zu erfassen.

Hat dies deine Frage beantwortet?