Introducción
Si un dispositivo aparece sin conexión en Level pero en realidad está encendido y conectado, la causa casi siempre es la interferencia de un AV/EDR o un firewall que bloquea las conexiones salientes del agente. Comience con el --check — identifica el punto exacto del fallo sin necesidad de conjeturas.
ℹ️ NOTA: En la mayoría de los casos, Level funciona sin ningún cambio en el firewall. Los requisitos de red que se indican a continuación solo se aplican si se encuentra en una red restrictiva y está experimentando problemas de conectividad activamente.
Solución de problemas sin conexión
Paso 1: Ejecutar la verificación de diagnóstico
Ejecutar --check en el dispositivo afectado mientras tiene acceso a la red. Prueba cada parte de la conectividad del agente con Level e informa exactamente dónde se produce el fallo.
🖥️ NOTA DE PLATAFORMA:
Windows:
& 'C:\Program Files\Level\level.exe' --checkmacOS:
sudo /usr/local/bin/level --checkLinux:
sudo /usr/local/bin/level --check
Las dos secciones en las que debe centrarse:
Verificaciones de Level — muestra si el servicio del agente y la tarea watchdog se encuentran en el estado esperado (Running / Ready). Si alguna muestra un problema, es muy probable que el AV/EDR haya puesto en cuarentena el binario del agente. El watchdog mantiene el servicio en ejecución en condiciones normales — si no lo está, algo externo lo detuvo.
Verificaciones de conexión — muestra el estado de online.level.io, agents.level.io, uptime monitor, y realtime client. Los tres primeros son verificaciones de ping (ICMP), mientras que realtime client informa la conexión en tiempo real separada del agente. Error: no ping stats significa que la verificación de ping no recibió respuestas ICMP. Si el cliente en tiempo real está Connected, el agente mantiene su conexión en tiempo real incluso cuando una o más verificaciones de ping fallan.
Paso 2: Interferencia de AV/EDR
Si --check muestra el servicio o watchdog que no está en el estado esperado, o si --check no se ejecuta en absoluto, compruebe si el binario de Level todavía está presente en el disco:
🖥️ NOTA DE PLATAFORMA:
Windows: busque
level.exeenC:\Program Files\Level\macOS: busque
levelen/Applications/Level.app/Contents/MacOS/levelLinux: busque
levelen/usr/local/bin/level
Si el binario no está presente, el AV/EDR lo eliminó. Level no tiene ningún mecanismo para eliminar su propio binario — si el ejecutable no está presente, significa que su software de seguridad lo puso en cuarentena o lo eliminó.
Para investigar: Revise el registro de cuarentena y el historial de actividad de su software de seguridad en torno al momento en que el dispositivo quedó sin conexión. Busque cualquier acción tomada contra level.exe o procesos relacionados. Algunos productos — SentinelOne, ESET y ciertas configuraciones de Defender — lo hacen de forma silenciosa, sin ninguna alerta visible.
Para corregir: Restaure el binario desde la cuarentena si es posible, y luego agregue las exclusiones apropiadas antes de reinstalar. Consulte Detecciones falsas de AV/EDR para las rutas de exclusión, los detalles del certificado y una automatización de Windows Defender que puede implementar en todos los dispositivos. Si el binario todavía está presente pero el servicio está detenido, se aplican los mismos pasos de exclusión — es probable que el AV esté bloqueando la ejecución en lugar de eliminar el archivo.
⚠️ ADVERTENCIA: Si reinstala el agente sin agregar exclusiones primero, el AV/EDR eliminará el binario nuevamente. Agregue las exclusiones antes de reinstalar. Tenga también en cuenta: Las detecciones de AV/EDR contra Level se basan en el comportamiento, no en firmas. Esto significa que el mismo software de seguridad puede ejecutarse en 50 dispositivos y solo marcar Level en algunos — depende de lo que el agente estaba haciendo en el momento en que se desencadenó la detección, no de una actualización de definiciones. No asuma que un dispositivo limpio significa que sus exclusiones están funcionando correctamente.
Paso 3: Verificar el acceso a la red
Si la Verificaciones de Level la sección se ve correcta pero Verificaciones de conexión muestran errores, compare las tres verificaciones de ping con realtime client:
Si
realtime clienttambién muestra un error, es posible que el agente no pueda llegar a los servidores de Level. Compruebe si hay un firewall o proxy que bloquee las conexiones salientes que se indican a continuación.Si las verificaciones de ping muestran
Error: no ping statsmientrasrealtime clientestáConnected, compruebe si el dispositivo o el firewall de red bloquea ICMP. Ese resultado por sí solo no significa que la conexión en tiempo real del agente esté bloqueada.
El agente necesita acceso saliente a estas URL:
URL | Propósito |
| Comunicación del agente con Level |
| Verificaciones del estado de conectividad |
| Actualizaciones del agente |
| Instalación inicial del agente |
| WebSocket en tiempo real para la API de Level (endpoint y destino CNAME) |
| Almacenamiento de archivos para automatizaciones |
| Retransmisión TURN (se usa cuando falla P2P) |
| STUN (se usa cuando falla P2P) |
| Recopilación de registros para solución de problemas |
💡 CONSEJO: Para los firewalls que admiten reglas con comodines, *.level.io y *.twilio.com cubren las entradas de Level y Twilio anteriores.
Solución de problemas de conexiones WebSocket filtradas
Permitir un nombre de host no siempre permite la conexión en tiempo real. Un filtro de contenido, firewall o proxy puede seguir bloqueando, inspeccionando, reescribiendo o cerrando el tráfico WebSocket.
CNAME de los endpoints de Ably: Los nombres de host de los endpoints de Ably son alias DNS. Incluya tanto los nombres de host de los endpoints como sus destinos CNAME al configurar las listas de permitidos de red y las exclusiones de descifrado SSL/TLS específicas de Ably.
Endpoint de Ably | Destino DNS CNAME |
|
|
|
|
|
|
|
|
|
|
|
|
ℹ️ NOTA: Una regla para *.ably.io no incluye main.realtime.ably.net. Si la inspección SSL/TLS interfiere con la conexión en tiempo real, asegúrese de que sus exclusiones de descifrado de Ably específicas incluyan este destino CNAME, así como el nombre de host del endpoint. Mantenga las exclusiones limitadas a los hosts de Ably en lugar de deshabilitar la inspección en toda la red. Verifique el endpoint actual y la lista de CNAME en Requisitos de red de Ably.
Si realtime client reporta un error en una red filtrada, solicite al administrador de red o al proveedor de filtrado que:
Permita conexiones WebSocket TCP 443 salientes a
*.ably.io,main.realtime.ably.net, y*.ably-realtime.com. Asegúrese de que las reglas con comodines también cubran los destinos CNAME de respaldo indicados anteriormente.Autorice la actualización WebSocket para esos hosts.
Omita la inspección SSL/TLS, la inspección profunda de paquetes (DPI), la inspección de amenazas y la reescritura de contenido tanto para los nombres de host de los endpoints como para los destinos CNAME indicados anteriormente.
Asegúrese de que las políticas de tiempo de espera de proxy y de sesión no finalicen las conexiones WebSocket de larga duración.
Estos ajustes son requisitos de solución de problemas para redes filtradas. Un error del cliente en tiempo real no prueba por sí solo que el filtrado sea la causa. Después de cambiar la política de red, ejecute --check nuevamente y confirme que realtime client reporta Connected.
Puertos requeridos (solo salientes):
Puerto | Protocolo | Propósito | Notas |
80 | TCP | HTTP | Conectividad básica |
443 | TCP | HTTPS | Tráfico principal del agente |
3478 | TCP & UDP | TURN | Se usa cuando falla P2P |
5349 | TCP | TURN TLS | Solo como último recurso de respaldo |
10,000–60,000 | UDP | Puertos de retransmisión TURN | Asignados por Twilio cuando se usa TURN |
ℹ️ NOTA: Los puertos 3478, 5349 y el rango UDP solo son necesarios cuando no se pueden establecer conexiones P2P. Comience con 80 y 443 — eso cubre la gran mayoría de los escenarios. Consulte Solución de problemas de retransmisión/P2P si las conexiones remotas específicamente están fallando.
Paso 4: Contactar con el soporte técnico
Si --check no apunta a una causa clara, póngase en contacto con el soporte de Level con:
La salida completa de
--checkSoftware AV/EDR en uso (nombre y versión)
Cualquier software de firewall o proxy entre el dispositivo e internet
Preguntas frecuentes
¿Por qué el agente hace ping a 8.8.8.8 y por qué --check muestra Error: no ping stats mientras el tiempo real está conectado? El agente ejecuta una sonda de latencia integrada (ICMP a
8.8.8.8, aproximadamente cada 50 segundos). Esa sonda es independiente del Monitor de ping de red y está codificado de forma fija actualmente — no existe ningún ajuste para cambiar el destino ni para deshabilitar únicamente esa sonda. ICMP no es necesario para la conexión principal de la API o en tiempo real del agente. Si el dispositivo o la red bloquea ICMP,--checkpuede reportarError: no ping statsparaonline.level.io,agents.level.io, y el monitor de tiempo de actividad, y el valor de ping promedio puede permanecer en blanco — incluso cuandorealtime clientmuestraConnected. Consulte Monitor de ping de red.El dispositivo estaba en línea ayer y acaba de quedarse sin conexión. ¿Por dónde empiezo? Ejecute
--checkprimero. Si no se ejecuta en absoluto, compruebe silevel.exe(Windows) o ellevelbinario (macOS/Linux) todavía está presente en el disco — si no está, el AV/EDR lo eliminó. Si el binario está pero--checkmuestra el servicio detenido o fallos en la verificación de conexión, consulte Detecciones falsas de AV/EDR para la investigación del registro de cuarentena y los pasos de exclusión.No tengo ninguna forma de acceder al dispositivo de forma remota en este momento. ¿Qué puedo hacer? Si Level es su única herramienta de acceso remoto en el dispositivo, necesitará acceso físico o fuera de banda (iDRAC, iLO, KVM, etc.) para investigar. Una vez que tenga acceso, ejecute
--checkpara identificar la causa antes de hacer cualquier otra cosa.¿Necesito abrir todos estos puertos en mi firewall? No, a menos que esté experimentando problemas. La mayoría de las redes funcionan solo con los puertos 80 y 443 salientes. Los puertos TURN (3478, 5349) y el rango UDP solo son relevantes si las conexiones P2P están fallando — consulte Solución de problemas de retransmisión/P2P antes de abrir puertos adicionales.
La salida de --check parece correcta pero el dispositivo sigue apareciendo sin conexión en Level. La consola puede tardar uno o dos minutos en actualizarse después de que se restaura la conectividad. Si no se actualiza, el problema puede ser intermitente — intente ejecutar
--checknuevamente cuando el estado sin conexión se repita para detectar el fallo en el momento.

