Comment installer la solution de surveillance Sensu sur Ubuntu 22.04

Sensu est un système de surveillance d’infrastructure et d’application open-source conçu pour la surveillance des conteneurs et des non-conteneurs ainsi que pour l’infrastructure multi-cloud.

Sensu est une solution de surveillance évolutive, sécurisée et intégrée pour votre technologie et votre infrastructure serveur. Il peut être utilisé pour surveiller les serveurs, la santé des applications et les services, et envoyer des notifications d’alerte à plusieurs cibles avec une intégration tierce.

Dans ce guide, vous allez configurer la solution de surveillance Sensu sur un serveur Ubuntu 22.04. Vous installerez également et configurerez le client Sensu-go qui sera utilisé pour gérer Sensu. Enfin, vous installerez l’agent Sensu sur l’hôte cible pour surveiller et configurer des vérifications Sensu pour une surveillance de base du système.

Prérequis

Pour compléter ce guide, vous aurez besoin des éléments suivants :

• Deux serveurs Ubuntu 22.04 - Le premier serveur sera utilisé pour installer la solution de surveillance Sensu, et le second serveur est le serveur cible à surveiller.
• Un utilisateur non-root avec des privilèges d’administrateur sudo/root.

Voici les détails du serveur qui seront utilisés pour ce guide :

Hostname        IP Address      Used as  
--------------------------------------------------  
sensugo-server  192.168.5.100   Sensu Server  
machine1        192.168.5.120   Target Monitoring

Passons maintenant à l’installation.

Ajout du dépôt Sensu

Sensu est une solution de surveillance sécurisée et évolutive qui peut être installée sur plusieurs systèmes d’exploitation tels que Linux, macOS, Windows et FreeBSD. Sensu fournit son propre dépôt, en particulier pour les distributions basées sur RHEL et Debian. Les paquets Sensu sont livrés via le dépôt packagecloud.io.

Pour cette première étape, vous allez configurer le dépôt Sensu sur le serveur Sensu et le système de surveillance cible.

Pour commencer, exécutez la commande apt ci-dessous pour mettre à jour l’index des paquets et installer quelques paquets de base sur votre système.

sudo apt update  
sudo apt install wget curl gnupg2 apt-transport-https

Lorsque vous y êtes invité, saisissez y pour confirmer et appuyez sur ENTRÉE.

Ensuite, exécutez la commande ci-dessous pour ajouter le dépôt stable de Sensu à vos systèmes. Cela téléchargera le script bash qui configurera automatiquement le dépôt Sensu pour vos systèmes Ubuntu.

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

Vous recevrez une sortie similaire à celle-ci.

Après l’ajout du dépôt Sensu, vous serez maintenant prêt à commencer l’installation de Sensu Go sur le serveur Sensu et l’agent Sensu sur la surveillance cible.

Installation et configuration de Sensu Go Backend

Sensu Go Backend est le principal composant de la plateforme de surveillance Sensu. Il fournit un tableau de bord d’administration web et une API HTTP qui vous permet de gérer Sensu via la ligne de commande, et fournit également les WebSockets qui seront utilisés pour que les machines/agents cibles se connectent.

Avant de commencer, assurez-vous d’exécuter toutes les commandes suivantes sur le serveur Sensu. Dans cet exemple, le nom d’hôte du serveur est ‘sensugo-server’.

Pour commencer, exécutez la commande apt ci-dessous pour installer le backend Sensu Go.

sudo apt install sensu-go-backend

L’installation devrait maintenant commencer.

Après l’installation de Sensu Go Backend, téléchargez la configuration d’exemple via la commande wget ci-dessous vers le ‘/etc/sensu/backend.yml’. Ensuite, ouvrez le fichier en utilisant la commande de l’éditeur nano.

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

Décommentez les lignes suivantes dans le fichier.

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

Enregistrez le fichier et quittez l’éditeur lorsque vous avez terminé.

Ensuite, exécutez la commande systemctl ci-dessous pour démarrer et activer le service Sensu Go Backend ‘ sensu-backend ‘.

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

Le ‘ sensu-backend ‘ devrait maintenant être en cours d’exécution et activé. De plus, le service sera automatiquement exécuté au démarrage.

Vérifiez l’état du service ‘sensu-backend’ via la commande systemctl suivante.

