Solucionar problemas de los agentes

Diagnostique agentes en Offline, Overdue o Remote Offline, acciones pendientes atascadas y errores del instalador, con la ubicación de los registros y los comandos por sistema.

Qué es y cuándo usarlo

Use esta página cuando un dispositivo no informa, informa con retraso, no se puede alcanzar para el control remoto, o cuando una instalación falla. Parte de lo que muestra la consola y luego pasa al dispositivo: sus servicios, su registro y su camino de red hasta SONAR.

Antes de empezar

• Su rol le permite ver el dispositivo en Dashboard › Sysadmin. La pestaña Debug requiere View Debug Logs; Agents › Pending Actions requiere List Pending Actions, y cancelar una acción requiere Manage Pending Actions; Restart Remote Service requiere Use Mesh.

• Para las comprobaciones en el propio dispositivo, necesita derechos de administrador en Windows o root en Linux y macOS.

Cómo decide la consola el estado de un dispositivo

El agente envía una señal de vida (heartbeat) a SONAR cada 30 a 60 segundos por su conexión con la dirección de la API. Last Response, en la lista de dispositivos, es la hora a la que SONAR recibió la última. SONAR toma la hora a la llegada, así que el reloj del propio dispositivo no influye en el estado.

Agent Status compara Last Response con dos umbrales definidos por dispositivo en Edit (menú de acciones del dispositivo):

Estado	Significado
Online	Último contacto más reciente que Offline after (minutes)
Offline	Sin contacto durante más tiempo que Offline after (minutes)
Overdue	Sin contacto durante más tiempo que Overdue after (minutes). Las alertas de retraso se generan a partir de este estado

Los umbrales pueden ser largos, así que Last Response es la señal más rápida: un Last Response de hace más de unos minutos significa que el agente no está conectado en este momento, diga lo que diga el estado.

El panel Filters de la lista de dispositivos agrupa los dispositivos por ventanas fijas en Availability: Online, Offline 12+ hours, Offline 24+ hours, Offline 7+ days, Overdue y Maintenance Mode.

El panel de detalles añade el estado del agente de acceso remoto: Remote Online, Remote Offline o Remote Unknown.

Pasos

Un dispositivo aparece como Offline u Overdue

1. ¿Está el dispositivo encendido y conectado? Compruebe que está encendido y en una red. Un dispositivo apagado o suspendido aparece como Offline y después como Overdue, y ese es el comportamiento previsto.

2. ¿Se está ejecutando el servicio del agente? En el dispositivo:

   Plataforma	Comprobar	Iniciar o reiniciar
   Windows	sc query sonarrmm, o Sonar Agent Service en la consola de Servicios	net start sonarrmm, o net stop sonarrmm y luego net start sonarrmm
   Linux	systemctl status sonaragent	sudo systemctl restart sonaragent
   macOS	sudo launchctl print system/sonaragent	sudo launchctl kickstart -k system/sonaragent

   Si el servicio no existe, el agente se desinstaló: vuelva a instalarlo.

3. ¿Llega el dispositivo a SONAR? Desde el dispositivo, pruebe el puerto 443/tcp hacia la dirección de la API: Test-NetConnection api.example.com -Port 443 en Windows, curl en Linux y macOS. Un proxy o una inspección TLS en el camino puede dejar pasar el HTTPS y, aun así, romper la conexión WebSocket de larga duración. Consulte Requisitos de red.

4. ¿Qué dice el registro del agente? Lea las últimas líneas del registro (consulte Registros del agente). Los errores de conexión con la dirección de la API apuntan a la red; los errores justo después del arranque apuntan a la configuración local.

5. Tras la corrección, reinicie el servicio del agente. Last Response se actualiza en menos de un minuto y Agent Status vuelve a Online.

Un dispositivo aparece como Remote Offline

Remote Offline significa que el agente SONAR está conectado pero el agente de acceso remoto no. Take Control queda deshabilitado hasta que el agente de acceso remoto se vuelve a conectar.

1. Seleccione el dispositivo. Mientras el agente está Online y el agente de acceso remoto está fuera de línea, la cabecera del panel de detalles ofrece Restart Remote Service.

2. Haga clic en él. SONAR pide al agente que reinicie el agente de acceso remoto en el dispositivo (Attempting to repair Mesh Agent) e informa Repaired mesh agent on <hostname> al terminar.

