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' --checkmacOS:
sudo /usr/local/bin/level --checkLinux:
sudo /usr/local/bin/level --check
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.exeinC:\Program Files\Level\macOS: suchen nach
levelbei/Applications/Level.app/Contents/MacOS/levelLinux: suchen nach
levelbei/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 clientebenfalls 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 statswährendrealtime clientistConnected, 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 |
| Agent-Kommunikation mit Level |
| Verbindungsstatusüberprüfungen |
| Agent-Aktualisierungen |
| Erstinstallation des Agents |
| Echtzeit-WebSocket für Level API (Endpunkt und CNAME-Ziel) |
| Dateispeicher für Automatisierungen |
| TURN-Relay (wird verwendet, wenn P2P fehlschlägt) |
| STUN (wird verwendet, wenn P2P fehlschlägt) |
| 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 |
|
|
|
|
|
|
|
|
|
|
|
|
ℹ️ 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
--checkVerwendete 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,--checkkannError: no ping statsfüronline.level.io,agents.level.io, und der Uptime-Monitor sowie der Durchschnittspingwert können leer bleiben — selbst wennrealtime clientzeigtConnected. Siehe Netzwerk-Ping-Monitor.Das Gerät war gestern online und ist gerade offline gegangen. Wo fange ich an? Ausführen von
--checkzuerst. Wenn sie überhaupt nicht ausgeführt wird, prüfen Sie, oblevel.exe(Windows) oder dielevelBinä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--checkzeigt 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
--checkum 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,
--checkerneut ausführen, wenn der Offline-Status erneut auftritt, um den Fehler im Moment des Auftretens zu erfassen.

