Installare Sensu Go su Windows 10 e 11 tramite WSL

Sensu Go su Windows 10 e 11 non si installa davvero “su Windows” nel senso classico: la strada corretta è passare da WSL2 e trattare il sistema Microsoft come host, mentre l’ambiente operativo resta Linux. È la scelta più pulita per avere un agent coerente con il comportamento atteso, usare tooling Unix e mantenere una procedura vicina a quella che useresti su un server reale.

Per un desktop o una postazione di test, questa impostazione è pratica: puoi validare check, script, pipeline e connettività verso il backend senza dover adattare tutto al modello di servizi, permessi e path di Windows. Se invece l’obiettivo è un deployment stabile in produzione, il backend Sensu Go va lasciato su Linux o in un ambiente containerizzato controllato; WSL su un PC client è perfetto per laboratorio, sviluppo e troubleshooting, non come piattaforma da backend esposta agli utenti.

Architettura consigliata: Windows come host, WSL come runtime Linux

La configurazione che regge meglio nel tempo è semplice e separa i ruoli senza forzature:

• Windows 10/11: abilita WSL2, aggiorna il kernel WSL e ospita la distribuzione Linux.
• WSL: esegue Sensu agent, plugin, script di check e strumenti di diagnostica.
• Backend Sensu Go: rimane su Linux, con API, datastore e dashboard raggiungibili in rete.

Questa separazione riduce gli attriti più comuni: niente conversioni strane di path, niente dipendenze da servizi Windows per far partire l’agent, niente compromessi sul comportamento dei plugin. In più, se il backend è remoto, puoi cambiare il desktop senza toccare la piattaforma di monitoraggio.

Prerequisiti su Windows 10 e 11: cosa verificare prima di installare Sensu

Prima di installare Sensu Go, assicurati che WSL2 sia attivo e che la distribuzione Linux funzioni davvero. Su Windows 11 il setup è più lineare, ma il controllo non cambia. Servono privilegi amministrativi per abilitare le funzionalità di sistema e installare o aggiornare i componenti WSL.

1. Apri PowerShell come amministratore e verifica lo stato di WSL.
2. Controlla che la distribuzione installata sia su WSL2, non su WSL1.
3. Verifica che la distro parta correttamente e che abbia rete, DNS e accesso ai repository.
4. Aggiorna i pacchetti base della distro prima di installare Sensu.

Comandi utili per il controllo iniziale:

wsl --status
wsl --list --verbose
wsl --update
wsl --install -d Ubuntu

Se wsl --status mostra una versione del kernel non aggiornata o wsl --list --verbose indica Version 1, conviene correggere subito la base. Sensu dentro WSL funziona bene solo se la distro è realmente WSL2: è il punto che evita metà dei problemi di rete, filesystem e compatibilità.

Installazione della distribuzione Linux e preparazione del sistema

Una volta installata la distro, entra nel prompt Linux e aggiorna il sistema. Su Ubuntu i pacchetti necessari dipendono da come intendi usare Sensu, ma in generale ti servono strumenti per scaricare repository, verificare certificati e lanciare script di test.

sudo apt update
sudo apt upgrade -y
sudo apt install -y curl ca-certificates gnupg jq

Se la tua procedura prevede repository esterni, verifica prima che la VM WSL abbia connettività corretta. Un errore DNS o un proxy aziendale mal configurato si traduce in installazioni incomplete e check che sembrano fallire per colpa di Sensu, quando in realtà il problema è a monte.

Installare Sensu Go in WSL: agent prima di tutto

In scenari desktop la scelta sensata è installare sensu-agent. Il backend resta altrove e l’agent si limita a registrarsi, eseguire check e spedire risultati. È il componente che ha più senso su una macchina Windows con WSL, perché non richiede di trasformare il PC in un nodo server completo.

La procedura esatta dipende dal repository e dalla versione che stai usando, quindi conviene seguire la documentazione del tuo canale di distribuzione. La logica operativa però resta sempre la stessa: aggiungi il repository, installa il pacchetto, configura il file dell’agent e avvialo dentro WSL.

sudo apt install -y sensu-go-agent

In alcune release i nomi dei pacchetti o i repository possono cambiare. Se il pacchetto non viene trovato, non forzare tentativi casuali: verifica il repository configurato, la versione della distro e il canale ufficiale del progetto. Il sintomo tipico è un Unable to locate package o un errore di chiave GPG durante apt update.

Configurazione dell’agent: backend, namespace e credenziali

Una volta installato il pacchetto, il passaggio importante è configurare l’agent per parlare con il backend Sensu Go. In un setup reale ti servono almeno endpoint API, nome del nodo, namespace e token o credenziali previste dalla tua installazione. La regola pratica è non mettere segreti in chiaro nei file condivisi e ruotare i token se sono stati esposti nei log o in una shell history.

