Cuando un dispositivo está offline, usa el comando --check para ejecutar un diagnóstico de conectividad rápido. Si eso falla, sigue los pasos a continuación para identificar dónde se rompe la conexión.
Paso 1: Ejecutar diagnóstico
En el dispositivo, abre una terminal y ejecuta:
level --check
Esto ejecuta un diagnóstico de conectividad y genera un reporte. Si todo está bien, verás un mensaje de confirmación. Si algo falla, el reporte te dirá exactamente dónde.
ℹ️ NOTA: Si el comando level no se encuentra, es posible que el agente no esté instalado o no esté en la ruta del sistema. Intenta con la ruta completa: C:\Program Files\Level\level.exe --check (Windows), /Applications/Level.app/Contents/MacOS/level --check (macOS), o /usr/local/bin/level --check (Linux).
Paso 2: Investigar interferencia de AV/EDR
Si --check informa de problemas de red pero la máquina tiene conexión a internet, es probable que antivirus o software EDR esté bloqueando la comunicación del agente. Verifica:
Si el proceso
level.exeo el binario del agente aparecen en cuarentena o alertas de seguridadSi has visto recientemente alertas de AV/EDR en la consola de administración
Si el agente está presente en su ubicación esperada:
C:\Program Files\Level(Windows),/Applications/Level.app(macOS), o/usr/local/bin/level(Linux)
Si sospechas interferencia de AV/EDR, ve a Detecciones falsas de AV/EDR para agregar exclusiones.
⚠️ ADVERTENCIA: Si el binario del agente fue removido, AV/EDR lo eliminó. No lo reinstales hasta que hayas agregado exclusiones — se eliminará nuevamente de inmediato.
Paso 3: Verificar acceso de red
El agente necesita acceso de salida a estos puertos y dominios:
Puertos requeridos:
Puerto | Protocolo | Propósito |
80 | TCP | HTTP (alternativa de confianza baja, generalmente usado solo si HTTPS falla) |
443 | TCP | HTTPS (conexión principal del agente) |
3478 | UDP | STUN para negociación P2P |
5349 | UDP | STUN/TURN seguro para negociación P2P |
10000-60000 | UDP | Tráfico P2P (sesiones de control remoto y transferencias de datos) |
Dominios requeridos:
Dominio | Propósito |
| API del servidor Level (conexión principal) |
| Servidores relay para P2P fallido o conectividad bloqueada por firewall |
| Servidor STUN para negociación de conexión P2P |
Desde el dispositivo offline, intenta conectar a estos puertos con una herramienta como telnet o curl. Por ejemplo:
curl -v https://api.level.io
telnet stun.level.io 3478
Si alguno de estos falla, tu cortafuegos está bloqueando el tráfico saliente requerido. Habla con tu equipo de red para permitir estos puertos y dominios.
Paso 4: Contactar a soporte
Si --check pasa pero el dispositivo sigue offline, o si ninguno de los pasos anteriores resuelve el problema, ejecuta --check nuevamente y copia el reporte completo. Contacta al Soporte de Level con el reporte — esto nos ayuda a diagnosticar problemas de conectividad más específicos.
FAQ
¿Cuánto tiempo tarda un dispositivo en reconectarse después de estar offline? Típicamente 1-2 minutos una vez que el problema subyacente se resuelve. El agente intenta conectarse continuamente, así que en cuanto el problema se repara, debería reaparecer online.
¿Qué significa "conexión fallida" versus "nunca conectado"? "Conexión fallida" significa que el dispositivo se conectó una vez, pero luego perdió conectividad — algo se rompió después del hecho. "Nunca conectado" significa que el agente nunca se conectó en primer lugar, generalmente porque nunca se instaló o fue removido antes de su primer contacto de verificación.
¿El agente sigue intentando conectarse mientras está offline? Sí. Intenta continuamente, con backoff exponencial para evitar bombardear los servidores. Si todo se repara, se reconectará automáticamente dentro de 1-2 minutos.
¿Puedo usar herramientas de diagnóstico remoto diferentes (RDP, SSH, etc.) si Level está offline? Sí — si tienes otro acceso al dispositivo, úsalo.
--checkpuede ayudarte a diagnosticar incluso si no tienes acceso remoto a través de Level, solo necesitas acceso terminal o consola local.