Come installare la soluzione di monitoraggio Sensu su Debian 11

Sensu è un sistema di monitoraggio delle infrastrutture e delle applicazioni open-source progettato per il monitoraggio sia di container che di non-container e per infrastrutture multi-cloud. Sensu è una soluzione di monitoraggio scalabile, sicura e integrata per la tua tecnologia e infrastruttura server. Può essere utilizzato per monitorare server, salute delle applicazioni e servizi, e inviare notifiche di allerta a più destinazioni con integrazione di terze parti.

In questo tutorial, imparerai come installare il software di monitoraggio Sensu su un server Debian 11. Imparerai anche come configurare Sensu CLI per gestire Sensu. Infine, imparerai come impostare il monitoraggio del server con Sensu tramite Sensu Agent.

Requisiti

Per questa distribuzione di Sensu, avrai bisogno dei seguenti requisiti:

• Un server Debian 11 con 4 GB di RAM e 2 CPU. Questo requisito dipende molto dal tuo ambiente infrastrutturale.
• Un utente non root con privilegi sudo/amministratore.
• Una macchina Linux sarà utilizzata come obiettivo da monitorare.

Aggiungere il repository Sensu

Per iniziare con l’installazione di Sensu, dovrai aggiungere il repository dei pacchetti Sensu a tutti i tuoi sistemi, sia al Backend di Sensu che ai server target.

Il repository Sensu è disponibile su packagecloud.io, che può essere aggiunto al tuo sistema manualmente o tramite lo script bash fornito da packagecloud.io.

Prima di aggiungere il repository Sensu, esegui il comando apt qui sotto per installare le dipendenze di base dei pacchetti. Premi Y e Invio quando richiesto per confermare l’installazione.

sudo apt install debian-archive-keyring curl gnupg apt-transport-https

Ora esegui il seguente comando per aggiungere il repository Sensu. Questo script bash aggiungerà automaticamente il repository Sensu e la chiave GPG ai tuoi server Debian.

curl -s https://packagecloud.io/install/repositories/sensu/stable/script.deb.sh | sudo bash

Se desideri aggiungere manualmente il repository Sensu, segui questi passaggi:

Crea una directory di keyring per memorizzare la chiave GPG del repository Sensu.

mkdir -p /etc/apt/keyrings/  
curl -fsSL https://packagecloud.io/sensu/stable/gpgkey | gpg --dearmor > /etc/apt/keyrings/sensu_stable-archive-keyring.gpg

Aggiungi il repository Sensu utilizzando il seguente comando. Questo repository è per Debian 11 Bullseye e l’ultima versione stabile di Sensu.

cat <

Ora puoi aggiornare e aggiornare l’indice dei pacchetti Debian utilizzando il seguente comando apt.

sudo apt update

Installazione di Sensu Backend

Il cuore principale della soluzione di monitoraggio Sensu è un “Sensu Backend”, che fornisce un’API HTTP che può essere utilizzata da un amministratore tramite il comando “sensuctl”. L’API WebSocket sarà utilizzata da “Sensu Agent” per il monitoraggio e fornisce anche un’interfaccia web UI per gestire Sensu.

Inoltre, Sensu utilizza “ etcd “ per memorizzare i dati, specialmente su grandi distribuzioni di cluster Sensu.

Per installare Sensu Backend, esegui il comando apt qui sotto. L’installazione inizierà automaticamente.

sudo apt install sensu-go-backend

Dopo che l’installazione è terminata, scarica il campione di configurazione del backend di Sensu in “/etc/sensu/backend.yml”. Quindi, modifica il file “/etc/sensu/backend.yml” utilizzando il seguente comando.

sudo curl -L https://docs.sensu.io/sensu-go/latest/files/backend.yml -o /etc/sensu/backend.yml  
sudo nano /etc/sensu/backend.yml

Decommenta la seguente configurazione.

cache-dir: "/var/cache/sensu/sensu-backend"  
config-file: "/etc/sensu/backend.yml"  
  
log-level: "debug"  
state-dir: "/var/lib/sensu/sensu-backend"

Quando hai finito, salva e chiudi il file.

