SSH (Performance)

The SSH monitor uses SSH authentication to connect to a remote device to execute commands or scripts which can be either embedded in the monitor or placed as an executable script file on the remote machine with a command embedded in the monitor to run the script. Each monitor returns a single numeric value which is recorded in the database and then used later by other WhatsUp Gold functions as needed.

Provide a unique name and description for the monitor, then configure the following:

Note: Beginning with v18.0.2, the Shell Interactive option supports user-defined custom regular expressions to make it possible for WhatsUp Gold to successfully gather performance data from some embedded systems including routers, switches, and Integrated Dell Remote Access Controllers (iDRAC). To enable this feature when configuring an SSH performance monitor, enable the Use Custom Regex checkbox when the Shell Interactive option is selected.

Example: Default Regex

Command: <command that outputs the result in the default format>

Output: Result=15

When the default regex is run with this output, it matches on Result=15. The capturing group considers 15 the result, so that is the value WhatsUp Gold stores as the result of the poll. The regex inside the capturing group [0-9.,]+ matches on any one or more 0-9 number, decimal point, and comma, though the value should only have one decimal or comma in it to be parsed correctly into a number. If the same regex was run against Result=A33, it would not match. However, Result=33A would match on Result=33 and the capturing group would consider 33 the result.

Example: Custom Regex

To monitor the power usage of a Dell R710 (the specific statistic being cfgServerPowerLastMinAvg) through the iDRAC management interface using the following command, "racadm getconfig -g cfgServerPower", enter the following regular expression. Please note, only the relevant lines of the expression are included below.

# cfgServerPowerStatus=1

(Snipped)

cfgServerPowerCapEnable=0

# cfgServerPowerLastMinAvg=357 AC W | 1218 Btu/hr

# cfgServerPowerLastHourAvg=359 AC W | 1225 Btu/hr

(Truncated for brevity)

The regular expression used in this example to capture the watt usage average over the last minute is cfgServerPowerLastMinAvg=([\d]+) which looks for cfgServerPowerLastMinAvg= followed by one or more digits.The value that would be returned as the result of the poll is 357 because the [\d]+ is inside a capturing group (). Note that the regular expression specified MUST include a capturing group () to return the result of the poll to WhatsUp Gold.

The monitor only consumes the last match it finds in the output. Even if the command executed returns thousands of results, WhatsUp Gold only records the last match. Additional information on .Net Default Regular Expression options can be found here.

In the event WhatsUp Gold fails to find a match when processing the regular expression against the output returned, the Performance Error Log will contain the raw output received from the device. You can use this information to address the issue(s) with the regex pattern specified in the monitor configuration.


See Also

Performance Monitors

Active Script (Performance)

APC UPS (Performance)

AWS CloudWatch (Performance)

Azure Cloud (Performance)

Azure Cloud (Billing and Usage)

CPU Utilization (Performance)

PowerShell Scripting

Disk Utilization (Performance)

Printer Ink/Toner Performance Monitor

Hyper-V Virtual Machine Disk Activity

JMX (Performance)

Interface Utilization

Memory Utilization (Performance)

Ping Latency and Availability

SNMP (Performance)

SQL Query (Performance)

VMware Datastore IOPS

Windows Performance Counter

Configuring WMI Formatted Counter monitors

WMI Performance Monitor

Hyper-V Event Log Monitor

Hyper-V Host Virtual Machines Monitor