Contexte
Le check File Matching $KEY$ Exists by SSH permet de rechercher le fichier ou le répertoire que vous lui avez fourni en paramètre, et vérifie si celui-ci est bien existant.
Paramétrage
Le check utilise la ligne de commande suivante :
$LINUXBYSSH_SHINKEN_PLUGINSDIR$/check_linux_health_by_ssh_rust --check check_existing_file
-H "$HOSTADDRESS$"
-u "$_HOSTSSH_USER$"
-p "$_HOSTSSH_PORT$"
-i "$_HOSTSSH_KEY$"
-P "$_HOSTSSH_KEY_PASSPHRASE$"
-f "$ARG1$"
-a "$_HOSTFILE_MISSING$"
Données DFE ( Duplicate Foreach )
| Donnée | Description | Exemple |
|---|---|---|
FILE_TO_CHECK | Définit le chemin absolu vers les fichier ou le répertoires que le check doit rechercher | Password$(/etc/passwd)$ |
Données utilisées provenant du modèle
Données communes pour les checks des modèles
Authentification
| Nom | Modifiable sur | Unité | Défaut | Valeur par défaut à l'installation de Shinken | Description |
|---|---|---|---|---|---|
SSH_KEY | l'Hôte ( Onglet Données ) | -- | $SSH_KEY_KEY$ | ~/.ssh/id_rsa | Chemin vers la clé SSH privé de l'utilisateur shinken, sur le serveur hébergeant le Poller qui exécutera le check.
|
SSH_KEY_PASSPHRASE | l'Hôte ( Onglet Données ) | -- | $SSH_KEY_PASSPHRASE$ | '' | Phrase secrète utilisée pour déchiffrer la clé privée de l'utilisateur ( si celle-ci est protégée par une passphrase ). La clé privée déchiffré est ensuite utilisée pour authentifier l'utilisateur. |
SSH_PORT | l'Hôte ( Onglet Données ) | -- | $SSH_PORT$ | 22 | Port de connexion SSH. |
SSH_USER | l'Hôte ( Onglet Données ) | -- | $SSH_USER$ | shinken | Nom de l'utilisateur pour se connecter sur le serveur supervisé. |
Données spécifiques pour ce check
| Donnée | Description | Valeur par défaut |
|---|---|---|
FILE_MISSING | Permet de vérifier si un fichier est disponible ou non | False |
Données utilisées provenant du check
Pour utiliser ce check il vous faudra tout d'abord définir une paire KEY$(VALUE)$ dans la donnée PROCESSES_TO_CHECK. Cette donnée est une donnée DFE (Duplicate Foreach), on peut donc chainer plusieurs paires KEY$(VALUE)$.
Exemple
Résultat
Exemple
Interprétation des données
Statut
Il peut prendre trois valeurs OK / CRITIQUE / INCONNU
Situation | Statut | Exemple |
|---|---|---|
| OK |
|
| CRITIQUE |
|
| CRITIQUE |
|
| OK |
|
Résultat
Le résultat contient un message donnant des informations sur le statut du fichier.
Résultat long
Pas de résultat long.
Métriques
Aucune métrique n'est renvoyée pour ce check
Les Erreurs
La connexion a échoué, car la paire utilisateur / clef public n'est pas reconnu par l'hôte supervisée. Résolution : Possibles raisons : La clef privée configurée par la donnée SSH_KEY n'existe pas. Le mot de passe pour déchiffrer la clef privé n'est pas correct. Résolution : Vérifier la donnée SSH_KEY_PASSPHRASE. La résolution DNS a échoué. Résolution : La résolution DNS a échoué. Résolution :Erreurs de connexion ( communes à tous les checks )
UNKNOWN – Username/PublicKey combination invalid
UNKNOWN – Unable to extract public key from private key file : Unable to open private key file
UNKNOWN – Unable to extract public key from private key file : Wrong passphrase or invalid/unrecognized private key file format
UNKNOWN – Connection refused (os error 111)
Vérifier l'adresse ou le nom utilisé pour se connecter à l'hôteUNKNOWN – Name or service not known
Vérifier l'adresse ou le nom utilisé pour se connecter à l'hôte