sudo systemctl is-enabled sensu-backend  
sudo systemctl status sensu-backend

Vous recevrez une sortie similaire à celle-ci - Le service ‘ sensu-backend ‘ est activé et il est maintenant en cours d’exécution.

Avec le Sensu Go Backend en cours d’exécution, vous allez maintenant initialiser le Sensu Go Backend en configurant le mot de passe administrateur et en générant quelques configurations.

Pour initialiser l’installation de Sensu Go Backend, exécutez la commande ci-dessous pour créer de nouvelles variables d’environnement qui seront utilisées pour configurer l’utilisateur et le mot de passe administrateur Sensu.

Cet exemple utilisera ‘ sensuadmin ‘ comme utilisateur et ‘ sensupassword ‘ comme mot de passe. Assurez-vous donc de changer l’utilisateur administrateur et le mot de passe.

export SENSU_BACKEND_CLUSTER_ADMIN_USERNAME=sensuadmin  
export SENSU_BACKEND_CLUSTER_ADMIN_PASSWORD=sensupassword

Maintenant, exécutez la commande ‘sensu-backend’ suivante pour initialiser l’installation de Sensu Go Backend.

sensu-backend init

Vous recevrez une sortie similaire à celle-ci - Le Sensu Go Backend est maintenant initialisé et il fonctionne sur le port par défaut ‘ 3000 ‘.

Maintenant, ouvrez le navigateur web et visitez l’adresse IP du serveur suivie du port TCP 3000 (c’est-à-dire : http://192.168.5.100:3000). Vous devriez obtenir la page de connexion Sensu.

Connectez-vous avec le nom d’utilisateur et le mot de passe lors du processus d’initialisation et cliquez sur ‘ SIGN-IN ‘.

Après vous être connecté, vous devriez voir le tableau de bord d’administration Sensu. Vous avez maintenant terminé l’installation de Sensu Go Backend.

De plus, vous pouvez également vérifier l’état de santé de votre serveur Sensu Go via l’API Sensu.

Installez le paquet ‘ jq ‘ sur votre système via la commande apt ci-dessous.

sudo apt install jq -y

Maintenant, exécutez la commande curl ci-dessous pour accéder à l’API du serveur Sensu qui fonctionne sur le port par défaut ‘ 8080 ‘. Cette commande vérifiera l’état de santé de votre serveur Sensu, puis la sortie sera formatée en json, ce qui rend la sortie lisible.

curl -s http://127.0.0.1:8080/health | jq .

Sortie - Dans la sortie suivante, ‘Healthy: true’ et pas d’erreur.

Installation et configuration de sensuctl

Avec le Sensu Go Backend installé et configuré, vous allez ensuite installer le client Sensu Go sur le serveur Sensu. Le client Sensu Go fournit un utilitaire en ligne de commande ‘sensuctl’ qui vous permet de gérer Sensu via le serveur terminal.

Le fonctionnement de ‘sensuctl’ consiste à communiquer avec le serveur Sensu via l’API pour créer, lire, mettre à jour et supprimer des ressources, des événements et des entités sur le serveur Sensu.

Exécutez la commande apt ci-dessous pour installer le client Sensu Go. L’installation devrait maintenant commencer.

sudo apt install sensu-go-cli

Après l’installation de ‘ sensu-go-cli ‘, ouvrez le fichier ‘~ /.bashrc ‘ en utilisant la commande de l’éditeur nano ci-dessous.

nano ~/.bashrc

Ajoutez les lignes suivantes à la fin du fichier. Cette configuration activera l’auto-complétion pour la commande ‘sensuctl’.

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)

Enregistrez le fichier et quittez lorsque vous avez terminé.

Ensuite, rechargez votre session actuelle en rechargeant le fichier ‘ ~/.bashrc ‘. Puis vérifiez en utilisant la commande ‘sensuctl’.

source ~/.bashrc  
sensuctl TAB

Si vous appuyez sur le bouton TAB après la commande ‘ sensuctl ‘, vous devriez obtenir la liste des options pour cette commande.

Avec le client Sensu Go installé, vous allez maintenant commencer à configurer la connexion au serveur Sensu.

Exécutez la commande ‘ sensuctl configure ‘ ci-dessous pour ajouter le serveur Sensu.

