Introducción

Cuando algo está mal con un agente de Level — un dispositivo que se muestra 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 perro guardián de Level se encarga de mantener el servicio en funcionamiento 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.

Ejecutar el comando de diagnóstico

Si un dispositivo se muestra sin conexión en Level pero en realidad 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 Level, comprobaciones de conexión, configuraciones 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 ejecuta.
Sistema — Nombre de host, SO, arquitectura y hora del último reinicio. Contexto útil al compartir la salida con el soporte.
Comprobaciones de Level — Muestra si el servicio del agente y la tarea del perro guardián están en el estado esperado (Running / Ready ).
Comprobaciones de conexión — La sección más importante para problemas sin conexión. Muestra el estado de cada punto de conexión requerido:

Comprobación	Lo que prueba
`online.level.io`	Comprobación básica de conectividad accesible por Internet
`agents.level.io`	Canal de comunicación principal del agente a Level
`uptime monitor`	Punto de conexión de informe de disponibilidad
`realtime client`	Estado de conexión WebSocket ( `Connected` o fallida)

Si alguno de ellos muestra un error en lugar de OK / Connected, esa es su causa raíz.

Configuraciones de suspensión — Muestra la configuración actual de suspensión/tiempo de espera del dispositivo. Los ajustes de suspensión agresivos (especialmente tiempos de espera de CC cortos) pueden hacer que los dispositivos aparezcan intermitentemente sin conexión.
Estado de actividad — Muestra operaciones activas que se ejecutan actualmente en el agente, como Remote Management.

Clasificar por lo que ve

Las comprobaciones de conexión muestran errores (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 cortafuegos bloqueando el tráfico saliente. Ver Detecciones falsas de AV/EDR y Solución de problemas sin conexión .

Las comprobaciones de conexión están bien pero las sesiones remotas están en relé en lugar de P2P:
El agente puede comunicarse con Level, pero las conexiones directas punto a punto no funcionan. Ver Solución de problemas de relé/P2P .

Las comprobaciones de Level muestran el servicio o el perro guardián no en el estado esperado:
Algo está evitando activamente que el agente se ejecute: probablemente cuarentena de AV/EDR. Ver Detecciones falsas de 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 que falló. 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 de --check o la salida del paso, Level Support puede profundizar con usted. Cuando se comunique con nosotros, incluya:

La salida completa de --check (para problemas sin conexió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

FAQ

Level muestra un dispositivo sin conexión pero puedo pinguearlo y alcanzarlo a través de otras herramientas. ¿Por dónde empiezo? Ejecute --check en el dispositivo y mire la sección Comprobaciones de conexión. Si online.level.io o agents.level.io muestran errores, el agente no puede alcanzar los servidores de Level: probablemente AV/EDR o un cortafuegos. Si todas las comprobaciones de conexión pasan, envíe la salida completa a Level Support.
Un paso de automatización falló. ¿Cómo veo qué salió mal? Abra la ejecución de automatización y expanda el paso que falló. La salida completa, incluido cualquier mensaje de error o código de salida, se muestra allí. Esto suele ser suficiente para identificar el problema sin necesidad de soporte.
El dispositivo se desconecta periódicamente y luego vuelve por sí solo. ¿Qué causa eso? Generalmente interferencia de AV/EDR: algunos productos bloquean Level de manera intermitente después de actualizaciones de firma sin generar una alerta visible. Ejecutar --check mientras el dispositivo está en estado sin conexión le da la imagen más clara. Ver Detecciones falsas de AV/EDR si las comprobaciones de conexión muestran errores.

Solución de problemas del agente