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 la interferencia de AV/EDR o un firewall que bloquea las conexiones salientes del agente. Comience con el comando --check — identifica el punto exacto de fallo sin 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 verificació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 SOBRE LA 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 centrarse:

Verificaciones 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, es muy probable que AV/EDR haya puesto en cuarentena el binario del agente. El watchdog mantiene el servicio en ejecución en condiciones normales; si no es así, algo externo lo detuvo.

Verificaciones de conexión — muestra el estado de online.level.io, agents.level.io, uptime monitor, y realtime client. Las tres primeras son verificaciones de ping (ICMP), mientras que realtime client informa la conexión en tiempo real independiente 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 el watchdog que no está en el estado esperado, o si --check no se ejecuta en absoluto, verifique si el binario de Level sigue presente en el disco:

🖥️ NOTA SOBRE LA 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, AV/EDR lo eliminó. Level no tiene ningún mecanismo para eliminar su propio binario; un ejecutable faltante significa que su software de seguridad lo puso en cuarentena o lo eliminó.

Para investigar: Revise el registro de cuarentena de su software de seguridad y el historial de actividad en torno al momento en que el dispositivo se desconectó. Busque cualquier acción tomada contra level.exe o procesos relacionados. Algunos productos —SentinelOne, ESET y ciertas configuraciones de Defender— hacen esto en silencio sin ninguna alerta visible.

Para solucionar: 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 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 agregar exclusiones primero, AV/EDR eliminará el binario nuevamente. Agregue exclusiones antes de reinstalar. También tenga en cuenta: Las detecciones de AV/EDR contra Level están basadas en comportamiento, no en firmas. Esto significa que el mismo software de seguridad puede ejecutarse en 50 dispositivos y solo marcar Level en algunos pocos; depende de lo que el agente estaba haciendo en el momento en que se activó 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 sección Verificaciones de Level se ve correcta pero Verificaciones de conexión muestran fallos, compare las tres verificaciones 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. Verifique 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 stats mientras que realtime client es Connected, verifique si el dispositivo o el firewall 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 URL:

URL

Propósito

agents.level.io

Comunicación del agente con Level

online.level.io

Verificaciones 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

Retransmisión TURN (se usa cuando P2P falla)

global.stun.twilio.com

STUN (se usa 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.

Solucionar problemas de conexiones WebSocket filtradas

Permitir un nombre de host no siempre permite la conexión en tiempo real. Un filtro de contenido, un firewall o un proxy pueden seguir bloqueando, inspeccionando, reescribiendo o cerrando el tráfico WebSocket.

Si realtime client informa un error en una red filtrada, solicite al administrador de red o al proveedor de filtrado que:

  • Permita conexiones WebSocket TCP 443 salientes hacia *.ably.io y *.ably-realtime.com.

  • Permita 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.

Estas configuraciones 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 informa 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 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 soporte

Si --check no apunta a una causa clara, contacte al 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 mientras el tiempo real está Connected? El agente ejecuta una sonda de latencia integrada (ICMP hacia 8.8.8.8, aproximadamente cada 50 segundos). Esa sonda es independiente de Monitor de ping de red y está codificado de forma fija actualmente — no hay ninguna configuración para cambiar el destino ni deshabilitar solo esa sonda. ICMP no es necesario para la API principal del agente ni para la conexión en tiempo real. Si el dispositivo o la red bloquea ICMP, --check puede informar 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 desconectarse. ¿Por dónde empiezo? Ejecute --check primero. Si no se ejecuta en absoluto, verifique si level.exe (Windows) o el binario level (macOS/Linux) sigue presente en el disco; si no está, AV/EDR lo eliminó. Si el binario está allí pero --check muestra 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 --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 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 --check nuevamente cuando el estado sin conexión vuelva a aparecer, para detectar el fallo en el momento en que ocurre.

¿Ha quedado contestada tu pregunta?