sudo sensuctl configure

On vous demandera maintenant quelques configurations :

• Méthode d’authentification ? nom d’utilisateur/mot de passe
• URL de l’API Sensu Backend ? L’API Sensu fonctionne par défaut sur http://127.0.0.1:8080
• Espace de noms ? par défaut
• Format de sortie préféré ? Sélectionnez le format de sortie que vous souhaitez - cet exemple est tabulaire.
• Nom d’utilisateur ? utilisateur admin pour sensu
• Mot de passe ? mot de passe pour l’utilisateur administrateur sensu

Après la configuration de ‘ sensuctl ‘, exécutez la commande ci-dessous pour vérifier les détails de la configuration actuelle.

sudo sensuctl config view

Vous recevrez une sortie similaire à celle-ci - Le client Sensu Go est maintenant connecté au serveur Sensu via l’API HTTP qui fonctionne par défaut sur localhost:8080.

À ce stade, vous avez terminé la configuration de base du Sensu Go Backend et du client Sensu Go. Dans l’étape suivante, vous allez surveiller la machine cible via l’agent Sensu.

Installation de l’agent Sensu sur la machine cible

L’agent Sensu est un client léger qui s’exécute sur les machines cibles que vous souhaitez surveiller. Il fonctionne en communiquant via WebSockets avec le serveur Sensu avec des fonctionnalités telles que l’auto-enregistrement, l’envoi de messages de maintien en vie et l’exécution de vérifications de surveillance.

Avant de commencer, assurez-vous que le dépôt Sensu est ajouté. Assurez-vous également d’exécuter les commandes ci-dessous sur la machine cible, cet exemple utilise le serveur avec le nom d’hôte ‘ machine1 ‘.

Exécutez la commande apt ci-dessous pour installer l’agent Sensu sur votre système. L’installation devrait se poursuivre automatiquement.

sudo apt install sensu-go-agent

Après l’installation de l’agent Sensu, téléchargez le fichier de configuration de l’agent Sensu vers ‘ /etc/sensu/agent.yml ‘ via la commande curl. Ensuite, ouvrez le fichier ‘/etc/sensu/agent.yml ‘ en utilisant la commande de l’éditeur nano.

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

Changez la configuration par défaut avec les lignes suivantes. Assurez-vous de changer le ‘name’ avec le nom d’hôte de la machine cible, et l’URL du backend est l’adresse WebSocket pour le serveur Sensu qui fonctionne sur le port par défaut ‘ 8081 ‘.

Dans cet exemple, le nom d’hôte de la machine cible est ‘ machine1 ‘ et l’adresse IP du serveur Sensu est ‘ 192.168.5.100 ‘.

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

Enregistrez le fichier et quittez l’éditeur lorsque vous avez terminé.

Ensuite, exécutez la commande systemctl ci-dessous pour démarrer et activer le service ‘ sensu-agent ‘. Le service devrait maintenant être en cours d’exécution et activé, ce qui signifie que le service démarrera automatiquement au démarrage.

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

Vérifiez maintenant le service ‘sensu-agent’ via la commande ci-dessous pour vous assurer que le service est en cours d’exécution.

sudo systemctl is-enabled sensu-agent  
sudo systemctl status sensu-agent

Vous recevrez une sortie comme suit - Le service ‘ sensu-agent ‘ est activé et l’état actuel est en cours d’exécution.

Enfin, retournez au terminal du serveur Sensu et exécutez la commande ‘sensuctl’ ci-dessous pour vérifier que la machine cible ‘machine1’ est disponible sur le serveur Sensu.

sensuctl entity list --format tabular

Vous recevrez une sortie similaire à celle-ci - La machine cible ‘ machine1 ‘ est ajoutée au serveur Sensu via l’agent Sensu.

Maintenant que la machine cible ‘machine1’ est ajoutée au serveur Sensu, vous allez maintenant configurer des vérifications pour une surveillance de base du système.

Configuration des vérifications pour la surveillance du système

Sur Sensu, les vérifications sont là où vous définissez ce que vous souhaitez surveiller. Des exemples de vérifications incluent la surveillance de l’utilisation du CPU, de l’utilisation de la mémoire, de l’utilisation du disque, et bien plus encore. Les vérifications font partie des actifs, qui sont des environnements d’exécution dynamiques partageables et réutilisables.