Successivamente, esegui il seguente comando systemctl per avviare il servizio Sensu Backend e abilitarlo. E il servizio Sensu Backend sarà automaticamente in esecuzione all’avvio del sistema.

sudo systemctl start sensu-backend  
sudo systemctl enable sensu-backend

Controlla e verifica il servizio backend di Sensu utilizzando il comando qui sotto. Dovresti vedere che il servizio Sensu Backend è attualmente in esecuzione e abilitato.

sudo systemctl status sensu-backend

Dopo che il backend di Sensu è in esecuzione, ora inizializzerai l’installazione e la configurazione di Sensu Backend. Questo può essere fatto utilizzando la riga di comando “sensu-backend init”, che è fornita dal pacchetto Sensu Backend.

Inoltre, durante l’inizializzazione di Sensu Backend, imposterai l’utente admin e la password per la tua soluzione di monitoraggio Sensu.

Esegui il seguente comando per creare nuove variabili di ambiente di sistema per l’utente admin di Sensu e la password. In questo esempio, creerai un nuovo utente admin di Sensu “ adminsensu “ con la password “ SensuRocks “.

export SENSU_BACKEND_CLUSTER_ADMIN_USERNAME=adminsensu  
export SENSU_BACKEND_CLUSTER_ADMIN_PASSWORD=SensuRocks

Ora inizia a inizializzare il backend di Sensu utilizzando il comando qui sotto. Dovresti vedere il processo di inizializzazione e Sensu memorizzerà i dati all’interno del datastore “etcd”.

sensu-backend init

Per controllare e verificare la tua installazione di Sensu backend, eseguirai il controllo della salute di Sensu tramite il comando curl all’API HTTP di Sensu che è in esecuzione sulla porta predefinita “8080”.

Esegui il comando curl qui sotto per effettuare il controllo della salute della tua installazione di Sensu backend. Dovresti vedere il messaggio di output sullo schermo del terminale come “ health: OK “.

curl http://127.0.0.1:8080/health

