Comment installer la solution de surveillance Sensu sur Debian 11

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 tutoriel, vous apprendrez comment installer le logiciel de surveillance Sensu sur un serveur Debian 11. Vous apprendrez également à configurer Sensu CLI pour gérer Sensu. Enfin, vous apprendrez à configurer la surveillance des serveurs avec Sensu via Sensu Agent.

Prérequis

Pour ce déploiement de Sensu, vous aurez besoin des exigences suivantes :

• Un serveur Debian 11 avec 4 Go de RAM et 2 CPU. Cette exigence dépend beaucoup de votre environnement d’infrastructure.
• Un utilisateur non-root avec des privilèges sudo/administrateur.
• Une machine Linux sera utilisée comme cible à surveiller.

Ajout du dépôt Sensu

Pour commencer l’installation de Sensu, vous devrez ajouter le dépôt de paquets Sensu à tous vos systèmes, à la fois pour Sensu Backend et pour les serveurs cibles.

Le dépôt Sensu est disponible sur packagecloud.io, qui peut être ajouté à votre système manuellement ou via le script bash fourni par packagecloud.io.

Avant d’ajouter le dépôt Sensu, exécutez la commande apt ci-dessous pour installer les dépendances de paquets de base. Appuyez sur Y et Entrée lorsque vous y êtes invité pour confirmer l’installation.

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

Maintenant, exécutez la commande suivante pour ajouter le dépôt Sensu. Ce script bash ajoutera automatiquement le dépôt Sensu et la clé GPG à vos serveurs Debian.

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

Si vous souhaitez ajouter manuellement le dépôt Sensu, suivez ces étapes :

Créez un répertoire de trousseau pour stocker la clé GPG du dépôt Sensu.

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

Ajoutez le dépôt Sensu en utilisant la commande suivante. Ce dépôt est pour Debian 11 Bullseye et la dernière version stable de Sensu.

cat <

Maintenant, vous pouvez mettre à jour et rafraîchir votre index de paquets Debian en utilisant la commande apt suivante.

sudo apt update

Installation de Sensu Backend

Le cœur principal de la solution de surveillance Sensu est un “Sensu Backend”, qui fournit une API HTTP pouvant être utilisée par un administrateur via la ligne de commande “sensuctl”. L’API WebSocket qui sera utilisée par “Sensu Agent” pour la surveillance, et fournit également un tableau de bord UI web pour gérer Sensu.

De plus, Sensu utilise “ etcd “ pour stocker des données, en particulier lors du déploiement de grands clusters Sensu.

Pour installer Sensu Backend, exécutez la commande apt ci-dessous. L’installation commencera automatiquement.

sudo apt install sensu-go-backend

Après que l’installation soit terminée, téléchargez l’échantillon de configuration de Sensu backend dans “/etc/sensu/backend.yml”. Ensuite, éditez le fichier “/etc/sensu/backend.yml” en utilisant la commande suivante.

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 la configuration suivante.

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

Lorsque vous avez terminé, enregistrez et fermez le fichier.

Ensuite, exécutez la commande systemctl suivante pour démarrer le service Sensu Backend et l’activer. Le service Sensu Backend sera automatiquement en cours d’exécution au démarrage du système.

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

Vérifiez et vérifiez le service Sensu backend en utilisant la commande ci-dessous. Vous devriez voir que le service Sensu Backend est actuellement en cours d’exécution et activé.

sudo systemctl status sensu-backend

Après que le backend Sensu soit en cours d’exécution, vous allez maintenant initialiser l’installation et la configuration de Sensu Backend. Cela peut être fait en utilisant la ligne de commande “sensu-backend init”, qui est fournie par le package Sensu Backend.

De plus, lors de l’initialisation de Sensu Backend, vous allez configurer l’utilisateur admin et le mot de passe pour votre solution de surveillance Sensu.

Exécutez la commande suivante pour créer de nouvelles variables d’environnement système pour l’utilisateur admin Sensu et le mot de passe. Dans cet exemple, vous allez créer un nouvel utilisateur admin Sensu “ adminsensu “ avec le mot de passe “ SensuRocks “.

export SENSU_BACKEND_CLUSTER_ADMIN_USERNAME=adminsensu  
export SENSU_BACKEND_CLUSTER_ADMIN_PASSWORD=SensuRocks

Maintenant, commencez à initialiser le backend Sensu en utilisant la commande ci-dessous. Vous devriez voir le processus d’initialisation et Sensu stockera des données dans le magasin de données “etcd”.

sensu-backend init

Pour vérifier et valider votre installation de Sensu backend, vous effectuerez le contrôle de santé de Sensu via la commande curl vers l’API HTTP de Sensu qui fonctionne sur le port par défaut “8080”.

Exécutez la commande curl ci-dessous pour effectuer le contrôle de santé de votre installation de Sensu backend. Vous devriez voir le message de sortie sur votre écran de terminal tel que “ health: OK “.

curl http://127.0.0.1:8080/health

