La sonda Scout risulta offline

La sonda Scout comunica con RECON solo in uscita, inviando un heartbeat ogni 30 secondi. Se gli heartbeat smettono di arrivare, RECON mostra la sonda come offline e non ti permette di avviare nuove scansioni su di essa. Questa guida ti aiuta a capire perché e a riportarla online.

3.121:58

Sintomi

Nella pagina Sonde Interne la scheda della sonda mostra uno di questi stati:

Altri segnali dello stesso problema:

• il comando Avvia scansione nel menu della scheda è disattivato;
• una scansione interna termina come Fallita con il messaggio "Sonda disconnessa" oppure "Sonda mai connessa".

Cause

1. Il servizio scout è fermo oppure la macchina della sonda è spenta o in riavvio.
2. L'HTTPS in uscita verso RECON è bloccato: un firewall non lascia passare la porta 443, la regola autorizza un IP fisso invece del nome host, oppure il nome host di RECON non viene risolto dal DNS della macchina.
3. L'installazione non è stata completata: la sonda resta Mai connessa perché il comando di installazione non è arrivato fino in fondo.
4. La chiave API è stata ruotata e la sonda usa ancora quella vecchia: dopo 30 minuti la vecchia chiave smette di funzionare.
5. La sonda è online ma bloccata: risponde, ma una scansione non avanza.
6. La sonda è stata sospesa oppure eliminata da RECON.

Soluzioni

Il servizio è fermo o la macchina è spenta

Accendi la macchina, se serve, poi collegati e controlla il servizio:

sudo systemctl status scout

Il servizio deve risultare active (running). Se non lo è, riavvialo e guarda gli ultimi messaggi di log:

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

Il servizio è configurato per ripartire da solo dopo un errore e all'avvio della macchina. Entro circa un minuto la sonda torna Online.

L'HTTPS in uscita è bloccato

Dalla macchina della sonda verifica che RECON sia raggiungibile:

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

• Se curl non riesce a risolvere il nome, correggi il DNS della macchina.
• Se la connessione va in timeout o viene rifiutata, un firewall blocca l'uscita sulla porta 443. Autorizza il nome host di RECON e non un indirizzo IP fisso, che può cambiare.

Puoi anche usare il comando della sonda:

sudo scout status

Accanto all'indirizzo di RECON compare (connesso) se la sonda raggiunge il server, (non raggiungibile) se non ci riesce.

La sonda è Mai connessa

Il comando di installazione non è andato a buon fine. Controlla i requisiti (Linux con systemd, architettura x86_64 o ARM64, esecuzione come root con sudo) e ripeti l'installazione:

1. Rigenera il comando

   Nella scheda della sonda apri il menu azioni e scegli Rigenera comando di installazione. Il nuovo token di installazione vale 24 ore e la chiave API non cambia.

2. Esegui il comando sulla macchina

   Premi Copia comando ed eseguilo sulla macchina della sonda come root.

3. Controlla lo stato

   Attendi l'heartbeat: la sonda passa a Online in RECON.

La chiave API è stata ruotata

Dopo Ruota chiave API la vecchia chiave resta valida per 30 minuti, poi la sonda non riesce più ad autenticarsi e diventa offline. Imposta la nuova chiave sulla macchina della sonda e riavvia il servizio:

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

La sonda è online ma bloccata

Se la sonda è raggiungibile ma una scansione non avanza, il proprietario della sonda può scegliere Riavvia sonda nel menu della scheda. L'agente si riavvia sulla macchina e si riconnette entro circa un minuto; l'eventuale scansione in corso viene interrotta.

• Se la sonda è offline al momento della richiesta, il riavvio resta in coda e viene applicato quando la sonda si riconnette.
• Se la sonda ha una versione troppo vecchia per il riavvio remoto, RECON ti chiede di eseguire sudo systemctl restart scout sulla macchina oppure di aggiornare prima la sonda.

La sonda è sospesa o eliminata

• Sospesa: la sonda non può eseguire scansioni finché resta sospesa. Contatta il supporto Orizon.
• Eliminata: la sonda è stata rimossa da RECON. Il proprietario può recuperarla con Riattiva dal menu della scheda, se la sonda è ancora disponibile tra quelle eliminate.

Prevenzione

• Tieni accesa la macchina della sonda e lascia il servizio scout abilitato all'avvio.
• Autorizza in uscita il nome host di RECON sulla porta 443, non un IP fisso.
• Dopo aver ruotato la chiave API, aggiorna subito la macchina della sonda: hai 30 minuti.
• Quando sulla scheda compare il badge Aggiorna a v..., aggiorna la sonda con Aggiorna sonda dal menu della scheda.

Contatta il supporto

Se la sonda resta offline dopo questi controlli, contatta il supporto Orizon indicando il nome della sonda e l'output di sudo systemctl status scout e sudo scout status. Non inviare mai la chiave API.