Puoi anche visitare il dashboard web UI di Sensu tramite la porta TCP “ 3000 “. Apri il tuo browser web e visita l’indirizzo IP del tuo server seguito dalla porta 3000 (ad es.: http://192.168.5.100:3000). E dovresti vedere la pagina di accesso di Sensu.

Inserisci l’utente admin “ adminsensu “ con la password “ SensuRocks “. Quindi, fai clic su “ SIGN-IN “ per accedere al dashboard web UI di Sensu.

Ora dovresti vedere il dashboard di amministrazione web di Sensu.

Installazione del comando Sensuctl

Su Sensu, l’amministratore può gestire la soluzione di monitoraggio Sensu tramite il dashboard di amministrazione web UI di Sensu e tramite il terminale della riga di comando utilizzando “ sensuctl “.

Il “ sensuctl “ è uno strumento da riga di comando per gestire le risorse di Sensu. Viene utilizzato un’API HTTP per comunicare con Sensu Backend, che ti consente di creare, leggere e eliminare risorse, eventi ed entità.

Il “ sensuctl “ può essere installato su più sistemi operativi come Linux, Windows e macOS. La funzione di “sensuctl” è simile al dashboard web UI di Sensu, e puoi installarlo sulla tua workstation locale o sul server “bastion” sicuro della tua infrastruttura.

Per i sistemi basati su Debian/Ubuntu, esegui il seguente comando apt qui sotto per installare lo strumento da riga di comando “ sensuctl “. L’installazione inizierà automaticamente.

sudo apt install sensu-go-cli

Dopo che l’installazione è terminata, esegui il seguente comando “ sensuctl “ per iniziare a configurare e connetterti all’API del server Sensu Backend.

sensuctl configure

Ti verrà chiesto di configurare quanto segue:

• Per il metodo di autenticazione, seleziona “username/password”.
• Inserisci l’URL API di Sensu Backend del tuo server. In questo esempio, configureremo “sensuctl” sullo stesso server, quindi l’host sarà localhost o “127.0.0.1”. E la porta predefinita per l’API HTTP di Sensu è “8080” - http://127.0.0.1:8080.
• Per la configurazione dello spazio dei nomi, seleziona “default”.
• Per il formato di output, puoi selezionare lo stile “tabular” o utilizzare il formato di output “yaml”.
• Infine, inserisci l’utente admin e la password per il tuo Sensu Backend.

Ora hai completato la configurazione di base di “ sensuctl “ e ti sei connesso al server API di Sensu Backend.

Esegui il seguente comando “ sensuctl “ qui sotto per controllare la tua configurazione. Dovresti vedere le configurazioni dettagliate dell’API di “ sensuctl “.

sensuctl config view

Inoltre, il “sensuctl” fornisce anche un’auto-completamento per la tua shell. Se stai usando bash, devi installare il pacchetto “bash-completion” e aggiungere alcune configurazioni al file di configurazione “ ~/.bashrc “.

Esegui il seguente comando apt per installare il pacchetto “bash-completion”.

sudo apt install bash-completion

Ora modifica la configurazione “~/.bashrc” utilizzando il seguente comando.

sudo nano ~/.bashrc

Aggiungi la seguente configurazione al file.

if [ -f /usr/share/bash-completion/bash_completion ]; then  
. /usr/share/bash-completion/bash_completion  
elif [ -f /etc/bash_completion ]; then  
. /etc/bash_completion  
fi  
  
source <(sensuctl completion bash)

Quando hai finito, salva e chiudi il file.

Successivamente, ricarica la sessione corrente della tua shell utilizzando il seguente comando.

source ~/.bashrc

Infine, inserisci il comando “ sensuctl “ e premi il pulsante TAB per ottenere tutte le opzioni di comando disponibili. Dovresti ottenere tutte le opzioni disponibili del comando “ sensuctl “.

sensuctl TAB

Installazione di Sensu Agent

Per monitorare l’host o la macchina utilizzando Sensu, devi installare il pacchetto Sensu Agent su tutti i tuoi host. Il Sensu Agent è disponibile per quasi tutte le distribuzioni Linux e Windows.

Per installare Sensu Agent su un sistema Linux, assicurati che il repository Sensu sia stato aggiunto.

Per i sistemi basati su Debian/Ubuntu, esegui il seguente comando apt per installare il pacchetto Sensu Agent. Ora l’installazione inizierà.

sudo apt install sensu-go-agent

Dopo che l’installazione è terminata, scarica la configurazione di Sensu Agent in “ /etc/sensu/agent.yml “. Quindi, modifica la configurazione “ /etc/sensu/agent.yml “ utilizzando il comando qui sotto.

sudo curl -L https://docs.sensu.io/sensu-go/latest/files/agent.yml -o /etc/sensu/agent.yml  
sudo nano /etc/sensu/agent.yml

Decommenta queste seguenti configurazioni. Assicurati di cambiare il “name” qui con il nome host del sistema e il “ backend-url “ con l’indirizzo IP del server Sensu Backend.

In questo esempio, aggiungeremo una macchina Debian con il nome host “ linux-host1 “ e disponibile nello spazio dei nomi “ default “. Il server Sensu Backend qui è “ 192.168.5.100 “ con la porta predefinita dell’API WebSocket di Sensu Backend “ 8081 “.

name: "linux-host1"  
namespacer: "default"  
...  
backend-url:  
  - "ws://192.168.5.100:8081"  
cache-dir: "/var/cache/sensu/sensu-agent"  
config-file: "/etc/sensu/agent.yml"

Quando hai finito, salva e chiudi il file.

Successivamente, esegui il seguente comando per avviare il servizio Sensu Agent e abilitarlo per l’esecuzione automatica all’avvio del sistema.

sudo systemctl start sensu-agent  
sudo systemctl enable sensu-agent

Ora esegui il seguente comando per controllare e verificare il servizio Sensu Agent. Dovresti vedere che il Sensu Agent è in esecuzione e abilitato.

sudo systemctl status sensu-agent

Successivamente, torna al tuo browser web e seleziona lo spazio dei nomi “ default “. E dovresti vedere il nuovo host entità “ linux-host1 “ disponibile.

Puoi anche controllare dalla riga di comando del terminale utilizzando il comando “ sensuctl “ qui sotto. Dovresti vedere l’agente “ linux-host1 “ aggiunto alla soluzione di monitoraggio Sensu.

sensuctl entity list --format tabular

Monitorare le risorse del server con i controlli

Il Sensu Agent funziona solo per fornire un modo per il nodo agente o il server target di comunicare con il Sensu Backend tramite l’API WebSocket. Per monitorare le risorse del server come l’uso della CPU, l’uso della larghezza di banda e l’uso del disco, dovrai impostare “Subscription” e creare alcuni “Check” su di esso. Poi, puoi aggiungere più “Subscriptions” al Sensu Agent o al server target.

Per monitorare le risorse del server utilizzando Sensu, dovrai seguire i seguenti passaggi:

• Creare Subscription
• Registrare le risorse di runtime di Sensu
• Definire i comandi di Check per controllare le risorse di sistema

Prima di andare oltre, esegui il seguente comando “sensuctl” per creare una nuova subscription chiamata “ system “ per l’entità “ linux-host1 “.

sensuctl entity update linux-host1

Ti verrà chiesto di rispondere alle seguenti domande:

• Per la “Entity Class”, lascia come predefinito “ agent “ e premi INVIO.
• Per le “Subscriptions”, inserisci il nome della subscription “ system “ e premi INVIO.

Su Sensu, “ Checks “ definisce fondamentalmente solo un comando che può essere utilizzato per monitorare le risorse del server. “ Checks “ è la riga di comando che puoi definire sopra le “Assets” e “Subscriptions” di Sensu per tutte le tue esigenze di monitoraggio. Per creare “ Checks “, imposterai risorse di runtime dinamiche tramite il comando “sensuctl”. Tutte le “Assets” di Sensu possono essere trovate su https://bonsai.sensu.io/.

Ora esegui il comando “ sensuctl “ qui sotto per creare e registrare le “Assets” di Sensu per monitorare l’uso della CPU. Dovresti vedere il messaggio di output come “added asset: sensu/check-cpu-usage:0.2.2”. In questo esempio, rinominiamo anche il nome predefinito dell’asset in “check-cpu-usage” con l’opzione “-r”.

sensuctl asset add sensu/check-cpu-usage:0.2.2 -r check-cpu-usage

Ora esegui il seguente comando per controllare l’elenco delle risorse di Sensu. Dovresti vedere l’asset “ check-cpu-usage “ disponibile su Sensu.

sensuctl asset list

Successivamente, esegui il seguente comando per creare il comando “ Checks “ per monitorare l’uso della CPU. In questo esempio, creerai un nuovo comando di controllo chiamato “ check_cpu “ che sarà disponibile sulla subscription “system” e basato sull’asset “ check-cpu-usage “. Puoi anche cambiare il parametro qui nell’opzione “–command”. E dovresti ricevere il messaggio di output come “ Created “.

sensuctl check create check_cpu \  
--command 'check-cpu-usage -w 75 -c 90' \  
--interval 60 \  
--subscriptions system \  
--runtime-assets check-cpu-usage

Esegui il seguente comando “ sensuctl “ per controllare e verificare il “ check_cpu “. Dovresti vedere i dettagli dei “ Checks “ del “ check_cpu “ che hai appena creato.

sensuctl check info check_cpu --format yaml

Ora puoi verificare il monitoraggio dell’evento “ check_cpu “ utilizzando il comando qui sotto. Dovresti vedere il monitoraggio dell’uso della CPU per “ linux-host1 “ configurato e completato.

sensuctl event list --format tabular

Ora vai al dashboard di amministrazione di Sensu e seleziona lo spazio dei nomi “ default “. Nel menu “ Entity “, dovresti vedere l’agente “ linux-host1 “ aggiunto al sistema di monitoraggio Sensu.

Ora, se fai clic sui dettagli dell’agente “ linux-host1 “, vedrai il monitoraggio “ Checks “ di “ check_cpu “ che hai appena creato.

Successivamente, puoi aggiungere e creare più “Checks” per il tuo sistema di monitoraggio.

Conclusione

Hai ora eseguito l’installazione della soluzione di monitoraggio Sensu su un server Debian 11. Hai anche appreso l’uso di base del comando Sensuctl per gestire il backend di Sensu. Inoltre, hai monitorato con successo la macchina host Linux tramite il Sensu Agent e impostato “checks” per monitorare il tuo server target.