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 del servicio.

Ejecutar el comando de diagnóstico

Si un dispositivo aparece 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 de Level, las comprobaciones 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`

Interpretar la salida

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

Agent — 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.
System — Nombre de host, sistema operativo, arquitectura y hora del último arranque. Contexto útil al compartir la salida con soporte.
Level checks — Muestra si el servicio del agente y la tarea del watchdog están en el estado esperado (Running / Ready).
Connection checks — La sección más importante para los problemas de conexión. Muestra el estado de cada endpoint requerido:

Comprobación	Qué evalúa
`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 disponibilidad
`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.

Sleep settings — 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 sin conexión.
Activity status — Muestra las operaciones activas que se están ejecutando actualmente en el agente, como Remote Management.

Diagnóstico según lo que se observa

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 casi siempre es un AV/EDR que bloquea el agente o un firewall que bloquea el tráfico saliente. Consulte Detecciones falsas de AV/EDR y Solución de problemas de conexión.

Las comprobaciones de conexión están bien, 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 comprobaciones 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, probablemente cuarentena de AV/EDR. Consulte Detecciones falsas de AV/EDR.

Errores de automatización o scripts

Para problemas de automatización, --check no ayudará directamente. En su lugar, 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 soporte

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

La salida completa de --check (para problemas de conexión/sin conexión)
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 observe la sección de comprobaciones 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 comprobaciones 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í. Generalmente eso es suficiente para identificar el problema sin necesidad de contactar a soporte.
El dispositivo se desconecta periódicamente y luego vuelve por sí solo. ¿Qué lo causa? Generalmente es interferencia de AV/EDR: algunos productos bloquean Level intermitentemente tras actualizaciones de firmas sin generar una alerta visible. Al ejecutar --check mientras el dispositivo está en estado sin conexión ofrece la imagen más clara. Consulte Detecciones falsas de AV/EDR si las comprobaciones de conexión muestran errores.

Solución de problemas del agente