Dans cette étape, vous allez créer de nouvelles vérifications pour surveiller l’utilisation du CPU, l’utilisation de la mémoire et l’utilisation du disque. Ces vérifications seront utilisées pour surveiller la machine cible ‘ machine1 ‘.

Pour commencer, exécutez la commande sensuctl ci-dessous pour mettre à jour l’entité ou la machine cible ‘ machine1 ‘.

sensuctl entity update machine1

La classe doit être ‘ agent ‘ et l’abonnement doit être ‘ System ‘.

Exécutez maintenant l’utilitaire de commande sensuctl ci-dessous pour ajouter des actifs à votre serveur Sensu. Vous pouvez obtenir un autre actif de Sensu depuis le hub d’actifs Sensu https://bonsai.sensu.io.

sensuctl asset add sensu/check-cpu-usage  
sensuctl asset add sensu/check-memory-usage  
sensuctl asset add sensu/check-disk-usage

Vous recevrez une sortie similaire à celle-ci.

Ajout de l’actif d’exécution ‘ sensu/check-cpu-usage ‘

Ajout de l’actif d’exécution ‘ sensu/check-memory-usage ‘.

Ajout de l’actif d’exécution ‘ sensu/check-disk-usage ‘.

Ensuite, vérifiez la liste des actifs sur le serveur Sensu via la commande sensuctl ci-dessous. Vous devriez voir ces actifs d’exécution ajoutés au serveur Sensu.

sensuctl asset list

Avec les actifs Sensu ajoutés, vous allez ensuite créer des vérifications basées sur les actifs que vous avez ajoutés.

Exécutez la commande ci-dessous pour créer une vérification ‘check_cpu’ avec l’abonnement comme ‘ system ‘ et utilisez l’actif d’exécution ‘ sensu/check-cpu-usage ‘. Vous pouvez ajuster les paramètres sur l’option ‘ command ‘.

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

Exécutez la commande ci-dessous pour créer une vérification ‘ check_mem ‘ avec l’abonnement comme ‘system’ et utilisez l’actif d’exécution ‘ sensu/check-memory-usage ‘. Vous pouvez ajuster les paramètres sur l’option ‘ command ‘.

sensuctl check create check_mem \  
--command 'check-memory-usage -w 80 -c 90' \  
--interval 60 \  
--subscriptions system \  
--runtime-assets sensu/check-memory-usage

Exécutez la commande ci-dessous pour créer une vérification ‘check_disk’ avec l’abonnement comme ‘ system ‘ et utilisez l’actif d’exécution ‘sensu/check-disk-usage ‘. Vous pouvez ajuster les paramètres sur l’option ‘ command ‘.

sensuctl check create check_disk \  
--command 'check-disk-usage --include-fs-type "xfs,ext4" --exclude-fs-path "/boot" --warning 90 --critical 95' \  
--interval 60 \  
--subscriptions system \  
--runtime-assets sensu/check-disk-usage

Maintenant, vérifiez la liste des vérifications sur le serveur Sensu via l’utilitaire de commande ‘sensuctl’ ci-dessous. Vous verrez alors trois vérifications que vous avez créées, check_cpu, check_mem et check_disk.

sensuctl check list

Maintenant, retournez dans le navigateur web et visitez le tableau de bord d’administration Sensu. Assurez-vous d’être dans l’espace de noms ‘ default ‘, puis cliquez sur ‘ Entities ‘.

Vous devriez voir que la machine cible ‘ machine1 ‘ est ajoutée avec le statut OK.

Cliquez sur ‘ machine1 ‘ pour obtenir des détails sur la surveillance. Et vous devriez obtenir une page comme suit - toutes les vérifications que vous avez créées sont exécutées et en cours d’exécution.

Vous avez maintenant créé et configuré des actifs et des vérifications pour la surveillance du système sur le serveur Sensu.

Conclusion

Vous avez maintenant installé la solution de surveillance Sensu sur le serveur Ubuntu 22.04. Vous avez également appris l’utilisation de base de la commande Sensuctl pour gérer le backend Sensu. De plus, vous avez réussi à surveiller la machine hôte Linux via l’agent Sensu et à configurer des “actifs” et des “vérifications” pour surveiller les serveurs cibles.