Introducción

Cuando algo falla con un agente de Level — un dispositivo que aparece sin conexión, conexiones remotas que no funcionan o una automatización que falla — el comando de diagnóstico y la salida del paso de automatización son los dos puntos de partida. El watchdog de Level se encarga de mantener el servicio en ejecución automáticamente, por lo que en la mayoría de los casos se trata de un problema de conectividad o configuración, no de un problema de servicio.

Ejecución del comando de diagnóstico

Si un dispositivo aparece sin conexión en Level pero está encendido y conectado, ejecute --check en el dispositivo afectado. Genera un informe estructurado que cubre el agente, la información del sistema, el estado del servicio de Level, las verificaciones de conexión, la configuración de suspensión y las operaciones activas.

Windows	`& 'C:\Program Files\Level\level.exe' --check`
macOS	`sudo /usr/local/bin/level --check`
Linux	`sudo /usr/local/bin/level --check`

Interpretación de la salida

La salida está dividida en secciones. Esto es lo que indica cada una:

Agente — ID, versión, fecha de compilación, plataforma y estado interno. Confirma que el agente está instalado y qué versión está en ejecución.
Sistema — Nombre de host, sistema operativo, arquitectura y hora del último arranque. Contexto útil al compartir la salida con el soporte.
Verificaciones de Level — Muestra si el servicio del agente y la tarea watchdog están en el estado esperado (Running / Ready).
Verificaciones de conexión — La sección más importante para los problemas de desconexión. Muestra el estado de cada endpoint requerido:

Verificación	Qué comprueba
`online.level.io`	Verificación básica de conectividad accesible desde Internet
`agents.level.io`	Canal de comunicación principal del agente con Level
`uptime monitor`	Endpoint de reporte de tiempo de actividad
`realtime client`	Estado de la conexión WebSocket (`Connected` o con error)

Si alguna de estas muestra un error en lugar de OK / Connected, esa es la causa raíz.

Configuración de suspensión — Muestra la configuración actual de suspensión/tiempo de espera del dispositivo. Una configuración de suspensión agresiva (especialmente tiempos de espera cortos con corriente continua) puede provocar que los dispositivos aparezcan intermitentemente sin conexión.
Estado de actividad — Muestra las operaciones activas que se ejecutan actualmente en el agente, como Remote Management.

Clasificación según lo que se observa

Las verificaciones de conexión muestran errores (online.level.io, agents.level.io, etc.):
El agente no puede alcanzar los servidores de Level. La causa casi siempre es un antivirus/EDR que bloquea el agente o un firewall que bloquea el tráfico saliente. Consulte Detecciones falsas de antivirus/EDR y Solución de problemas sin conexión.

Las verificaciones de conexión están bien, pero las sesiones remotas usan retransmisión en lugar de P2P:
El agente puede comunicarse con Level, pero las conexiones directas entre pares no funcionan. Consulte Solución de problemas de retransmisión/P2P.

Las verificaciones de conexión están bien, Terminal y Explorador de archivos funcionan en el mismo dispositivo Windows, pero el Control remoto permanece en «Conectando»:
Las verificaciones superadas de --check muestra que el agente puede alcanzar los endpoints de Level verificados. El funcionamiento de Terminal y Explorador de archivos Las sesiones muestran que la Gestión en segundo plano puede comunicarse. El Control remoto también necesita que Windows devuelva información de la sesión de escritorio. La verificación de conexión --check las verificaciones de conexión no comprueban esa ruta de enumeración de sesiones de Windows.

En el Terminal, ejecute el comando integrado de Windows query session.
Si devuelve una lista de sesiones o un error, envíe la salida y su informe completo de --check en funcionamiento, informe al soporte de Level. Una lista de sesiones devuelta no descarta otros fallos del Control remoto.
Si no ha respondido después de 30 segundos, presione Ctrl+C e informe al soporte de Level que permaneció bloqueado. Esto puede indicar un problema de gestión de sesiones de Windows. Use la consola web de su proveedor de alojamiento, la consola del hipervisor o la consola local para comprobar si Windows responde. Si la enumeración de sesiones permanece sin respuesta, involucre a su administrador de Windows o de alojamiento para inspeccionar el dispositivo y organizar una recuperación controlada.

Si Terminal, Explorador de archivos, y Control remoto no logran conectarse, siga también Solución de problemas de retransmisión/P2P.

Las verificaciones de Level muestran que el servicio o el watchdog no están en el estado esperado:
Algo está impidiendo activamente que el agente se ejecute — muy probablemente una cuarentena de antivirus/EDR. Consulte Detecciones falsas de antivirus/EDR.

Errores de automatización o de script

Para problemas de automatización, --check no ayudará directamente. En cambio, abra la ejecución de la automatización y expanda el paso fallido. Cada paso muestra su salida completa — códigos de salida, mensajes de error y cualquier salida del script escrita en stdout o stderr.

En la mayoría de los casos, el error en la salida del paso identifica la causa sin necesidad de ir más lejos.

Contactar con el soporte

Si no puede identificar la causa a partir de --check o la salida del paso, el soporte de Level puede investigar con usted. Al comunicarse, incluya:

La salida completa de --check (para problemas de desconexión/conectividad)
El nombre de la automatización y el paso específico que falló (para problemas de automatización)
El mensaje de error completo de la salida del paso

Preguntas frecuentes

Level muestra un dispositivo como sin conexión, pero puedo hacerle ping y acceder a él con otras herramientas. ¿Por dónde empiezo? Ejecute --check en el dispositivo y consulte la sección de verificaciones de conexión. Si online.level.io o agents.level.io muestran errores, el agente no puede alcanzar los servidores de Level — muy probablemente antivirus/EDR o un firewall. Si todas las verificaciones de conexión son correctas, envíe la salida completa al soporte de Level.
Un paso de automatización falló. ¿Cómo puedo ver qué salió mal? Abra la ejecución de la automatización y expanda el paso fallido. La salida completa, incluido cualquier mensaje de error o código de salida, se muestra allí. Eso suele ser suficiente para identificar el problema sin necesitar soporte.
El dispositivo se desconecta periódicamente y luego vuelve a conectarse solo. ¿Cuál es la causa? Normalmente es una interferencia de antivirus/EDR — algunos productos bloquean Level de forma intermitente después de actualizaciones de firmas sin generar una alerta visible. Ejecutar --check mientras el dispositivo está sin conexión le dará la imagen más clara. Consulte Detecciones falsas de antivirus/EDR si las verificaciones de conexión muestran errores.

Solución de problemas del agente