Cuando algo no funciona con un agente de Level — un dispositivo que aparece desconectado, las conexiones remotas no funcionan o una automatización falla — el comando de diagnóstico y la salida del paso de automatización son los dos lugares por donde comenzar. El guardián de Level se encarga de mantener el servicio funcionando automáticamente, por lo que en la mayoría de los casos está buscando un problema de conectividad o configuración, no un problema de servicio.

Ejecución del Comando de Diagnóstico

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

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

Lectura de la Salida

La salida se divide en secciones. Esto es lo que cada una le dice:

Agente — ID, versión, fecha de compilación, plataforma y estado interno. Confirma que el agente está instalado y qué versión se está ejecutando.
Sistema — Nombre de host, sistema operativo, arquitectura y última hora de arranque. Contexto útil al compartir la salida con soporte.
Verificaciones de Level — Muestra si el servicio de agente y la tarea de guardián están en el estado esperado (En Ejecución / Listo).
Verificaciones de conexión — La sección más importante para problemas desconectados. Muestra el estado de cada punto final requerido:

Verificación	Lo que prueba
`online.level.io`	Verificación de conectividad alcanzable por Internet
`agents.level.io`	Canal de comunicación principal del agente a Level
`monitor de disponibilidad`	Punto final de informe de disponibilidad
`cliente en tiempo real`	Estado de conexión de WebSocket (`Conectado` o fallando)

Si alguno de estos muestra un fallo en lugar de OK / Conectado, esa es su causa raíz.

Configuración de suspensión — Muestra la configuración actual de suspensión/tiempo de espera del dispositivo. La configuración agresiva de suspensión (especialmente tiempos de espera cortos de CC) puede hacer que los dispositivos aparezcan intermitentemente desconectados.
Estado de actividad — Muestra las operaciones activas actualmente ejecutándose en el agente, como Gestión Remota.

Triage Según Lo que Vea

Las verificaciones de conexión muestran fallas (online.level.io, agents.level.io, etc.):
El agente no puede alcanzar los servidores de Level. La causa es casi siempre AV/EDR bloqueando el agente o un firewall bloqueando el tráfico saliente. Ver Falsas Detecciones AV/EDR y Solución de Problemas Desconectado.

Las verificaciones de conexión son OK pero las sesiones remotas están en relé en lugar de P2P:
El agente puede comunicarse con Level, pero las conexiones directas de igual a igual no funcionan. Ver Solución de Problemas de Relé/P2P.

Las verificaciones de Level muestran que el servicio o guardián no están en el estado esperado:
Algo está impidiendo activamente que el agente se ejecute — casi con seguridad cuarentena de AV/EDR. Ver Falsas Detecciones AV/EDR.

Errores de Automatización o Script

Para problemas de automatización, --check no ayudará directamente. En su lugar, abra la ejecución de automatización y expanda el paso fallido. Cada paso muestra su salida completa — códigos de salida, mensajes de error y cualquier salida de 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 Soporte

Si no puede identificar la causa a partir de --check o la salida del paso, el Soporte de Level puede ayudarlo. Cuando se comunique con nosotros, incluya:

La salida completa de --check (para problemas desconectados/de 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 desconectado pero puedo hacer ping y acceder a él a través de otras herramientas. ¿Por dónde empiezo? Ejecute --check en el dispositivo y mire la sección de Verificaciones de conexión. Si online.level.io o agents.level.io muestran fallas, el agente no puede alcanzar los servidores de Level — casi con seguridad AV/EDR o un firewall. Si todas las verificaciones de conexión se pasan, 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 automatización y expanda el paso fallido. La salida completa, incluido cualquier mensaje de error o código de salida, se muestra allí. Eso es generalmente suficiente para identificar el problema sin necesidad de soporte.
El dispositivo se desconecta periódicamente y luego se reconecta automáticamente. ¿Qué causa esto? Usualmente interferencia de AV/EDR — algunos productos bloquean Level intermitentemente después de actualizaciones de firmas sin generar una alerta visible. Ejecutar --check mientras el dispositivo está en estado desconectado le da la imagen más clara. Ver Falsas Detecciones AV/EDR si las verificaciones de conexión muestran fallas.