SSH Unix Server Generic 6.1-1

Description

Monitors a Unix server. Monitoring scripts are installed on the remote server and called from the GroundWork server using the SSH protocol. Please reference the SSH Monitoring document when using this profile. If you are communicating to a remote host that is behind a firewall, make sure the SSH port 22 is allowed to access the remote host.

Profile Package

This package includes the following files:

  • Profile definition: service_profile_ssh-unix.xml
  • Plugin scripts (installed on the GroundWork server): check_ssh and check_by_ssh
  • Plugin scripts (installed on the remote monitored server): check_disk, check_load, check_mem.pl, check_procs, check_swap

Installation

GroundWork Monitor includes many monitoring profiles for a variety of devices, systems and applications. Some profiles are pre-imported on a new GroundWork installation and others are distributed with the product. The configuration tool is used to import updated profiles and profiles that require additional setup, services can also be imported, see Importing Profiles.

Services Configuration

For plugin details you can run the service help command from within the nagios container. For example: Get to the nagios container from the gw8 directory: docker-compose exec -u 1000 nagios bash, then to the libexec directory: cd /usr/local/nagios/libexec, and enter a service help command e.g., ./check_snmp --help to receive help content.

Service/Command Line/Plugin CommandCommand Parameters

This column lists the Service Definition name, Service Command name with arguments to be passed to the plugin, and the Plugin Command line which is the plugin script called by Nagios for the service.

Command parameters are in the configuration services section with the following names and default values.

  • 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$"

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, default is 400.

  • $ARG2$:  A critical alert will be generated if the number of megabytes free is below this number, default is 200.

  • $ARG3$: The path to be monitored, default is /.

  • 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$"

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, 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, default is 10,8,6.

  • 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$"

Check for the number of processes running.

  • $ARG1$: A warning alert will be generated if the number of processes exceeds this value, 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_by_ssh_swap!20%!10%

  • $USER1$/check_by_ssh -H $HOSTADDRESS$ -t 60 -l "$USER17$" -C "$USER22$/check_swap -w $ARG1$ -c $ARG2$"

Check swap space.

  • $ARG1$: A warning alert will be generated if the percent swap space is less than this value, default is 20%.

  • $ARG2$: A critical alert will be generated if the percent swap space is less than this value, default is 10%.

  • 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$"

Check system uptime.

  • $ARG1$: A warning alert will be generated if the system uptime is less than this value, default is 1800%.

  • $ARG2$: A critical alert will be generated if the system uptime is less than this value, default is 900%.

  • tcp_ssh

  • check_ssh

  • $USER1$/check_ssh -H $HOSTADDRESS$ -t 60

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

Related Resources