NetSaint Addons


The following is a description of various "addons" that are available for NetSaint. These and other addons can be downloaded from the NetSaint website at www.netsaint.org.

netsaint_statd - Perl daemon and plugins for monitoring remote host information
Author: Charlie Cook
Overview: Allows you to monitor disk usage, load average, processes, and users on remote hosts.
Files:
netsaint_statd - Perl daemon that runs on remote hosts
check_disk.pl - Perl plugin that is executed by NetSaint to check remote host disk information
check_users.pl - Perl plugin that is executed by NetSaint to check remote host user information
check_procs.pl - Perl plugin that is executed by NetSaint to check remote host process information
check_load.pl - Perl plugin that is executed by NetSaint to check remote host load information
Description:

netsaint_statd is a daemon which allows a NetSaint host to get information such as process count, users, disk usage, and load information using the corresponding plugin scripts. The daemon does not process the system information in anyway. It merely collects the information and hands it back to the calling script to do with as it pleases.

This daemon script is designed in such a way as to allow for easy porting to other OSes by changing the which_os subroutine. Adding other checks should also be easy by adding the appropriate subroutine and changing CASE2 to look for the wanted command. Hosts restrictions are currently based on a file in $safedir directory, /var/netsaint_statd by default. If the files doesn't exist, the daemon talks to everyone. If it exists and is empty, the daemon talks to no one. The contents of the file is one ip address per line. This is quick and dirty, the hope is to integrate tcp_wrappers and ditch this.

Notes: - You'll have to modify the first line of code in each file to match the location of your perl binary.
- If you experience "insecure BASH_ENV" warnings you might have to remove the -T option in the first line of code.

netsaint_mrtg - MRTG scripts for graphing NetSaint host and service status information
Author: Richard Mayhew
Overview: Allows you to produce MRTG graphs of NetSaint host and service status information
Files:
mrtghost_total.pl - Perl script that obtains the total number of hosts that are up and down
mrtgsvc_total.pl - Perl script that obtains the total number of services that are up and down
mrtgsvchost_total.pl - Perl script that obtains the total number of services that are up and down on a particular server
mrtgsvctyp_total.pl - Perl script that obtains the total number of services (of a particular type) that are up and down
Description:

This package includes two scripts which allow MRTG to generate graphs of host and service status totals, as reported by NetSaint. The scripts scan the NetSaint status log to determine the total number of services or hosts that have problems or are okay. Examples of how to incorporate the scripts with MRTG are provided in the README.mrtg file.

Notes: - You must be running MRTG to actually make use of this package