Il file di configurazione e il nome del servizio possono variare in base al pacchetto, ma il controllo da fare è sempre questo: confermare che l’agent punti al backend giusto, che il certificato TLS sia valido e che il nodo venga registrato con il nome atteso. Se il backend è su una rete diversa, controlla anche firewall e reachability dalla distro WSL.

sudo systemctl status sensu-agent
sudo journalctl -u sensu-agent -n 100 --no-pager

Su WSL, il comportamento dei servizi dipende dalla versione di Windows e dalla distro. Nelle configurazioni moderne systemd è disponibile, ma non dare per scontato che il servizio parta da solo dopo il reboot dell’host. Se il tuo ambiente non usa systemd, dovrai avviare l’agent con il metodo previsto dalla distro o abilitare il supporto systemd in WSL.

Verifica operativa: come capire se Sensu sta davvero lavorando

La verifica non si limita a “il pacchetto è installato”. Devi controllare tre cose: il processo è attivo, il backend vede il nodo e i check tornano con esito coerente. Se uno di questi tre punti manca, l’installazione è incompleta anche se i comandi base sembrano andare a buon fine.

• Stato servizio: systemctl status sensu-agent deve mostrare active (running) o lo stato previsto dalla distro.
• Log: journalctl -u sensu-agent non deve mostrare errori ripetuti di connessione, TLS o autenticazione.
• Lato backend: il nodo deve comparire nella console o via API con il nome configurato.

Se vuoi un controllo sintetico dal lato backend, usa l’API o la console per verificare che l’entity sia presente e che gli eventi arrivino. Se invece il problema è di connettività, fai prima un test semplice dalla distro WSL verso l’host remoto:

curl -vk https://sensu-backend.example.com:8080/health

Un 200 OK o una risposta coerente dell’endpoint di salute conferma che rete e TLS sono a posto. Se fallisce, il problema non è l’agent: è la connettività, il certificato o il routing tra WSL e backend.

Limiti pratici di WSL per Sensu Go su desktop

WSL è ottimo per eseguire un agent e per fare test, ma non è un sostituto completo di una macchina Linux server. I limiti da tenere presenti sono soprattutto tre: gestione dei servizi non sempre identica a una distro nativa, persistenza legata al ciclo di vita della sessione e integrazione con il networking di Windows che può introdurre differenze rispetto a un host Linux puro.

In più, se usi il desktop per attività di sviluppo, è facile confondere i confini tra ambiente locale e produzione. Conviene quindi tenere separati i file di configurazione, usare namespace di test e non riutilizzare token o chiavi pensati per ambienti reali. Se un segreto finisce in un file copiato male o in una history shell, considera la rotazione immediata.

Problemi tipici e correzioni rapide

Se Sensu non parte o non si registra, nella maggior parte dei casi il guasto è in uno di questi punti: WSL non è davvero in versione 2, il backend non è raggiungibile, il certificato TLS non è fidato, oppure il servizio non è stato abilitato correttamente dentro la distro.

1. WSL1 invece di WSL2: verifica con wsl --list --verbose e converti la distro se necessario.
2. DNS o rete rotti: prova un curl verso il backend e controlla la risoluzione nomi dalla distro.
3. TLS non valido: verifica certificato, CA e hostname usato nell’URL del backend.
4. Servizio non attivo: controlla systemctl status e i log di journalctl.

Se devi fare troubleshooting, il percorso corretto è sempre partire dall’osservabilità: stato servizio, log e connettività. Solo dopo ha senso intervenire sulla configurazione. Cambiare parametri a tentativi, senza una lettura dei log, allunga i tempi e rende più difficile capire quale modifica ha risolto davvero il problema.

Quando usare davvero questa soluzione

Installare Sensu Go tramite WSL ha senso quando vuoi monitorare un desktop, testare un’installazione, sviluppare check o replicare rapidamente un ambiente Linux su una macchina Windows. È una soluzione comoda anche per chi lavora su notebook aziendali e non può installare direttamente servizi Linux nativi.

Se invece ti serve alta affidabilità, avvio automatico robusto, controllo stretto dei servizi e integrazione completa con un’infrastruttura server, sposta tutto su Linux vero. WSL è un ottimo ponte operativo, non il posto giusto per costruire il backend di monitoraggio di un’intera piattaforma.

Assunzione operativa: i comandi e i nomi dei pacchetti possono variare in base alla versione di Sensu Go, alla distro Linux scelta e allo stato di WSL su Windows; prima di applicare modifiche in un ambiente reale, verifica sempre repository, servizio e percorso di configurazione nella tua installazione specifica.