> For the complete documentation index, see [llms.txt](https://wiki.datadike.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.datadike.com/es/sonar/deploy-operate/troubleshooting.md). # 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](/es/sonar/deploy-operate/network-requirements.md). 4. **¿Qué dice el registro del agente?** Lea las últimas líneas del registro (consulte [Registros del agente](#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 \* 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](#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](/es/sonar/deploy-operate/install-agent-macos.md#carpetas-que-protege-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 \*), reinicios programados (*Device pending reboot*), instalaciones de software (*\ 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](/es/sonar/deploy-operate/agent-updates.md) 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](/es/sonar/deploy-operate/remove-agents.md). 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](/es/sonar/deploy-operate/network-requirements.md) | | *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](/es/sonar/deploy-operate/requirements.md) | | *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](/es/sonar/deploy-operate/remove-agents.md) | | *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](/es/sonar/deploy-operate/network-requirements.md) * [Actualizar agentes](/es/sonar/deploy-operate/agent-updates.md) * [Retirar agentes](/es/sonar/deploy-operate/remove-agents.md) * [Detalles del dispositivo](/es/sonar/administration/devices/device-details.md) * [La lista de dispositivos](/es/sonar/administration/devices/device-list.md)