Agente no reporta
Verificaciones documentadas para cuando un equipo deja de aparecer o de actualizarse en la consola. Ejecútelas en orden.
1. Revise el estado en la consola
- La vista ejecutiva muestra los dispositivos activos, inactivos y desconocidos (S11, S12).
- El agente reporta según el intervalo configurado al instalarlo (por defecto 15 minutos; valores posibles: 5, 15, 30 o 60). Espere al menos un intervalo antes de concluir que no reporta.
- Los datos de vulnerabilidades tardan en poblarse tras el primer reporte (S13).
2. Ejecute el diagnóstico del agente
En el equipo, con privilegios de administrador:
| Sistema | Comando |
|---|---|
| Windows (PowerShell) | ness-core-service --status y luego ness-core-service --doctor |
| macOS | sudo ness-core-service --doctor |
| Linux | sudo ness-core-service --doctor |
Todas las verificaciones deben indicar OK. El diagnóstico valida la conexión a internet, la resolución DNS y la configuración del token.
En Windows también dispone de:
| Comando | Para qué |
|---|---|
ness-core-service --status | Estado del agente: token, intervalo y última sincronización. |
ness-core-service --fix-all | Remedia de forma conservadora los servicios del agente que estén caídos. |
ness-core-service --ping | Mide la latencia hacia la nube de NESS. |
ness-core-service --logs | Analiza los registros: errores, alertas y resumen. |
Ver la referencia de ness-core-service.
3. Verifique el servicio y los registros
- Windows: en
services.msc, el servicio del agente (su nombre empieza por "NESS") debe estar En ejecución y con inicio Automático. Registros:C:\Program Files\NESS Core\logs\ness-core.log. - macOS: registros en
/Library/Logs/NessHQ/ness-core.log(o la app Consola, filtrando por "nesshq"). Revise también los permisos en Privacidad y Seguridad. - Linux:
sudo systemctl status ness-coreysudo journalctl -u ness-core -n 100 --no-pager.
4. Revise la conectividad de red
Confirme que el equipo puede salir por HTTPS (443) hacia los destinos de Red, puertos y dominios (S6, S7).
5. Revise antivirus / EDR de terceros
Otro antivirus puede bloquear los procesos del agente. Configure las exclusiones de antivirus (S4, S7).
6. Revise el token
- El token se consulta en la consola en Integraciones Tokens (S6, S9, S10).
- El token solo existe en el portal y se revoca manualmente desde allí.
7. Genere el informe de diagnóstico y envíelo a soporte
En Windows, ejecute en PowerShell como administrador:
ness-diag
Se crea el archivo ness-diag-<equipo>-<fecha>.txt. Envíelo a soporte@nesshq.com con el nombre del equipo. Ver ness-diag.
Estados del equipo en el portal
| Estado | Significado |
|---|---|
| Online (verde) | El agente reporta correctamente. |
| Delayed (amarillo) | Lleva un tiempo sin reportar; revise la red. |
| Offline (rojo) | Hace mucho que no se conecta: equipo apagado, sin red o servicio detenido. |
| Pending (gris) | El token aún no se validó. |
Si el problema persiste, escriba a soporte@nesshq.com indicando el nombre del equipo y el resultado de --doctor.
Guías para el cliente NESS HQ (2026); S4, S6, S11, S12, S13. Ver Fuentes.