pasvnag_lite

NAME

pasvnag_lite - a (passive) nagios checker

VERSION

$Revision: 426 $

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
    monitor_host host_where_pasvnag_configserver_is_running
    monitor_password pasvnag_configserver_password
    monitor_hostgroups hostgroups1,hostgroup2
    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.

• monitor_host

  The host where the pasvnag config server is running. Optional, see REMOTE_CONFIG.

• monitor_password

  The passphrase for the pasvnag config server. Optional, see REMOTE_CONFIG.

• monitor_hostgroups

  The hostgroups to fetch from the pasvnag config server. Optional, see REMOTE_CONFIG.

• 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.

REMOTE_CONFIG

pasvnag_lite can retrieve it's check definitions from a remote pasvnag config server. It authenticates itself with the monitor_password over an encrypted channel and asks for the given monitor_hostgroups.

Using this feature overrides the local configuration.