SSH (Leistung)

Der SSH-Monitor stellt via SSH-Authentifizierung eine Verbindung zu einem Remote-Gerät her, um auf diesem Gerät Befehle oder Skripte auszuführen. Die Skripte können entweder im Monitor eingebettet sein oder sich als ausführbare Skriptdateien auf dem Remote-Computer befinden und über einen im Monitor eingebetteten Befehl ausgeführt werden. Jeder Monitor gibt einen einzelnen numerischen Wert zurück, der in der Datenbank gespeichert und später – bei Bedarf – von anderen WhatsUp Gold-Funktionen verwendet wird.

Geben Sie einen eindeutigen Namen und eine Beschreibung für den Monitor ein und konfigurieren Sie dann Folgendes:

Auszuführender Befehl. Geben Sie den Befehl ein, der auf dem Remote-Gerät ausgeführt werden soll. Bei dem Befehl kann es sich um jeden Befehl handeln, der vom Remote-Gerät interpretiert und ausgeführt werden kann (z. B. ein UNIX-Shell-Befehl oder ein Perl-Skript). Skripte, die zur Ausführung auf Remote-Geräten erstellt werden, müssen auf den betreffenden Geräten entwickelt, getestet und/oder von Fehlern bereinigt werden. Wählen Sie eine der folgenden Skript-Optionen aus:
- Numerisch. Der Befehl bzw. das Skript muss einen einzelnen numerischen Wert zurückgeben. Das Skript darf so komplex wie nötig sein, darf jedoch NICHTS ANDERES als einen numerischen Wert zurückgeben. Beispiel für klassischen einzeiligen UNIX-Stil:
  free -m | awk 'NR==2{print $3}'
  Dieses Skriptformat war vor der WhatsUp-Gold-Version 16.2.3 erforderlich.
- Interaktive Shell. Bei diesem Skript gilt nicht die Einschränkung, dass nur numerische Werte zurückgegeben werden dürfen; die Ausgabe MUSS jedoch die Zeichenfolge „Result=xxxx“ enthalten, wobei „xxxx“ für einen numerischen Wert steht. Beispiel für neuen mehrzeiligen LINUX-Stil:
  echo Result=$(free -m | awk 'NR==2{print $3}')
  Dieses neuere Skriptformat unterstützt alle Funktionen der Zielskript-Interpreter und erschwert dem Skriptentwickler nicht unnötig die Arbeit durch die Einschränkung, dass nur ein einzelner numerischer Wert zurückgegeben werden darf.

Note: Ab Version 18.0.2 werden bei der Option Interaktive Shell benutzerdefinierte reguläre Ausdrücke unterstützt, mit denen WhatsUp Gold Leistungsdaten von bestimmten eingebetteten Systemen (Router, Switches, Integrated Dell Remote Access Controllers (iDRAC)) erfassen kann. Sie können diese Funktion bei der Konfiguration eines SSH-Leistungsmonitors mit dem Kontrollkästchen Benutzerdefinierte RegEx verwenden aktivieren, wenn die Option Interaktive Shell ausgewählt wird.

Beispiel: Standard-Regex

Befehl: <Befehl, bei dem das Ergebnis im Standardformat ausgegeben wird>

Ausgabe: Result=15

Wenn der Standard-RegEx mit dieser Ausgabe ausgeführt wird, wird das Ergebnis mit Result=15 abgeglichen. Die Erfassungsgruppe sieht 15 als Ergebnis an; daher speichert WhatsUp Gold diesen Wert als Ergebnis der Abfrage. Der RegEx in der Erfassungsgruppe [0-9.,]+ stimmt mit einer beliebigen Anzahl von Ziffern 0-9, Punkt und Komma überein, wobei der Wert nur einen Punkt bzw. ein Komma haben darf, damit er richtig als Zahl interpretiert wird. Wenn der gleiche RegEx auf Result=A33 angewendet wird, wird keine Übereinstimmung zurückgegeben. Result=33A würde jedoch eine Übereinstimmung mit Result=33 zurückgeben, und die Erfassungsgruppe sieht 33 als Ergebnis an.

Beispiel: Benutzerdefinierter RegEx

Geben Sie zur Überwachung der Leistungsaufnahme eines Dell R710 (Statistik cfgServerPowerLastMinAvg) über die iDRAC-Verwaltungsschnittstelle mit dem Befehl „racadm getconfig -g cfgServerPower“ folgenden regulären Ausdruck ein. Beachten Sie, dass unten nur die relevanten Ausdrücke aufgeführt sind.

# cfgServerPowerStatus=1

(Auslassung)

cfgServerPowerCapEnable=0

# cfgServerPowerLastMinAvg=357 AC W | 1218 Btu/hr

# cfgServerPowerLastHourAvg=359 AC W | 1225 Btu/hr

(Teile zur Wahrung der Übersichtlichkeit ausgelassen)

Der in diesem Beispiel verwendete reguläre Ausdruck zur Erfassung des durchschnittlichen Verbrauchs (in Watt) in der letzten Minute lautet cfgServerPowerLastMinAvg=([\d]+); dieser Ausdruck sucht nach cfgServerPowerLastMinAvg=, gefolgt von einer oder mehreren Ziffern. Der Wert, der als Ergebnis der Abfrage ausgegeben wird, ist 357, da [\d]+ innerhalb der Erfassungsgruppe () liegt. Beachten Sie, dass der reguläre Ausdruck eine Erfassungsgruppe () enthalten muss, damit das Ergebnis an WhatsUp Gold zurückgegeben wird.

Der Monitor verwendet nur die letzte Übereinstimmung, die er in der Ausgabe findet. Selbst wenn der Befehl Tausende von Ergebnissen zurückgibt, zeichnet WhatsUp Gold nur die letzte Übereinstimmung auf. Weitere Informationen zu den Optionen der regulären Standardausdrücke für .NET finden Sie hier.

Falls WhatsUp Gold beim Abgleich von regulärem Ausdruck und zurückgegebener Ausgabe keine Übereinstimmung findet, enthält das Leistungsfehlerprotokoll die Rohdaten, die vom Gerät empfangen wurden. Mit diesen Daten können Sie die Probleme mit dem RegEx-Muster in der Monitorkonfiguration lösen.

Zeilenumbruchzeichen. Wählen Sie das gewünschte Zeilenumbruchzeichen aus: Keines, Zeilenvorschub oder Wagenrücklauf (CR). Mehrzeilige Skripte werden von Windows-Betriebssystemen nach wie vor unterstützt und dort gerne eingegeben, enthalten aber häufig Zeilenumbruchzeichen, die vom Zielgerät nicht erkannt werden. Diese Konfigurationsfunktion weist WhatsUp Gold an, Zeilenumbruchzeichen vor der Verbindungsherstellung und der Befehlsausführung durch das hier angegebene Zeichen zu ersetzen.