Section courante

A propos

Section administrative du site

check_by_ssh

Vérifie par SSH
Nagios

Syntaxe

check_by_ssh -H host -C command [-fqv] [-1|-2] [-4|-6] [-S [lines]] [-E [lines]] [-t timeout] [-i identity] [-l user] [-n name] [-s servicelist] [-O outputfile] [-p port] [-o ssh-option] [-F configfile]

Paramètres

Nom Description
-1 Ce paramètre permet d'indiquer à ssh d'utiliser le protocole 1. Ce paramètre est facultatif.
-2 Ce paramètre permet d'indiquer à ssh d'utiliser le protocole 2. Ce paramètre est facultatif.
-4 Ce paramètre permet d'utiliser la connexion IPv4.
-6 Ce paramètre permet d'utiliser la connexion IPv6.
-C='COMMAND STRING' Ce paramètre permet d'indiquer que la commande à exécuter sur une machine à distance.
-c=DOUBLE Ce paramètre permet d'indiquer le temps de réponse pour aboutir à un état critique (secondes).
--command='COMMAND STRING' Ce paramètre permet d'indiquer que la commande à exécuter sur une machine à distance.
--configfile Ce paramètre permet d'indiquer à ssh d'utiliser ce fichier de configuration. Ce paramètre est facultatif.
--critical=DOUBLE Ce paramètre permet d'indiquer le temps de réponse pour aboutir à un état critique (secondes).
-E[=n] Ce paramètre permet d'ignorer toutes ou (si spécifié) les n premières lignes sur STDERR. Ce paramètre est facultatif.
--extra-opts=[section][@file] Ce paramètre permet de lire les options à partir d'un fichier ini.
-F Ce paramètre permet d'indiquer à ssh d'utiliser ce fichier de configuration. Ce paramètre est facultatif.
-f Ce paramètre permet d'indiquer à ssh de bifurquer plutôt que de créer un tty (facultatif). Il retournera toujours OK si ssh est exécuté.
-H=ADDRESS Ce paramètre permet d'indiquer le nom d'hôte, adresse IP ou socket Unix (doit être un chemin absolu).
-h Ce paramètre permet d'afficher l'écran d'aide détaillé sur cette commande.
--help Ce paramètre permet d'afficher l'écran d'aide détaillé sur cette commande.
--hostname=ADDRESS Ce paramètre permet d'indiquer le nom d'hôte, adresse IP ou socket Unix (doit être un chemin absolu).
-i=KEYFILE Ce paramètre permet d'indiquer l'identité d'une clef autorisée. Ce paramètre est facultatif.
--identity=KEYFILE Ce paramètre permet d'indiquer l'identité d'une clef autorisée. Ce paramètre est facultatif.
-l=USERNAME Ce paramètre permet d'indiquer le nom d'utilisateur SSH sur l'hôte à distance. Ce paramètre est facultatif.
--logname=USERNAME Ce paramètre permet d'indiquer le nom d'utilisateur SSH sur l'hôte à distance. Ce paramètre est facultatif.
-n=NAME Ce paramètre permet d'indiquer le nom court de l'hôte dans la configuration Nagios. Ce paramètre est facultatif.
--name=NAME Ce paramètre permet d'indiquer le nom court de l'hôte dans la configuration Nagios. Ce paramètre est facultatif.
-O=FILE Ce paramètre permet d'indiquer le fichier de commande externe pour Nagios. Ce paramètre est facultatif.
-o=OPTION Ce paramètre permet d'indiquer l'appeler ssh avec '-o OPTION' (peut être utilisé plusieurs fois). Ce paramètre est facultatif.
--output=FILE Ce paramètre permet d'indiquer le fichier de commande externe pour Nagios. Ce paramètre est facultatif.
-p=INTEGER Ce paramètre permet d'indiquer le numéro de port. La valeur par défaut est none.
--port=INTEGER Ce paramètre permet d'indiquer le numéro de port. La valeur par défaut est none.
--proto1 Ce paramètre permet d'indiquer à ssh d'utiliser le protocole 1. Ce paramètre est facultatif.
--proto2 Ce paramètre permet d'indiquer à ssh d'utiliser le protocole 2. Ce paramètre est facultatif.
-q Ce paramètre permet d'indiquer à ssh de supprimer les messages d'avertissement et de diagnostic. Ce paramètre est facultatif.
--quiet Ce paramètre permet d'indiquer à ssh de supprimer les messages d'avertissement et de diagnostic. Ce paramètre est facultatif.
-S[=n] Ce paramètre permet d'ignorer toutes ou (si spécifié) les n premières lignes sur STDOUT. Ce paramètre est facultatif.
-s=LIST Ce paramètre permet d'indiquer la liste des noms de service Nagios, séparés par ":". Ce paramètre est facultatif.
--services=LIST Ce paramètre permet d'indiquer la liste des noms de service Nagios, séparés par ":". Ce paramètre est facultatif.
--skip-stderr[=n] Ce paramètre permet d'ignorer toutes ou (si spécifié) les n premières lignes sur STDERR. Ce paramètre est facultatif.
--skip-stdout[=n] Ce paramètre permet d'ignorer toutes ou (si spécifié) les n premières lignes sur STDOUT. Ce paramètre est facultatif.
--ssh-option=OPTION Ce paramètre permet d'indiquer l'appeler ssh avec '-o OPTION' (peut être utilisé plusieurs fois). Ce paramètre est facultatif.
-t=INTEGER:timeoutstate Ce paramètre permet d'indiquer les secondes avant l'expiration de la connexion. La valeur par défaut est 10. Le paramètre facultatif est timeoutstate peut être un entier d'état (0,1,2,3) ou un état STRING.
--timeout=INTEGER:timeoutstate Ce paramètre permet d'indiquer les secondes avant l'expiration de la connexion. La valeur par défaut est 10. Le paramètre facultatif est timeoutstate peut être un entier d'état (0,1,2,3) ou un état STRING.
--use-ipv4 Ce paramètre permet d'utiliser la connexion IPv4.
--use-ipv6 Ce paramètre permet d'utiliser la connexion IPv6.
-V Ce paramètre permet d'afficher les informations sur la version.
-v Ce paramètre permet d'afficher les détails du débogage en ligne de commande (Nagios peut tronquer la sortie).
--verbose Ce paramètre permet d'afficher les détails du débogage en ligne de commande (Nagios peut tronquer la sortie).
--version Ce paramètre permet d'afficher les informations sur la version.
-w=DOUBLE Ce paramètre permet d'indiquer le temps de réponse pour générer un état d'avertissement (secondes).
--warning=DOUBLE Ce paramètre permet d'indiquer le temps de réponse pour générer un état d'avertissement (secondes).

Description

Cette commande permet d'utiliser SSH pour exécuter des commandes sur un hôte à distance.

Remarques

Exemple

L'exemple suivant permet d'exécuter trois commandes à distance uptime et de retourner le résultat dans /tmp/gladir :

check_by_ssh -H localhost -n lh -s c1:c2:c3 -C uptime -C uptime -C uptime -O /tmp/gladir


Dernière mise à jour : Jeudi, le 25 Mars 2021