Sommaire

Contexte

Le check Stats NFS SSH va récupérer les statistiques de votre NFS pour vous les renvoyer sous forme de métriques visibles dans l'interface de Visualisation.

Ce check ne possède que deux statuts : OK / INCONNU, vous indiquant si les données ont bien été récupérées.


Le check calcule des moyennes par rapports aux mesures de ses dernières exécutions. Alors, l'intervalle d'exécution du check va affecter la période sur laquelle ces moyennes sont calculées.

  • Un intervalle d'exécution rapide donnera des moyennes plus volatiles, où il sera plus facile d'observer des pics.
  • Un intervalle d'exécution lent donnera des moyennes plus lissées.

Paramétrage

Le check utilise la ligne de commande suivante :

$LINUXBYSSH_SHINKEN_PLUGINSDIR$/check_linux_health_by_ssh_rust --check check_nfs_stats
    -H "$HOSTADDRESS$" 
    -u "$_HOSTSSH_USER$"
    -p "$_HOSTSSH_PORT$"
    -i "$_HOSTSSH_KEY$" 
    -P "$_HOSTSSH_KEY_PASSPHRASE$"
    -T "$_HOSTSHINKEN_TMP_DIRNAME$"

Données utilisées provenant du modèle

Données communes pour les checks des modèles

Authentification

NomModifiable surUnitéDéfautValeur par défaut à l'installation de ShinkenDescription
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. 

  • Cette clé doit être présente dans les clefs autorisées du compte utilisateur utilisé pour se connecter sur le serveur linux supervisé ( voir la donnée SSH_USER si dessous ).
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é.

Fichiers temporaires
NomModifiable surUnitéDéfautValeur par défaut à l'installation de ShinkenDescription
SHINKEN_TMP_DIRNAME

l'Hôte

( Onglet Données )

--shinken    shinken

Nom de dossier temporaire où seront stockés les fichiers temporaires générés par les sondes.

Ne peut contenir uniquement des caractères alphanumériques.

Le dossier est généré dans /tmp.

Données utilisées provenant du check

Pas de données spécifiques pour ce check

Résultat


Interprétation des résultats

Statut

Le statut peut prendre 2 valeurs différentes  OK  /  INCONNU.

SituationStatusExemple
  • Pas de serveur NFS detecté sur la machine
INCONNU  

  • Le check est lancé pour la première fois
INCONNU  

Résultat

Le résultat contient un message indiquant le statut du check.

Résultat long

Pas de résultat long.

Métriques

Définition

Nom de la métriqueUnitéDescriptionSeuil d'avertissementSeuil critique
RB_by_sB/s

Quantité de données lues par seconde

--

--

WB_by_sB/s

Quantité de données écrites par seconde

--

--

proc2_R_by_s--

Nombre de lectures par seconde ( NFS version 2 ).

--

--

proc2_W_by_s--

Nombre d'écritures par seconde ( NFS version 2 ).

--

--

proc3_R_by_s--

Nombre de lectures par seconde ( NFS version 3 ).

--

--

proc3_W_by_s--

Nombre d'écritures par seconde ( NFS version 3 ).

--

--

proc4_R_by_s--

Nombre de lectures par seconde ( NFS version 4 ).

--

--

proc4_W_by_s--

Nombre d'écritures par seconde ( NFS version 4 ).

--

--

Exemple

Les Erreurs

Erreurs spécifiques à ce check

MONITORED HOST - BAD STATE – Permission denied

L'utilisateur de supervision nécessite les droits de lecture et d'écriture dans le dossier /tmp ( SHINKEN_TMP_DIRNAME ).


Résolution


Les commandes suivantes vont donner les permissions nécessaires.

Remarque

Cette série de commandes ne peut être effectuée qu'en ayant les droits root.

Donc en étant connecté au compte root ou en ayant fait la commande "su" au préalable.

Utilisation
shinken_tmp_dirname="shinken"
mkdir --parents /tmp/$shinken_tmp_dirname
chown root:user-service-shinken /tmp/$shinken_tmp_dirname
chmod g+rwx /tmp/$shinken_tmp_dirname


 1.  La commande mkdir --parents /tmp/$shinken_tmp_dirname crée un récursivement un répertoire.

  • Le répertoire créé est /tmp/shinken.
  • Si vous voulez changer le dossier de stockage des fichiers temporaire, modifiez la première ligne : shinken_tmp_dirname="NouveauDossier" ainsi que la donnée SHINKEN_TMP_DIRNAME attaché au modèle d'hôte.

2. La commande chown root:user-service-shinken /tmp/shinken modifie le groupe du dossier /tmp/shinken.

  • Cela garantit que des droits peuvent être appliqués au groupe shinken sur ce dossier.

3. La commande chmod g+rwx /tmp/shinken applique immédiatement les droits nécessaires au dossier /tmp/shinken pour le groupe user-service-shinken.

  • Les droits de lecture, d'écriture et d'exécution sont ajoutés au dossier. Cela permet aux sondes de créer et lire des fichiers dans le dossier /tmp/shinken.

Erreurs de connexion ( communes à tous les checks )

UNKNOWN – Username/PublicKey combination invalid

La connexion a échoué, car la paire utilisateur / clef public n'est pas reconnu par l'hôte supervisée.


Résolution :


Possibles raisons :

  • L'utilisateur utilisé n'existe pas
  • La paire utilisateur / clef public n'est pas autorisé pour se connecter sur la machine supervisée.

UNKNOWN – Unable to extract public key from private key file : Unable to open private key file


La clef privée configurée par la donnée SSH_KEY n'existe pas.


UNKNOWN – Unable to extract public key from private key file : Wrong passphrase or invalid/unrecognized private key file format


Le mot de passe pour déchiffrer la clef privé n'est pas correct.


Résolution :


Vérifier la donnée SSH_KEY_PASSPHRASE.

UNKNOWN – Connection refused (os error 111)

La résolution DNS a échoué.


Résolution :


Vérifier l'adresse ou le nom utilisé pour se connecter à l'hôte

UNKNOWN – Name or service not known

La résolution DNS a échoué.


Résolution :


Vérifier l'adresse ou le nom utilisé pour se connecter à l'hôte