Contexte

Le pack linux_by_ssh permet de superviser, en utilisant le protocole SSH, des hôtes utilisant le système d'exploitation Linux ( serveur ou client ).

  • Il vous permet d'interroger :
    • le matériel ( CPU, mémoire, Disk, Load, Uptime ),
    • son utilisation ( Connections refusés, Utilisations du réseau, Connexion TCP, Système de fichier, Statistics du Kernel, Processus Actifs ou le suivi d'un process en particulier ),
    • sa configuration ( Synchronisation a un serveur de Temps, configuration du SSH ),
    • et la présence de fichiers ( vérifier la présence d'une licence par exemple )
  • Les commandes utilisent plusieurs sondes écris en RUST qui seront présentes dans le répertoire des sondes Shinken /var/lib/shinken/libexec ( ou $PLUGINSDIR$ depuis l'interface de configuration ), aprés la mise en place du pack.


Il contient les modèles d'hôtes suivant pour la supervision d'un Linux :
  • linux_by_ssh qui permet la supervision d'un linux pour une utilisation minimal ( load average, uptime... ).
  • linux_by_ssh_advanced qui permet la supervision d'un linux pour une utilisation avancée et fournit des informations supplémentaires ( statistiques du kernel, statistiques des disques... ).
  • linux_by_ssh_extra qui fournit des checks supplémentaire pour une supervision plus spécifique ( consommation mémoire d'un process, présence d'un fichier... ).

Toutes les commandes de ce pack se basent sur des scripts présents dans le répertoire des scripts shinken /var/lib/shinken-user/libexec/linux_by_ssh/ ( ou $USERPLUGINSDIR$ depuis l'interface de configuration ).

Le protocole SSH ( Secure Shell ) est utilisé par chacun des scripts du pack linux. Les scripts communiqueront avec votre machine directement par un invite de commande après s'être connecté avec les identifiants SSH que vous aurez paramétré.

Comment utiliser son pack ?

Il faut avant tout que vous mettiez en place le pack ( Page NEW_PAGE - 004.0 - SEF-10821 - Mise en place du Pack linux_by_ssh ).

  • Le pack linux_by_ssh peut être utilisé en appliquant les 3 modèles d'hôtes mise à disposition en fonction de votre besoin .

En utilisant l'interface de Configuration

Créez ou éditez un Hôte, et ajoutez le modèle "linux_by_ssh", "linux_by_ssh_advanced" ou "linux_by_ssh_extra" grâce au menu déroulant ( Page Editer un Hôte )

En éditant les fichiers de configuration ( cfg )

Dans un fichier de configuration, créez ou éditez votre définition d'hôte en ajoutant, dans la propriété "use", la valeur "linux_by_ssh", "linux_by_ssh_advanced" ou "linux_by_ssh_extra" selon les besoins.

Le fichier de configuration devra alors être importé avec une source ( voir la page Collecteur de type ( cfg-file-import ) - Import depuis des fichiers au format .cfg ).

Listes des modèles à utiliser dans le pack

NomLien
linux_by_sshNEW_PAGE - 004.0 - SEF-10821 - Modèle linux_by_ssh
linux_by_ssh_advancedNEW_PAGE - 004.0 - SEF-10821 - Modèle linux_by_ssh_advanced
linux_by_ssh_extraNEW_PAGE - 004.0 - SEF-10821 - Modèle linux_by_ssh_extra

Personnaliser son pack

Vous pouvez modifier le pack pour un besoin spécifique.
  • XXXX.

( voir la page NEW_PAGE - 004.0 - SEF-10821 - Personnaliser son Pack linux_by_ssh ).

Version des sondes livrés

Nom

VersionDescription
CPU Stats SSH
2.0.0-RC001Récupère des informations sur le CPU comme le nombre de cœur, la fréquence, le pourcentage d'utilisation du processeur et les processus les plus consommateurs
Disks Usage SSH
2.0.0-RC001Analyse les les partions et indique si l'espace libre est suffisant
Load Average SSH
2.0.0-RC001Analyse la charge système de la dernière minute, des 5 dernières minutes et des 15 dernières minutes et vous avertit si la charge dépasse un certain seuil
Memory SSH
2.0.0-RC001Récupère les informations de la mémoire et vive et de la mémoire SWAP. Retourne la consommation mémoire et les 5 processus les plus consommateurs
NtpSync SSH
2.0.0-RC001Vérifie la date et l'heure du système en se synchronisant avec un server de temps NTP ou Chrony selon votre choix
Uptime SSH
2.0.0-RC001Vérifie la date du dernier redémarrage de la machine
Connection Failed SSH
2.0.0-RC001Récupère et analyse les tentatives de connections échouées sur votre serveur
Disks Stats SSH
2.0.0-RC001Récupère les statistiques des disques pour les renvoyer sous forme de métriques
Kernel Stats SSH
2.0.0-RC001Récupère les statistiques du kernel pour les renvoyer sous forme de métriques
NET Stats SSH
2.0.0-RC001Récupère les statistiques réseaux pour les renvoyer sous forme de métriques
NFS Stats SSH
2.0.0-RC001Récupère les statistiques NFS pour les renvoyer sous forme de métriques
Processes Memory SSH
2.0.0-RC001Vérifie l'utilisation de la mémoire ram RSS (Resident Set Size) de chaque processus
Read-only FileSystem SSH
2.0.0-RC001Vérifie si un fichier système est en lecture seule
Security SSH
2.0.0-RC001Vérifie les paramètres SSH de l'hôte et les compare avec ceux définis dans la configuration
TCP States SSH
2.0.0-RC001Récupère les statistiques des ports TCP pour les renvoyer sous forme de métriques
Existing File SSH
2.0.0-RC001Vérifie la présence ou l'absence d'un fichier ou d'un dossier sur votre machine
Process SSH
2.0.0-RC001Vérifie l'utilisation de la mémoire d'un processus en particulier
Unused Load Average SSH
2.0.0-RC001Analyse la charge système de la dernière minute, des 5 dernières minutes et des 15 dernières minutes et vous avertit si la charge passe en dessous d'un certain seuil