Zum Hauptinhalt springen

Offline-Fehlerbehebung

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 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' --check

  • macOS: sudo /usr/local/bin/level --check

  • Linux: sudo /usr/local/bin/level --check

Windows --check Example

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.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, 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 client ebenfalls 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 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 Agenten blockiert ist.

Der Agent benötigt ausgehenden Zugriff auf diese 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 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

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. 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 --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 „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, --check kann Error: no ping stats für online.level.io, agents.level.io, und der Verfügbarkeitsmonitor und 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? Führen Sie --check zuerst. Wenn es überhaupt nicht ausgeführt werden kann, prüfen Sie, ob level.exe (Windows) oder die level Binä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 --check zeigt 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 --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 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, --check erneut, wenn der Offline-Status wieder auftritt, um den Fehler im Moment des Auftretens zu erfassen.

Hat dies deine Frage beantwortet?