Ir al contenido principal

Solución de problemas sin conexión

Diagnose why a Level device shows offline — AV/EDR interference, network requirements, and the --check diagnostic command.

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

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

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

Windows --check Example

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.exe en C:\Program Files\Level\

  • macOS: busque level en /Applications/Level.app/Contents/MacOS/level

  • Linux: busque level en /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 client tambié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 stats mientras que realtime client es Connected, 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

agents.level.io

Comunicación del agente con Level

online.level.io

Comprobaciones de estado de conectividad

builds.level.io

Actualizaciones del agente

downloads.level.io

Instalación inicial del agente

realtime.ably.io

WebSocket en tiempo real para la API de Level

prd-level-storage.s3.wasabisys.com

Almacenamiento de archivos para automatizaciones

global.turn.twilio.com

Relé TURN (utilizado cuando P2P falla)

global.stun.twilio.com

STUN (utilizado cuando P2P falla)

logs.logdna.com

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.io y *.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 --check

  • Software 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, --check puede reportar Error: no ping stats para online.level.io, agents.level.io, y el monitor de tiempo de actividad, y el valor de ping promedio puede permanecer en blanco, incluso cuando realtime client muestra Connected. 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 --check primero. Si no se ejecuta en absoluto, compruebe si level.exe (Windows) o el level binario (macOS/Linux) sigue presente en el disco; si no está, el AV/EDR lo eliminó. Si el binario está presente pero --check muestra 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 --check para 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 --check de nuevo cuando vuelva a producirse el estado sin conexión para detectar el fallo en el momento.

¿Ha quedado contestada tu pregunta?