La sonda Scout aparece sin conexión

La sonda Scout solo se comunica con RECON en sentido saliente y envía un heartbeat cada 30 segundos. Si los heartbeats dejan de llegar, RECON muestra la sonda sin conexión y no te deja iniciar nuevos escaneos con ella. Esta guía te ayuda a averiguar el motivo y a volver a ponerla en línea.

Síntomas

En la página Sondas Internas, la tarjeta de la sonda muestra uno de estos estados:

Otras señales del mismo problema:

• la opción Ejecutar exploración del menú de la tarjeta está desactivada;
• un escaneo interno termina como Fallido con el mensaje "Sonda desconectada" o "La sonda nunca se conectó".

Causas

1. El servicio scout está detenido, o el equipo de la sonda está apagado o reiniciándose.
2. El HTTPS saliente hacia RECON está bloqueado: un firewall no deja pasar el puerto 443, la regla autoriza una IP fija en lugar del nombre de host, o el DNS del equipo no resuelve el nombre de host de RECON.
3. La instalación no terminó: la sonda sigue Nunca conectada porque el comando de instalación no se completó.
4. Se rotó la clave API y la sonda sigue usando la anterior: a los 30 minutos la clave anterior deja de funcionar.
5. La sonda está en línea pero bloqueada: responde, pero un escaneo no avanza.
6. La sonda está suspendida o se eliminó de RECON.

Soluciones

El servicio está detenido o el equipo apagado

Enciende el equipo si hace falta, conéctate y comprueba el servicio:

sudo systemctl status scout

El servicio debe aparecer como active (running). Si no es así, reinícialo y revisa las últimas líneas del registro:

sudo systemctl restart scout
sudo journalctl -u scout -n 50

El servicio está configurado para reiniciarse solo tras un error y al arrancar el equipo. En aproximadamente un minuto la sonda vuelve a estar En línea.

El HTTPS saliente está bloqueado

Desde el equipo de la sonda, comprueba que RECON sea accesible:

curl -sS https://recon.orizon.one/api/ping

• Si curl no consigue resolver el nombre, corrige el DNS del equipo.
• Si la conexión agota el tiempo o es rechazada, un firewall bloquea la salida por el puerto 443. Autoriza el nombre de host de RECON y no una dirección IP fija, que puede cambiar.

También puedes usar el comando de la sonda:

sudo scout status

Junto a la dirección de RECON aparece (conectado) si la sonda llega al servidor e (inaccesible) si no lo consigue.

La sonda está Nunca conectada

El comando de instalación no se completó. Revisa los requisitos (Linux con systemd, equipo x86_64 o ARM64, ejecución como root con sudo) y vuelve a instalar:

1. Regenera el comando

   En la tarjeta de la sonda abre el menú de acciones y elige Regenerar comando de instalación. El nuevo token de instalación es válido 24 horas y la clave API no cambia.

2. Ejecuta el comando en el equipo

   Pulsa Copiar comando y ejecútalo en el equipo de la sonda como root.

3. Comprueba el estado

   Espera el heartbeat: la sonda pasa a En línea en RECON.

Se rotó la clave API

Después de Rotar clave API, la clave anterior sigue funcionando 30 minutos. Pasado ese tiempo la sonda ya no puede autenticarse y queda sin conexión. Configura la nueva clave en el equipo de la sonda y reinicia el servicio:

sudo scout config set api_key <NUEVA_CLAVE_API>
sudo systemctl restart scout

La sonda está en línea pero bloqueada

Si la sonda es accesible pero un escaneo no avanza, el propietario de la sonda puede elegir Reiniciar sonda en el menú de la tarjeta. El agente se reinicia en el equipo y vuelve a conectarse en aproximadamente un minuto; el escaneo en curso se interrumpe.

• Si la sonda está sin conexión cuando lo pides, el reinicio queda en cola y se aplica cuando la sonda se vuelve a conectar.
• Si la versión de la sonda es demasiado antigua para el reinicio remoto, RECON te pide ejecutar sudo systemctl restart scout en el equipo o actualizar antes la sonda.

La sonda está suspendida o eliminada

• Suspendida: la sonda no puede ejecutar escaneos mientras esté suspendida. Contacta con el soporte de Orizon.
• Eliminada: la sonda se quitó de RECON. El propietario puede recuperarla con Reactivar en el menú de la tarjeta, si la sonda sigue apareciendo entre las eliminadas.

Prevención

• Mantén encendido el equipo de la sonda y deja el servicio scout habilitado al arranque.
• Autoriza en salida el nombre de host de RECON en el puerto 443, no una IP fija.
• Después de rotar la clave API, actualiza enseguida el equipo de la sonda: tienes 30 minutos.
• Cuando la tarjeta muestre la insignia Actualizar a v..., actualiza la sonda con Actualizar sonda desde el menú de la tarjeta.

Contactar con soporte

Si la sonda sigue sin conexión tras estas comprobaciones, contacta con el soporte de Orizon indicando el nombre de la sonda y la salida de sudo systemctl status scout y sudo scout status. No envíes nunca la clave API.