3. Si el indicador no pasa a Remote Online en unos minutos, reinicie el agente de acceso remoto en el dispositivo:

   Plataforma	Comando
   Windows	net stop "Mesh Agent" y luego net start "Mesh Agent"
   Linux	sudo systemctl restart meshagent
   macOS	sudo launchctl kickstart -k system/meshagent

4. Si sigue fuera de línea, compruebe que el dispositivo alcanza la dirección de acceso remoto por 443/tcp, con los upgrades de WebSocket permitidos.

5. Si falta el agente de acceso remoto en el dispositivo, reinstale el agente SONAR (consulte Reinstalar sobre un agente existente).

En macOS, Operation not permitted en Terminal o File Browser dentro de las carpetas Desktop, Documents o Downloads de un usuario es una cuestión de permisos, no de conexión. Consulte Instalar el agente en macOS.

Las acciones pendientes no se completan

Agents › Pending Actions (All Pending Actions) lista el trabajo que SONAR tiene en espera para los dispositivos: actualizaciones del agente (Agent update to <version>), reinicios programados (Device pending reboot), instalaciones de software (<name> software install) y otros trabajos en cola. Para un solo dispositivo, use Pending Agent Actions en su menú de acciones, o mire la columna Pending Actions de la lista de dispositivos.

1. Abra la lista y localice el dispositivo.

2. Revise la columna Due. Una actualización del agente está prevista para el próximo ciclo de actualización, a los 35 minutos de la hora; un reinicio programado, para la hora a la que se fijó.

3. Una acción pendiente sigue pendiente mientras el dispositivo está fuera de línea. Primero, vuelva a poner el dispositivo en línea (vea más arriba).

4. Para una instalación de software completada, View output muestra lo que imprimió el instalador (Pending Action Output Details).

5. Para descartar una acción, haga clic con el botón derecho en su fila, elija Cancel Action y confirme Delete this pending action?. Cancelar un reinicio programado también lo quita del dispositivo.

6. Show N Completed y Hide N Completed muestran y ocultan las acciones completadas en la lista.

Consulte Actualizar agentes para saber cómo se cierran las actualizaciones del agente.

Leer la pestaña Debug

La pestaña Debug del panel de detalles muestra lo que SONAR registró sobre el dispositivo, de lo más reciente a lo más antiguo, hasta las últimas 1000 entradas.

1. Seleccione el dispositivo y abra Debug.

2. Elija un Log Level: Info (el valor por defecto), Warning, Error o Critical.

3. Si lo desea, elija un Log Type: Agent Update, Agent Issues, Windows Updates, System Issues o Scripting.

4. Use Search para filtrar las filas, o CSV para exportarlas.

Las entradas de tipo Agent Update y Agent Issues son donde se registran, del lado de SONAR, los problemas de actualización y de conexión del dispositivo.

Registros del agente

Plataforma	Archivo de registro
Windows	C:\Program Files\Sonar\agent.log (C:\Program Files (x86)\Sonar\agent.log para un agente de 32 bits en un Windows de 64 bits)
Linux	/var/log/sonaragent.log
macOS	/var/log/sonaragent.log

Para obtener una salida detallada, detenga el servicio y ejecute el agente en primer plano con registro de depuración; después, deténgalo con Ctrl+C y vuelva a iniciar el servicio:

Plataforma	Comandos
Windows (símbolo del sistema elevado)	net stop sonarrmm, luego "C:\Program Files\Sonar\sonarrmm.exe" -m rpc -log debug -logto stdout, luego net start sonarrmm
Linux	sudo systemctl stop sonaragent, luego sudo /usr/local/bin/sonaragent -m svc -log debug -logto stdout, luego sudo systemctl start sonaragent
macOS	sudo launchctl bootout system /Library/LaunchDaemons/sonaragent.plist, luego sudo /opt/sonaragent/sonaragent -m svc -log debug -logto stdout, luego sudo launchctl bootstrap system /Library/LaunchDaemons/sonaragent.plist

En Windows, ejecutar "C:\Program Files\Sonar\sonarrmm.exe" sin argumentos muestra un cuadro Sonar RMM con la versión del agente y el estado de los servicios del agente y del agente de acceso remoto.