Vous pouvez également visiter le tableau de bord UI web de Sensu via le port TCP “ 3000 “. Ouvrez votre navigateur web et visitez l’adresse IP de votre serveur suivie du port 3000 (c’est-à-dire : http://192.168.5.100:3000). Et vous devriez voir la page de connexion Sensu.

Saisissez l’utilisateur admin “ adminsensu “ avec le mot de passe “ SensuRocks “. Ensuite, cliquez sur “ SIGN-IN “ pour vous connecter au tableau de bord UI web de Sensu.

Maintenant, vous devriez voir le tableau de bord d’administration web de Sensu.

Installation de la ligne de commande Sensuctl

Sur Sensu, l’administrateur peut gérer la solution de surveillance Sensu via le tableau de bord d’administration web Sensu et via le terminal de ligne de commande en utilisant “ sensuctl “.

Le “ sensuctl “ est un outil en ligne de commande pour gérer les ressources Sensu. Il utilise une API HTTP pour communiquer avec Sensu Backend, ce qui vous permet de créer, lire et supprimer des ressources, des événements et des entités.

Le “ sensuctl “ peut être installé sur plusieurs systèmes d’exploitation tels que Linux, Windows et macOS. La fonction de “sensuctl” est similaire à celle du tableau de bord UI web de Sensu, et vous pouvez l’installer sur votre station de travail locale ou sur le serveur “bastion” sécurisé de votre infrastructure.

Pour les systèmes basés sur Debian/Ubuntu, exécutez la commande apt suivante pour installer l’outil en ligne de commande “ sensuctl “. L’installation commencera automatiquement.

sudo apt install sensu-go-cli

Après que l’installation soit terminée, exécutez la commande “ sensuctl “ suivante pour commencer à configurer et à vous connecter à l’API du serveur Sensu Backend.

sensuctl configure

Vous serez invité à répondre aux configurations suivantes :

• Pour la méthode d’authentification, sélectionnez “nom d’utilisateur/mot de passe”.
• Saisissez l’URL de l’API Sensu Backend de votre serveur. Dans cet exemple, nous allons configurer “sensuctl” sur le même serveur, donc l’hôte sera localhost ou “127.0.0.1”. Et le port par défaut pour l’API HTTP de Sensu est “8080” - http://127.0.0.1:8080.
• Pour la configuration de l’espace de noms, sélectionnez “default”.
• Pour le format de sortie, vous pouvez sélectionner le style “tabulaire” ou utiliser le format de sortie “yaml”.
• Enfin, saisissez l’utilisateur admin et le mot de passe pour votre Sensu Backend.

Maintenant, vous avez terminé la configuration de base de “ sensuctl “ et vous êtes connecté au serveur API Sensu Backend.

Exécutez la commande “ sensuctl “ suivante pour vérifier votre configuration. Vous devriez voir les configurations API détaillées de “ sensuctl “.

sensuctl config view

De plus, le “sensuctl” fournit également une auto-complétion pour votre shell. Si vous utilisez bash, vous devez installer le package “bash-completion” et ajouter quelques configurations au fichier de configuration “ ~/.bashrc “.

Exécutez la commande apt suivante pour installer le package “bash-completion”.

sudo apt install bash-completion

Maintenant, éditez la configuration “~/.bashrc” en utilisant la commande suivante.

sudo nano ~/.bashrc

Ajoutez la configuration suivante au fichier.

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)

Lorsque vous avez terminé, enregistrez et fermez le fichier.

Ensuite, rechargez la session actuelle de votre shell en utilisant la commande ci-dessous.

source ~/.bashrc

Enfin, saisissez la commande “ sensuctl “ et appuyez sur le bouton TAB pour obtenir toutes les options de commande disponibles. Vous devriez obtenir toutes les options disponibles de la commande “ sensuctl “.

sensuctl TAB

Installation de Sensu Agent

Pour surveiller l’hôte ou la machine à l’aide de Sensu, vous devez installer le package Sensu Agent sur tous vos hôtes. Le Sensu Agent est disponible pour presque toutes les distributions Linux et Windows.

Pour installer Sensu Agent sur un système Linux, assurez-vous que le dépôt Sensu est ajouté.

Pour les systèmes basés sur Debian/Ubuntu, exécutez la commande apt suivante pour installer le package Sensu Agent. Maintenant, l’installation va commencer.

sudo apt install sensu-go-agent

Après que l’installation soit terminée, téléchargez la configuration de Sensu Agent dans “ /etc/sensu/agent.yml “. Ensuite, éditez la configuration “ /etc/sensu/agent.yml “ en utilisant la commande ci-dessous.

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

Décommentez les configurations suivantes. Assurez-vous de changer le “name” ici pour le nom d’hôte du système et le “ backend-url “ avec l’adresse IP du serveur Sensu Backend.

Dans cet exemple, nous allons ajouter une machine Debian avec le nom d’hôte “ linux-host1 “ et disponible dans l’espace de noms “ default “. Le serveur Sensu Backend ici est “ 192.168.5.100 “ avec le port API WebSocket par défaut de Sensu Backend “ 8081 “.

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

