Aller au contenu principal

Linux SSH

Vue d'ensemble​

Linux est une famille de systèmes d'exploitation à source ouverte de type Unix basée sur le noyau Linux, un noyau de système d'exploitation publié pour la première fois le 17 septembre 1991 par Linus Torvalds.

Contenu du Plugin-Pack​

Objets supervisés​

Ce Plugin-Pack est compatible avec n'importe quelle distribution Linux avec un daemon SSH installé :

  • Serveur
  • Centos
  • Redhat
  • Debian
  • Ubuntu
  • Fedora
  • Suse

Métriques collectées​

Metric nameDescription
cpu.utilization.percentageCPU utilization. Unit: %
core.cpu.utilization.percentageCPU utilization by core. Unit: %

Prérequis​

Configuration SSH​

Un simple utilisateur est nécessaire pour interroger le système d'exploitation Linux par SSH. Il n'est pas nécessaire d'avoir des privilèges root ou sudo. Il y a deux façons possibles d'effectuer la vérification SSH, soit en échangeant la clé SSH de centreon-engine au serveur cible, ou en définissant votre utilisateur et votre mot de passe directement dans les macros hôtes.

Ajouter et générer un mot de passe pour votre utilisateur sur le Serveur Cible :

adduser ro_ssh_centreon
passwd ro_ssh_centreon

Basculer vers l'environnement bash de centreon-engine sur votre serveur Central et sur Poller :

su - centreon-engine

Ensuite, copier cette clé sur le Serveur cible avec les commandes suivantes :

ssh-keygen -t ed25519 -a 100
ssh-copy-id -i .ssh/id_ed25519.pub ro_ssh_centreon@<IP_TARGET_SERVER>

Installation​

  1. Installer le Plugin sur tous les collecteurs Centreon supervisant des ressources Linux SSH :
yum install centreon-plugin-Operatingsystems-Linux-Ssh.noarch
  1. Sur l'interface Web de Centreon, installer le Plugin-Pack Linux SSH depuis la page "Configuration > Plugin packs > Manager"

Configuration​

Créer un nouvel hôte dans Centreon et lui appliquer le modèle d'hôte "OS-Linux-SSH-custom". Une fois le modèle défini, vous devez définir des valeurs en fonction du backend SSH choisi. 3 backends SSH sont disponibles pour se connecter au serveur Linux : sshcli, plink et libssh qui sont détaillés ci-dessous.

MandatoryNameDescription
XSSHBACKENDNom du backend: sshcli
XSSHUSERNAMEPar default, il utilise l'utilisateur en cours d'exécution centengine de votre collecteur
SSHPASSWORDNe peut pas être utilisé avec le backend. Seulement avec la clé d'authentication
SSHPORTPar default: 22
SSHEXTRAOPTIONSPersonnalisez-le avec le vôtre si nécessaire. E.g.: --ssh-priv-key=/user/.ssh/id_rsa

Avec ce backend, il est nécessaire d'effectuer une connexion manuelle entre l'utilisateur centreon-engine du Collecteur et l'utilisateur applicatif créé sur le serveur Linux. (Macro SSHUSERNAME).

FAQ​

Comment vérifier en ligne de commande que la configuration est correcte et quelles sont les principales options ?​

Une fois le Plugin installé, connectez-vous à votre poller en utilisant le compte utilisateur centreon-engine et testez en lançant la commande suivante :

 /usr/lib/centreon/plugins//centreon_linux_ssh.pl \
      --plugin=os::linux::local::plugin \
      --mode=cpu \
      --hostname='10.30.2.114' \
      --ssh-backend='libssh' \
      --ssh-username='centreon' \
      --ssh-password='centreon-password' \
      --ssh-port='22' \
      --warning-core='60' \
      --critical-core='70' \
      --warning-average='60' \
      --critical-average='75' \
      --verbose \
      --use-new-perfdata    
    
OK: CPU(s) average usage is 11.91 % - CPU '0' usage : 11.91 % |
'cpu.utilization.percentage'=11.91%;;;0;100 '0#core.cpu.utilization.percentage'=11.91%;;;0;100 
CPU '0' usage : 11.91 %

La commande ci-dessus supervise la moyenne d'un CPU d'un équipement en utilisant SSH (--mode=CPU). Il y a pour adresse 10.30.2.114 (--hostname=10.30.2.114) comme Backend SSH (--ssh-backend='libssh') avec les centreon comme username centreon (--ssh-username=centreon) et comme mot de passe centreon-password (--ssh-password='centreon-password').

Cette commande déclenchera une alarme WARNING si la moyenne du CPU augmente à plus de 60% (--warning-average='60') et une alarme CRITICAL si plus de 75% (--critical-average='75'). Des seuils peuvent être fixés sur toutes les métriques de l'appareil en utilisant la syntaxe "--warning-*metric* --critical-*metric*".

Toutes les options qui peuvent être utilisées avec ce plugin se trouvent sur la commande --help :

/usr/lib/centreon/plugins//centreon_linux_ssh.pl --plugin=os::linux::local::plugin
--mode=cpu --help

J'ai ce message d'erreur : UNKNOWN: Command error: Host key verification failed.. Qu'est-ce que cela signifie ?​

Cela signifie que vous n'avez pas validé manuellement la signature (fingerprint) du serveur cible avec ssh or plink sur le Poller Centreon.