SSH UNIX

SSH UNIX Profile

This Profile monitors a UNIX server. Monitoring scripts are installed on the remote server and called from the GroundWork server using the SSH protocol. Please reference SSH document under GroundWork Profiles>SSH Profiles when using this profile.

Services Configuration

SERVICE - Definitions in Monarch are stored under this name.
COMMAND LINE - Service command name with arguments to be passed to the plugin.
PLUGIN COMMAND LINE - Plugin script called by Nagios for this Service.

EXTENDED INFO - The Extended Service Info definition, typically used for generating graphs.

Command lines displayed below are intended to be single line commands.

Service	Command Line	Plugin Command Line	Extended Info
ssh_disk_root	check_by_ssh_disk!400!200!/	$USER1$/check_by_ssh -H $HOSTADDRESS$ -t 60 -l "$USER17$" -C "$USER22$/check_disk -w $ARG1$ -c $ARG2$ -p $ARG3$"	number_graph
ssh_load	check_by_ssh_load!5,4,3!10,8,6	$USER1$/check_by_ssh -H $HOSTADDRESS$ -t 60 -l "$USER17$" -C "$USER22$/check_load -w $ARG1$ -c $ARG2$"	unix_load_graph
ssh_memory	check_by_ssh_mem!80!90	$USER1$/check_by_ssh -H $HOSTADDRESS$ -t 60 -l "$USER17$" -C "$USER22$/check_mem.pl -U -w $ARG1$ -c $ARG2$"	percent_graph
ssh_process_count	check_by_ssh_process_count!80!100	$USER1$/check_by_ssh -H $HOSTADDRESS$ -t 60 -l "$USER17$" -C "$USER22$/check_procs -w $ARG1$ -c $ARG2$"	number_graph
ssh_swap	check_by_ssh_swap!20%!10%	$USER1$/check_by_ssh -H $HOSTADDRESS$ -t 60 -l "$USER17$" -C "$USER22$/check_swap -w $ARG1$ -c $ARG2$"	percent_graph
ssh_uptime	check_by_ssh_uptime!1800!900	$USER1$/check_by_ssh -H $HOSTADDRESS$ -t 60 -l "$USER17$" -C "$USER22$/check_system_uptime.pl -w $ARG1$ -c $ARG2$"
tcp_ssh	check_ssh	$USER1$/check_ssh -H $HOSTADDRESS$ -t 60	number_graph

Profile Package

This package includes the following files:

Profile Definitions

service-profile-ssh-unix.xml
perfconfig-ssh-unix.xml

Plugins Scripts on the GroundWork Server

check_ssh
check_by_ssh

Plugin Scripts on the Remote Monitored Server

check_disk
check_load
check_mem.pl
check_procs
check_swap

Performance Graphing Programs

unix_load.cgi
percent_graph.cgi
number_graph.cgi

Installation

GroundWork Monitor includes many monitoring profiles for a variety of devices, systems and applications. Profiles already imported on a new GroundWork installation include Service Ping, SNMP Network, and SSH UNIX. The GroundWork Monitor Configuration tool is used to import updated Profiles and Profiles that require additional setup; the Profile XML file and its companion Performance Configuration definition file. Services can also be imported in addition to Service Profiles in the Profile Importer. The import process is documented under GROUNDWORK PROFILES > How to import profiles.

Implementation

This section contains detail settings used by this Profile. These parameters can be altered with the Configuration tool.

Command Parameters

Command parameters are in the Configuration Services section with the following names and default values.

ssh_disk_root

Check for disk utilization on the specified partition.
$ARG1$ - A warning alert will be generated if the number of megabytes free is below this number. The default is 400.
$ARG2$ - A critical alert will be generated if the number of megabytes free is below this number. The default is 200.
$ARG3$ - the path to be monitored. The default is /.

ssh_load

Check the current system load average.
$ARG1$ - A warning alert will be generated if the 1 minute, 5 minute and 15 minute loads exceed the defined values. The default is 5,4,3.
$ARG2$ - A critical alert will be generated if the 1 minute, 5 minute and 15 minute loads exceed the defined values. The default is 10,8,6.

ssh_memory

Check the amount of memory used.
$ARG1$ - A warning alert will be generated if the percent of used memory number is above this value. The default is 80%.
$ARG2$ - A critical alert will be generated if the percent of used memory number is above this value. The default is 90%.

ssh_process_count

Check for the number of processes running.
$ARG1$ - A warning alert will be generated if the number of processes exceeds this value. The default is 80.
$ARG2$ - A critical alert will be generated if the number of processes exceeds this value. The default is 100.

ssh_swap

Check swap space.
$ARG1$ - A warning alert will be generated if the percent swap space is less than this value. The default is 20%.
$ARG2$ - A critical alert will be generated if the percent swap space is less than this value. The default is 10%.

tcp_ssh

Check for response from SSH server on TCP port 22 of $HOSTADDRESS$
No arguments.

Performance Graphing Parameters

The following parameters are used to generate performance charts. These parameters are set using the Configuration>Performance tool in GroundWork Monitor.