Introducción

Cuando algo falla con un agente de Level — un dispositivo que aparece desconectado, 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 del servicio.

Ejecución del comando de diagnóstico

Si un dispositivo aparece como desconectado 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 del 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`	Comprobació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 hacer que los dispositivos aparezcan intermitentemente desconectados.
Estado de actividad — Muestra las operaciones activas que se están ejecutando actualmente en el agente, como Remote Management.

Clasificación según lo que se observe

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 que un AV/EDR está bloqueando el agente o un firewall está bloqueando el tráfico saliente. Consulte Detecciones falsas de AV/EDR y Solución de problemas de desconexión.

Las verificaciones de conexión son correctas pero las sesiones remotas usan relay en lugar de P2P:
El agente puede comunicarse con Level, pero las conexiones directas de igual a igual no funcionan. Consulte Solución de problemas de Relay/P2P.

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

Errores de automatización o de scripts

Para los 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 profundizar más.

Contactar con soporte

Si no puede identificar la causa a partir de --check o la salida del paso, el soporte de Level puede ayudarle a investigarlo. Al contactar, 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 desconectado pero puedo hacerle ping y acceder a él con otras herramientas. ¿Por dónde empiezo? Ejecute --check en el dispositivo y observe 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 — probablemente por AV/EDR o un firewall. Si todas las verificaciones de conexión pasan, envíe la salida completa al soporte de Level.
Un paso de automatización falló. ¿Cómo veo 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 necesidad de contactar con soporte.
El dispositivo se desconecta periódicamente y luego vuelve a conectarse solo. ¿Cuál es la causa? Por lo general, interferencia de AV/EDR — algunos productos bloquean Level de forma intermitente tras actualizaciones de firmas sin generar una alerta visible. Ejecutar --check mientras el dispositivo está en estado desconectado le da la imagen más clara. Consulte Detecciones falsas de AV/EDR si las verificaciones de conexión muestran errores.

Solución de problemas del agente