Introduction
What follows is a brief description of each CGI distributed with NetSaint, along with the various options that can be specified in the URL to control output.
This is the most important CGI included with NetSaint. It allows you to view the current status of all hosts and services that are being monitored. The status CGI can produce two main types of output - a status overview of all host groups (or a particular host group) and a detailed view of all services (or those associated with a particular host). The table below lists the various arguments that can be passed to the CGI...
Argument | Description |
host=all | This will produce a detailed view of the status of all services being monitored with NetSaint |
host=xxxx | This will produce a detailed view of the status of all services associated with host xxxx, where xxxx is the short name of the host as defined in the host configuration file. |
hostgroup=all | This will produce an overview of all services (and their associated hosts) being monitored with NetSaint, grouped into various host groups. |
hostgroup=xxxx | This will produce an overview of all services (and their associated hosts) belonging to host group xxxx, where xxxx is the short name of the host group as defined in the host configuration file. |
columns=x | This option may only be used in conjunction with the hostgroup=all argument. It allows you to control how many columns of hostgroups are displayed on the generated page. For instance, supplying hostgroup=all&columns=4 as arguments to the CGI will produce an overview page that contains four columns of host groups. |
style=detail | This option may only be used in conjunction with the hostgroup argument. Supplying this option will produce a detailed view of all services for hosts that are members of the hostgroup you specified. If you do not supply this option, the default action is to produce a status overview page. |
nopopup | This option will suppress the host alert console window that gets displayed when one or more monitored hosts is either down or unreachable. |
This CGI will display the entire contents of the NetSaint log file (as specified by the log_file option in the main configuration file). This CGI does not accept any arguments.
This CGI is used to display the history of service or host problems with either a particular host or all hosts. The output is basically a subset of what is displayed by the log file CGI.
Argument | Description |
host=all | This will display the history of all hosts being monitored with NetSaint |
host=xxxx | This will display the history of host xxxx, where xxxx is the short name of the host as defined in the host configuration file. |
type=x | This option allows you to control which types of historical alerts are displayed. As x is a numerical value generated by the CGI, I would suggest using the dropdown box to select the type of alerts you want to view. |
statetype=x | This option allows you to control whether soft or hard alerts (or both) are displayed. As x is a numerical value generated by the CGI, I would suggest using the dropdown box to select the type of alerts you want to view. |
Notifications CGI (notifications.cgi)
This CGI is used to display the host and service notifications that have been sent to various contacts. Notifications can be displayed for all contacts, a particular contact, all hosts, or a particular host.
Argument | Description |
host=all | This will display all notifications that have been sent out for all hosts (and their associated services) being monitored with NetSaint |
host=xxxx | This will display all notifications that have been sent out for host xxxx (and its associated services), where xxxx is the short name of the host as defined in the host configuration file. |
contact=all | This will display all service and host notifications that have been sent out to all contacts. |
contact=xxxx | This will display all service and host notifications that have been sent out to contact xxxx, where xxxx is the short name of the contact as defined in the host configuration file. |
type=x | This option allows you to control which types of notifications are displayed. As x is a numerical value generated by the CGI, I would suggest using the dropdown box to select the types of notifications you want to view. |