SSH (performances)

L'analyseur SSH utilise l'authentification SSH pour se connecter à un périphérique distant afin d'exécuter des commandes ou des scripts qui peuvent être intégrés à l'analyseur, ou placés dans un fichier script exécutable sur la machine distante avec une commande intégrée à l'analyseur permettant d'exécuter le script. Chaque analyseur renvoie une valeur numérique unique enregistrée dans la base de données, puis utilisée ultérieurement par d'autres fonctions de WhatsUp Gold, si nécessaire.

Saisissez un nom et une description uniques pour l'analyseur, puis configurez les paramètres suivants :

Commande à exécuter. Saisissez la commande à exécuter sur le périphérique distant. La commande peut être n'importe quel élément pouvant être interprété et exécuté par le périphérique, par exemple une commande shell UNIX ou un script perl. À noter que si vous créez un script à exécuter sur un périphérique distant, il doit être développé, testé et/ou débogué sur la machine distante. Sélectionnez l'une des options de script suivantes :
- Numeric (Numérique). La commande ou le script doit renvoyer une valeur numérique unique. Le script peut être aussi complexe que nécessaire, mais DOIT uniquement renvoyer une valeur numérique. Par exemple, l'ancienne syntaxe UNIX à ligne unique :
  free -m | awk 'NR==2{print $3}'
  Il s'agit du format de script obligatoire depuis WhatsUp Gold 16.2.3.
- Shell Interactive (Shell interactif). Ce script n'est pas limité au renvoi de valeurs numériques uniques, cependant, la sortie DOIT contenir la chaîne 'Result=xxxx', où xxxx représente une valeur numérique. Par exemple, le nouveau format Linux multilignes :
  echo Result=$(free -m | awk 'NR==2{print $3}')
  Ce format de script plus récent prend en charge toutes les fonctions des interpréteurs du script cible sans imposer au développeur de script de limiter la sortie à une valeur numérique unique.

Note: À compter de v18.0.2, l'option Interpréteur de commandes interactif prend en charge les expressions régulières personnalisées définies par l'utilisateur pour permettre à WhatsUp Gold de collecter avec succès les données de performance de plusieurs systèmes intégrés, notamment les routeurs, les commutateurs et les contrôleurs d'accès distants intégrés Dell (iDRAC). Pour activer cette fonctionnalité lors de la configuration d'un analyseur de performances SSH, cochez la case Utiliser une expression régulière personnalisée lorsque l'option Interpréteur de commandes interactif est sélectionnée.

Exemple : Expression régulière par défaut

Commande : <commande qui sort le résultat au format par défaut>

Sortie : Résultat=15

Lorsque l'expression régulière par défaut est exécutée avec cette sortie, elle correspond à Résultat=15. Le groupe de capture considère que le résultat vaut 15 , de sorte que WhatsUp Gold stocke cette valeur comme résultat de l'interrogation. L'expression régulière à l'intérieur du groupe de capture [0-9.,]+ correspond à n'importe quel nombre 0-9 ou plus, point décimal et virgule, bien que la valeur ne doive comporter qu'un point décimal ou une virgule pour être correctement analysée comme un nombre. Si la même expression régulière avait été exécutée avec Résultat=A33, elle ne correspondrait pas. Toutefois, Résultat=33A correspondrait à Résultat=33 et le groupe de capture considérerait 33 comme étant le résultat.

Exemple : Expression régulière personnalisée

Pour analyser l'utilisation de l'alimentation d'un Dell R710 (les statistiques spécifiques étant cfgServerPowerLastMinAvg) via l'interface de gestion iDRAC à l'aide de la commande suivante, « racadm getconfig -g cfgServerPower », saisissez l'expression régulière suivante. Veuillez noter que seules les lignes correspondantes de l'expression sont incluses ci-dessous.

# cfgServerPowerStatus=1

(coupé)

cfgServerPowerCapEnable=0

# cfgServerPowerLastMinAvg=357 AC W | 1218 Btu/hr

# cfgServerPowerLastHourAvg=359 AC W | 1225 Btu/hr

(tronqué pour des raisons de brièveté)

L'expression régulière utilisée dans cet exemple pour capturer la puissance moyenne utilisée au cours de la dernière minute est cfgServerPowerLastMinAvg=([\d]+) qui recherche cfgServerPowerLastMinAvg= suivi d'au moins un chiffre. La valeur qui est renvoyée comme résultat de l'interrogation est 357 car [\d]+ figure à l'intérieur du groupe de capture (). À noter que l'expression régulière spécifiée DOIT comprendre un groupe de capture () pour renvoyer le résultat de l'interrogation à WhatsUp Gold.

L'analyseur n'utilise que la dernière correspondance qu'il trouve dans la sortie. Même si la commande exécutée envoie des milliers de résultats , WhatsUp Gold n'enregistre que la dernière correspondance. Vous pouvez trouver des informations complémentaires sur les options d'expressions régulières par défaut .Net ici.

Dans l'éventualité où WhatsUp Gold ne parviendrait pas à trouver une correspondance lors du traitement de l'expression régulière pour la valeur renvoyée, le journal des erreurs de performance contiendrait la sortie brute reçue du périphérique. Vous pouvez utiliser ces informations pour résoudre les problèmes du modèle d'expression régulière spécifiée dans la configuration de l'analyseur.

Line end character (Caractère de fin de ligne). Sélectionnez le type de fin de ligne approprié : None (Aucun), Linefeed (Saut de ligne), Carriage return (Retour chariot) ou Carriage return linefeed (Saut de ligne avec retour chariot). Les scripts multilignes sont saisis et conservés sur un système d'exploitation Windows et incluent des caractères de fin de ligne qui peuvent ne pas être reconnus sur le périphérique cible. Cette fonction de configuration indique à WhatsUp Gold de remplacer les caractères de fin de ligne par les caractères sélectionnés avant la connexion et l'exécution de la commande.