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' --checkmacOS:
sudo /usr/local/bin/level --checkLinux:
sudo /usr/local/bin/level --check
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.exeinC:\Program Files\Level\macOS: suchen Sie nach
levelunter/Applications/Level.app/Contents/MacOS/levelLinux: suchen Sie nach
levelunter/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 clientebenfalls 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 statswährendrealtime clientistConnected, 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 |
| Agentenkommunikation mit Level |
| Konnektivitätsstatusüberprüfungen |
| Agentenaktualisierungen |
| Erstinstallation des Agenten |
| Echtzeit-WebSocket für die Level-API |
| Dateispeicherung 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.
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.iound*.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
--checkVerwendete 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,--checkmeldet möglicherweiseError: no ping statsfüronline.level.io,agents.level.io, und der Betriebszeitmonitor 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? Führen Sie
--checkzuerst. Wenn er überhaupt nicht ausgeführt wird, prüfen Sie, oblevel.exe(Windows) oder dielevelBinä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--checkden 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
--checkum 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,
--checkerneut aus, wenn der Offline-Status erneut auftritt, um den Fehler in flagranti zu erwischen.