Lorsque vous avez terminé, enregistrez et fermez le fichier.

Ensuite, exécutez la commande suivante pour démarrer le service Sensu Agent et l’activer pour qu’il s’exécute automatiquement au démarrage du système.

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

Maintenant, exécutez la commande suivante pour vérifier et valider le service Sensu Agent. Vous devriez voir que le Sensu Agent est en cours d’exécution et activé.

sudo systemctl status sensu-agent

Ensuite, retournez à votre navigateur web et sélectionnez l’espace de noms “ default “. Et vous devriez voir le nouvel hôte d’entité “ linux-host1 “ disponible.

Vous pouvez également vérifier depuis la ligne de commande terminal en utilisant la commande “ sensuctl “ comme ci-dessous. Vous devriez voir l’agent “ linux-host1 “ ajouté à la solution de surveillance Sensu.

sensuctl entity list --format tabular

Surveiller les ressources du serveur avec des vérifications

Le Sensu Agent fonctionne pour fournir simplement un moyen pour le nœud agent ou le serveur cible de se connecter à Sensu Backend via l’API WebSocket. Pour surveiller les ressources du serveur telles que l’utilisation du CPU, l’utilisation de la bande passante et l’utilisation du disque, vous devrez configurer une “Subscription” et créer quelques “Check” par-dessus. Ensuite, vous pouvez ajouter plusieurs “Subscriptions” au Sensu Agent ou au serveur cible.

Pour surveiller les ressources du serveur à l’aide de Sensu, vous devrez suivre les étapes suivantes :

• Créer une Subscription
• Enregistrer les actifs d’exécution Sensu
• Définir les commandes de vérification pour vérifier les ressources système

Avant d’aller plus loin, exécutez la commande “sensuctl” suivante pour créer une nouvelle subscription nommée “ system “ pour l’entité “ linux-host1 “.

sensuctl entity update linux-host1

Vous serez invité à répondre aux questions suivantes :

• Pour la “Classe d’Entité”, laissez par défaut “ agent “ et appuyez sur ENTRER.
• Pour les “Subscriptions”, saisissez le nom de la subscription “ system “ et appuyez sur ENTRER.

Sur Sensu, les “ Checks “ définissent essentiellement une commande qui peut être utilisée pour surveiller les ressources du serveur. Les “ Checks “ sont la ligne de commande que vous pouvez définir sur les “Assets” et “Subscriptions” de Sensu pour tous vos besoins de surveillance. Pour créer des “ Checks “, vous allez configurer des actifs d’exécution dynamiques via la commande “sensuctl”. Tous les “Assets” Sensu peuvent être trouvés sur https://bonsai.sensu.io/.

Maintenant, exécutez la commande “ sensuctl “ ci-dessous pour créer et enregistrer des “Assets” Sensu pour surveiller l’utilisation du CPU. Vous devriez voir le message de sortie tel que “ajouté actif : sensu/check-cpu-usage:0.2.2”. Dans cet exemple, nous renommons également le nom par défaut de l’actif en “check-cpu-usage” avec l’option “-r”.

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

Maintenant, exécutez la commande suivante pour vérifier la liste des actifs Sensu. Vous devriez voir l’actif “ check-cpu-usage “ disponible sur Sensu.

sensuctl asset list

Ensuite, exécutez la commande suivante pour créer la commande “ Checks “ pour surveiller l’utilisation du CPU. Dans cet exemple, vous allez créer une nouvelle commande de vérification nommée “ check_cpu “ qui sera disponible sur la subscription “system” et basée sur l’actif “ check-cpu-usage “. Vous pouvez également changer le paramètre ici dans l’option “–command”. Et vous devriez obtenir le message de sortie tel que “ Créé “.

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

Exécutez la commande “ sensuctl “ suivante pour vérifier et valider le “ check_cpu “. Vous devriez voir les détails des “ Checks “ du “ check_cpu “ que vous venez de créer.

sensuctl check info check_cpu --format yaml

Maintenant, vous pouvez vérifier la surveillance de l’événement “ check_cpu “ en utilisant la commande ci-dessous. Vous devriez voir la surveillance de l’utilisation du CPU pour “ linux-host1 “ configurée et terminée.

sensuctl event list --format tabular

Maintenant, allez au tableau de bord d’administration Sensu et sélectionnez l’espace de noms “ default “. Dans le menu “ Entity “, vous devriez voir l’agent “ linux-host1 “ ajouté au système de surveillance Sensu.

Maintenant, si vous cliquez sur les détails de l’agent “ linux-host1 “, vous verrez les “ Checks “ surveillant “ check_cpu “ que vous venez de créer.

Ensuite, vous pouvez ajouter et créer plus de “Checks” pour votre système de surveillance.

Conclusion

Vous avez maintenant effectué l’installation de la solution de surveillance Sensu sur le serveur Debian 11. 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 le Sensu Agent et à configurer des “checks” pour surveiller votre serveur cible.