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 AV/EDR-Interferenz 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 nachstehenden 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 --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' --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 von beiden ein Problem zeigt, gibt --check allein nicht den Grund an. AV/EDR-Interferenz ist eine mögliche Ursache, sollte aber nur dann als Ursache betrachtet werden, wenn es Belege für eine Erkennung, Blockierung oder Quarantäne gibt. 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-(ICMP-)Prüfungen, während realtime client meldet die separate Echtzeitverbindung des Agenten. 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 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 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, zeigt das allein nicht den Grund. Betrachten Sie AV/EDR nur dann als Ursache, wenn es Belege für eine Erkennung, Blockierung oder Quarantäne gibt, z. B. einen Eintrag im Quarantäne- oder Aktivitätsprotokoll Ihrer Sicherheitssoftware. Wenn kein solcher Beleg vorhanden ist, ist die Ursache nicht festgestellt; senden Sie die vollständige --check Ausgabe (falls ausgeführt) und was Sie auf dem Datenträger gefunden haben, an den Level-Support.
Zur Untersuchung: Überprüfen Sie das Quarantäneprotokoll und den Aktivitätsverlauf Ihrer Sicherheitssoftware rund um den Zeitpunkt, als 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 ohne sichtbare Warnung.
Zur Behebung, nur wenn Ihre Sicherheitssoftware eine Erkennung, Blockierung oder Quarantäne von Level anzeigt: 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-Falscherkennung für Ausschlusspfade, Zertifikatsdetails 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 und es keine Belege für eine Erkennung oder Blockierung gibt, sind Ausschlüsse allein dadurch nicht angezeigt; senden Sie die vollständige --check Ausgabe an den Level-Support.
⚠️ WARNUNG: Wenn eine Erkennung, Blockierung oder Quarantäne von Level bestätigt ist, fügen Sie Ausschlüsse hinzu, bevor Sie den Agenten neu installieren; andernfalls kann dieselbe Erkennung die Binärdatei erneut entfernen. 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 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: Netzwerkzugang prüfen
Wenn der Level-Prüfungen Abschnitt fehlerfrei 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 die Level-Server möglicherweise 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 Agenten blockiert ist.
Der Agent benötigt ausgehenden Zugriff auf diese URLs:
URL | Zweck |
| Agentenkommunikation mit Level |
| Konnektivitätsstatusprüfungen |
| Agentenaktualisierungen |
| Erstinstallation des Agenten |
| 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, *.level.io und *.twilio.com die Level- und Twilio-Einträge oben abdecken.
Gefilterte WebSocket-Verbindungen beheben
Das Zulassen eines Hostnamens erlaubt nicht immer die Echtzeitverbindung. 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 ihre CNAME-Ziele ein, wenn Sie Netzwerk-Zulassungslisten und Ably-spezifische SSL/TLS-Entschlüsselungsausschlüsse konfigurieren.
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. Halten Sie Ausschlüsse auf die Ably-Hosts beschränkt, 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:
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 CNAME-Fallbackziele abdecken.Das WebSocket-Upgrade für diese Hosts erlauben.
SSL/TLS-Inspektion, Deep-Packet-Inspektion (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 die Filterung die Ursache ist. Führen Sie nach einer Änderung der Netzwerkrichtlinie --check erneut 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 Ausweichweg |
10.000–60.000 | UDP | TURN-Relay-Ports | 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 überwiegende Mehrheit der Szenarien ab. Siehe Relay/P2P-Fehlerbehebung wenn speziell Remote-Verbindungen fehlschlagen.
Schritt 4: Support kontaktieren
Wenn --check nicht auf eine klare Ursache hinweist, 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
FAQ
Warum pingt der Agent 8.8.8.8 an, und warum zeigt --check „Fehler: keine Ping-Statistiken", 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 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 Echtzeitverbindung des Agenten nicht erforderlich. Wenn das Gerät oder Netzwerk ICMP blockiert,--checkkannError: no ping statsfüronline.level.io,agents.level.io, und der Verfügbarkeitsmonitor und 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 es überhaupt nicht ausgeführt werden kann, prüfen Sie, oblevel.exe(Windows) oder dielevelBinärdatei (macOS/Linux) noch auf dem Datenträger vorhanden ist — wenn sie fehlt, zeigt das allein nicht den Grund; prüfen Sie das Quarantäneprotokoll Ihrer Sicherheitssoftware auf eine Erkennung, Blockierung oder Quarantäne von Level. Wenn die Binärdatei vorhanden ist, aber--checkzeigt den gestoppten Dienst oder Verbindungsprüfungsfehler, siehe AV/EDR-Falscherkennung für die Quarantäneprotokolluntersuchung und für Ausschlussschritte nur, wenn eine Erkennung oder Blockierung bestätigt ist.Ich habe derzeit keine Möglichkeit, remote auf das Gerät zuzugreifen. Was kann ich tun? Wenn Level Ihr einziges Remotezugriffswerkzeug auf dem Gerät ist, benötigen Sie physischen oder Out-of-Band-Zugang (iDRAC, iLO, KVM usw.), um zu untersuchen. 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 nur mit ausgehendem Port 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 zusätzliche Ports öffnen.
Die --check-Ausgabe sieht gut aus, aber das Gerät wird in Level immer noch als offline angezeigt. Die Konsole kann nach Wiederherstellung der Konnektivität ein bis zwei Minuten nachhängen. Wenn sie sich nicht aktualisiert, könnte das Problem intermittierend sein — versuchen Sie,
--checkerneut, wenn der Offline-Status wieder auftritt, um den Fehler im Moment des Auftretens zu erfassen.