Reinstalar sobre un agente existente

Plataforma	Qué hacer
Windows	Desinstale primero con "C:\Program Files\Sonar\uninstall.exe" /S y luego ejecute un nuevo instalador. Un instalador ejecutado sobre un agente existente ofrece quitarlo (modo interactivo) o termina sin instalar (modo silencioso)
Linux	Vuelva a ejecutar el script de instalación. Quita el agente anterior y el agente de acceso remoto antes de instalar
macOS	Vuelva a ejecutar el comando de instalación. Quita el agente anterior y el agente de acceso remoto antes de instalar

Un dispositivo reinstalado entra como un nuevo registro de dispositivo. Quite el registro antiguo, ahora fuera de línea, con Remove Agent. Consulte Retirar agentes.

Reinstalar es también la manera de cambiar las funciones opcionales en un dispositivo Windows: genere un instalador con la nueva selección.

Cómo verificar que funcionó

• En Dashboard › Sysadmin, compruebe que el dispositivo muestra Agent Status Online y un Last Response de hace un momento.

• En el panel de detalles, compruebe que el indicador muestra Remote Online y que Take Control está habilitado.

• En Agents › Pending Actions, compruebe que las acciones del dispositivo pasan a completadas.

• En el dispositivo, compruebe que el registro del agente no muestra nuevos errores de conexión después del reinicio.

Errores comunes

Síntoma o mensaje	Causa	Solución
Installer token has expired. Please generate a new one.	El instalador o el enlace de despliegue superó su expiración, o su despliegue se eliminó	Genere un nuevo instalador o un nuevo despliegue
Old installer detected (version …). Latest version is … Please generate a new installer from the RMM	El instalador se generó antes de la versión actual del agente	Genere un nuevo instalador
This application requires a 64-bit Windows operating system.	Instalador de 64 bits en un Windows de 32 bits	Use un instalador 32-bit
Existing installation found (cuadro de mensaje), o Existing installation found and must be removed before attempting to reinstall. (modo silencioso)	Ya hay un agente, o lo que queda de uno, en el dispositivo Windows	Desinstale con uninstall.exe /S y vuelva a instalar
Sonar RMM Is Already Installed	El instalador de PowerShell encontró el servicio sonarrmm	Desinstale primero, o deje el dispositivo como está
Waiting for network repetido, luego Unable to connect to server	El instalador de PowerShell no alcanza la dirección de la API por 443/tcp	Corrija el camino de red; consulte Requisitos de red
Unable to download the mesh agent from the RMM. / Failed to download mesh agent	El instalador no pudo obtener el agente de acceso remoto a través de la dirección de la API	Compruebe la conectividad con la dirección de la API y vuelva a ejecutar el instalador
Invalid URL (must contain https or http)	El valor de -api de un comando manual se editó o se truncó	Vuelva a copiar el comando desde la consola
ERROR: Must be run as root / must run as root	Script de Linux o agente de macOS ejecutado sin root	Ejecútelo con sudo
This install script only supports systemd	Distribución de Linux sin systemd	No compatible; consulte Requisitos de los dispositivos
ERROR: Display detected. Installer only supports running headless, i.e from ssh.	Script de Linux iniciado desde una sesión gráfica	Ejecútelo por SSH, desde una consola de texto, o después de unset DISPLAY
ERROR: Unable to download sonar agent	El dispositivo Linux no puede descargar desde la dirección de la API	Compruebe el puerto 443/tcp y la resolución de nombres
Cuadro de diálogo Agent offline, … cannot be contacted	El dispositivo no respondió cuando eligió Remove Agent	Consulte Retirar agentes
Unable to contact the agent	Una acción necesitaba una respuesta del dispositivo y no llegó ninguna	Revise Agent Status y Last Response; vuelva a poner el dispositivo en línea
Dispositivo Online pero Remote Offline	El agente de acceso remoto está detenido o no alcanza la dirección de acceso remoto	Use Restart Remote Service y luego revise el camino de red
El dispositivo aparece dos veces en la lista	Se reinstaló y se conservó el registro antiguo	Quite el registro fuera de línea con Remove Agent

Páginas relacionadas

• Requisitos de red

• Actualizar agentes

• Retirar agentes

• Detalles del dispositivo

• La lista de dispositivos