Sommaire

Contexte

Le check Stats TCP SSH va récupérer les états de vos ports TCP 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.

Paramétrage

Le check utilise la ligne de commande suivante :

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

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é.

Données utilisées provenant du check

Pas de données spécifiques pour ce check

Résultat

Interprétation des données

Statut

Le statut peut prendre 2 valeurs différentes  OK  /  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
CLOSE--Nombre de ports sans connexion.----
CLOSE_WAIT--Nombre de ports en attente d'une demande de fin de connexion venant d'un utilisateur local.----
CLOSING--Nombre de ports en attente d'une confirmation de fin de connexion d'un hôte TCP.----
ESTABLISHED--Nombre de ports prêt à transmettre et recevoir des données.----
FIN_WAIT1--Nombre de ports en attente d'une réponse à la demande de fin de connexion.----
FIN_WAIT2--Nombre de ports en attente d'une demande de fin de connexion du TCP distant.----
LAST_ACK--Nombre de ports en attente d'une confirmation après avoir envoyé un FIN.----
LISTEN--Nombre de ports attendant une demande de connexion.----
SYN_RECV--Nombre de ports en attente de confirmation après avoir été en SYN_SENT.----
SYN_SENT--Nombre de ports en attente d'une réponse après une demande de connexion.----
TIME_WAIT--Nombre de ports en attente pour une durée suffisante pour être sûr que l'hôte TCP a reçu la confirmation de sa demande de fin de connexion.----

Exemple

Les Erreurs

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