NAME

pasvnag_lite - a (passive) nagios checker

VERSION

$Revision: 99 $

SYNOPSIS

pasvnag_lite [options] <configfile>

OPTIONS

-d

debug mode, does not send anything to nrpe, just print what would be sent

DESCRIPTION

This script runs nagios (or icinga, ..) checks on defined objects and submits the results to a specific NSCA host.

DEPENDENCIES

you'll need send_nrpe.

INSTALLATION

Move the script anywhere you like and create a (mostly nagios compatible) config file.

CONFIGURATION

pasvnag_lite is trying to be compatible with nagios, so the configuration file is quite similar.

NSCA DEFINITION

 define nagios {
     send_nsca /path/to/send_nsca
     nsca_config_file /path/to/send_nsca.cfg
     sync 0
     nsca_host host_where_nsca_is_running
     plugin_dir /path/to/nagios/plugins
 }
send_nsca

Where to find the send_nsca binary.

nsca_config_file

Where to find the send_nsca config file.

sync

Whether or not send_nsca should be invoked every time a check result is available (sync 1) or once every tcheck has finished (sync 0, default).

nsca_host

The NSCA host the check results are sent to.

plugin_dir

The nagios/icinga/.. plugin dir (e.g. libdir/nagios/plugins).

COMMAND DEFINITION

 define command {
     command_name check_command_name
     command_line check_command_line -H $HOSTADDRESS$ $ARG1$ .. $ARGn$
 }
command_name

The check command name.

command_line

The check command line. $HOSTADDRESS$ is substituted with the host's address (see below), $ARG1$ to $ARGn$ with the given arguments.

HOST DEFINITION

 define host {
     host_name a.host.name
     address fqdn_or_ip_address
     hostgroups optional_hostgroup
     check_command host-alive-check-command
     dummy
 }
host_name

The host name.

check_command

The host alive check command (defaults to check_ping).

dummy

Assume the host to be alive, don't perform host alive checks and don't send status or perfdata to NSCA.

address

The hosts's address (FQDN or IP).

hostgroups

An optional comma separated list of groups the host is member of.

SERVICE DEFINITION

 define service {
     service_description service_check_name
     check_command check_command_name!ARG1!..!ARGn
     host_name a.host.name
     hostgroup_name a.hostgroup.name
 }
service_description

The service check name / description.

check_command

The check command (see "COMMAND DEFINITION"). Arguments to the command are separated by exclamation marks.

host_name

A comma separated list of hosts (see "HOST DEFINITION") the service check should be run against.

hostgroup_name

A comma separated list of hostgroups (see above) the service check should be run against.

Either host_name or hostgroup_name is mandatory, obviously.

AUTHOR

Philippe Kueck <projects at unixadm dot org>