Introducción
Si un dispositivo aparece sin conexión en Level pero en realidad está encendido y conectado, la causa casi siempre es una interferencia de AV/EDR o un firewall que bloquea las conexiones salientes del agente. Comience con el comando --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 está en una red restrictiva y experimenta activamente problemas de conectividad.
Solución de problemas sin conexión
Paso 1: Ejecutar la comprobación de diagnóstico
Ejecute --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 concentrarse:
Comprobaciones de Level — muestra si el servicio del agente y la tarea watchdog están en el estado esperado (Running / Ready). Si alguna muestra un problema, el AV/EDR probablemente ha puesto en cuarentena el binario del agente. El watchdog mantiene el servicio en ejecución en condiciones normales; si no lo hace, algo externo lo detuvo.
Comprobaciones de conexión — muestra el estado de online.level.io, agents.level.io, uptime monitor, y realtime client. Las tres primeras son comprobaciones de ping (ICMP), mientras que realtime client informa la conexión en tiempo real separada del agente. Error: no ping stats significa que la comprobació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 comprobaciones de ping fallan.
Paso 2: Interferencia de AV/EDR
Si --check muestra el servicio o el watchdog no en el estado esperado, o si --check no se ejecuta en absoluto, compruebe si el binario de Level sigue 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 falta el binario, el AV/EDR lo eliminó. Level no tiene ningún mecanismo para eliminar su propio binario; un ejecutable que falta 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 alrededor del 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— hacen esto de forma silenciosa sin ninguna alerta visible.
Para solucionar: Restaure el binario desde la cuarentena si es posible y, a continuación, añada las exclusiones adecuadas antes de reinstalar. Consulte Detecciones falsas de AV/EDR para conocer 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 sigue 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 añadir exclusiones primero, el AV/EDR eliminará el binario de nuevo. Añada exclusiones antes de reinstalar. También tenga en cuenta: Las detecciones de AV/EDR contra Level están basadas 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 estaba haciendo el agente en el momento en que se activó la detección, no de una actualización de definiciones. No asuma que un dispositivo sin alertas significa que sus exclusiones funcionan correctamente.
Paso 3: Comprobar el acceso a la red
Si la sección Comprobaciones de Level parece correcto pero Comprobaciones de conexión muestran fallos, compare las tres comprobaciones 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 un firewall o proxy está bloqueando las conexiones salientes indicadas a continuación.Si las comprobaciones de ping muestran
Error: no ping statsmientras querealtime clientesConnected, compruebe si el firewall del dispositivo o de la 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 URLs:
URL | Propósito |
| Comunicación del agente con Level |
| Comprobaciones de estado de conectividad |
| Actualizaciones del agente |
| Instalación inicial del agente |
| WebSocket en tiempo real para la API de Level |
| Almacenamiento de archivos para automatizaciones |
| Relé TURN (utilizado cuando P2P falla) |
| STUN (utilizado cuando P2P falla) |
| Recopilación de registros para solución de problemas |
💡 CONSEJO: Para firewalls que admiten reglas con comodines, *.level.io y *.twilio.com cubren las entradas de Level y Twilio mencionadas anteriormente.
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.
Si realtime client reporta un error en una red filtrada, pida al administrador de red o al proveedor de filtrado que:
Permita conexiones WebSocket TCP 443 salientes a
*.ably.ioy*.ably-realtime.com.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 para esos hosts.
Asegúrese de que las políticas de tiempo de espera de proxy y sesión no terminen 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 de nuevo 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 P2P falla |
5349 | TCP | TURN TLS | Solo como último recurso de respaldo |
10.000–60.000 | UDP | Puertos de relé 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 relé/P2P si las conexiones remotas son específicamente las que están fallando.
Paso 4: Contactar con el soporte técnico
Si --check no señala una causa clara, contacte 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» cuando 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 de la Monitor de ping de red y está codificado de forma fija en la actualidad; no hay ningún ajuste para cambiar el destino ni para deshabilitar solo esa sonda. ICMP no es necesario para la conexión central de API ni de 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 quedar sin conexión. ¿Por dónde empiezo? Ejecute
--checkprimero. Si no se ejecuta en absoluto, compruebe silevel.exe(Windows) o ellevelbinario (macOS/Linux) sigue presente en el disco; si no está, el AV/EDR lo eliminó. Si el binario está presente pero--checkmuestra el servicio detenido o fallos en las comprobaciones 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 las salidas 80 y 443. 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 relé/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 restaure la conectividad. Si no se actualiza, el problema puede ser intermitente; intente ejecutar
--checkde nuevo cuando vuelva a producirse el estado sin conexión para detectar el fallo en el momento.

