Aller au contenu principal

Protocole SSH

Vue d'ensemble​

Le protocole Secure Shell (SSH) est un protocole de communication sécurisé permettant d'effectuer des actions sur un serveur distant.

Le connecteur de supervision Centreon Protocol SSH permet de récupérer le status et le temps de réponse d'une connexion à un serveur par l'intermédiaire du protocole SSH.

Contenu du Pack​

Objets supervisés​

  • Serveur SSH

Métriques & statuts collectés​

Metric nameDescriptionUnit
statusLogin status
response.time.secondsLogin response timeseconds

Prérequis​

To use this pack, the SSH service must be properly configured on your server and the mandatory Host Macros must be properly configured. More info in the "Configuration" section here.

Afin de superviser le serveur SSH, le service doit être configuré et les Macro d'hôtes doivent être renseignées. Plus d'information dans le chapite "Configuration" ici.

Installation​

  1. Installer le Plugin Centreon sur tous les collecteurs Centreon devant superviser des serveurs SSH:
yum install centreon-plugin-Applications-Protocol-Ssh
  1. Sur l'interface Integration de Centreon, installer le connecteur de supervision Protocol SSH depuis la page Configuration > Gestionnaire de connecteurs de supervision

Configuration​

Hôte​

  • Ajoutez un Hôte à Centreon depuis la page "Configuration > Hôtes".
  • Complétez les champs "Nom","Alias" & "IP Address / DNS" correspondant à votre serveur SSH
  • Appliquez le Modèle d'Hôte Applications-Protocol-Ssh-custom
  • Une fois le modèle appliqué, les Macros ci-dessous indiquées comme requises(Mandatory) doivent être renseignées
MandatoryNameDescription
XPROTOCOLSSHPASSWORD
XPROTOCOLSSHUSERNAME
EXTRAOPTIONSAny extra option you may want to add to every command_line (eg. a --verbose flag)

Comment puis-je tester le Plugin et que signifient les options des commandes ?​

Une fois le Plugin installé, vous pouvez tester celui-ci directement en ligne de commande depuis votre collecteur Centreon en vous connectant avec l'utilisateur centreon-engine:

 /usr/lib/centreon/plugins//centreon_protocol_ssh.pl  \
--plugin=apps::protocols::ssh::plugin \
--mode=login \
--hostname=10.0.0.1 \
--ssh-username='' \
--ssh-password='' \
--warning-status='' \
--critical-status='%{message} !~ /authentification succeeded/i' \
--warning-time='2' \
--critical-time='3' \
--use-new-perfdata

La commande devrait retourner un message de sortie similaire à :

OK : authentification succeeded | 'response.time.seconds'=1s;;;; 

Dans cet exemple, une alarme de type WARNING sera déclenchée si le temps de réponse de l'identification est supérieure à 2 secondes (--warning-time='2'); l'alarme sera de type CRITICAL au-delà de 3 secondes (--warning-time='3') ou si le status de l'identification est différent de "authentification succeeded" (--critical-status='%{message} !~ /authentification succeeded/i').

/usr/lib/centreon/plugins//centreon_protocol_ssh.pl  \
--plugin=apps::protocols::ssh::plugin \
--mode=login \
--help

Tous les modes disponibles peuvent être affichés en ajoute le paramètre --list-mode à la commande:

/usr/lib/centreon/plugins//centreon_protocol_ssh.pl  \
--plugin=apps::protocols::ssh::plugin \
--list-mode

Diagnostic des erreurs communes​

UNKNOWN: Command error: Host key verification failed.​

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