Nagios is a host, service, and network monitoringsystem that will watch your network and alert youto problems before your clients or end-users do.The system runs checks on hosts and services thatyou specify using plugins that return statusinformation to Nagios. When problems areencountered, the system will send notifications tosystem administrators so that they can take actionon the problem. The JumpBox for Nagios gives youa head start to using the system. It eliminatesthe complexity involved in getting the application installed, and allows you to focus onthe configuration for your specific environment.Since Nagios is based on plugins, depending onwhat you want to do this will vary in complexity.
NAGIRCBOT(1) General Commands Manual NAGIRCBOT(1)NAME
nagircbot - announce Nagios status to an IRC channel
SYNOPSIS
nagircbot [-CdeHmRStxX] [-A REGEX] [-c CHANNEL] [-f FILE] [-F HOST[:PORT]] [-i INTERVAL] [-I INTERVAL] [-k KEYWORD] [-n NICK] [-N PREFIX]
[-p PASSWORD] [-P FILE] [-s HOST[:PORT]] [-T LIST] [-u USERNAME] [-U NAME] [-z USER]
DESCRIPTION
nagircbot is an IRC bot that reads Nagios' status information and emits alerts to an IRC channel. It can filter alerts based on severity
(CRITICAL, HARD, SOFT, and/or UNKNOWN) or by regular expression. It can connect to IRC servers protected by password or SSL, and can
optionally set the topic to the current Nagios status.
OPTIONS -A REGEX
Filter (omit) lines that match a basic regular expression.
-c CHANNEL
Channel to connect to, including the leading "#" (default: "#nagircbot").
-C Use colors in IRC messages.
-d Do not fork into the background.
-e Use encryption (SSL) when connecting to the IRC server.
-f FILE
Path to Nagios' status.log, indicated by the 'status_file' parameter in nagios.cfg (default: "/usr/local/nagios/var/status.log").
-F HOST[:PORT]
Retrieve status.log over the network. If no port is specified, the default is 33333.
-H Only announce alerts in 'HARD' state. This is the default.
-i INTERVAL
Nagios alert check interval, in seconds (default: 60).
-I INTERVAL
How often to announce Nagios global status in the channel, in seconds. Specify an interval of 0 (the default) to disable. Do not
specify an interval smaller than the alert check (-i) interval.
-k KEYWORD
Keyword for the channel (default: no keyword).
-m Display status information for an alert in separate IRC messages instead of combining on a single message.
-n NICK
IRC nick to use (default: "nagircbot").
-N PREFIX
Prefix for all in-channel IRC messages.
-p PASSWORD
IRC server password.
-P FILE
Write PID file.
-R Only announce CRITICAL/UNKNOWN alerts.
-s HOST[:PORT]
IRC server to connect to. If not specified, the default is "localhost:6667". If no port is specified, the default is 33333.
-S Also announce alerts in 'SOFT' state.
-t Set the channel topic to an alert summary.
-T LIST
Enable checks to see if Nagios is still running. Send 'check' in a private message to invoke the check. Accepts a comma-seperated
list (without spaces) with the following elements: max_time_last_host_update, max_time_oldest_host_update, max_time_last_host_check,
max_time_oldest_host_check, max_time_last_service_check, max_time_oldest_service_check, and max_time_oldest_next_service_check.
-u USERNAME
Username to log into the IRC server as.
-U NAME
IRC "real" or full name (default: "nagircbot").
-x status.log is in Nagios 1.0 format.
-X status.log is in Nagios 2.0/3.0 format. This is the default.
-z USER
User to run as.
AUTHOR
nagircbot was written by Folkert van Heusden <folkert@vanheusden.com>.
This manual page was written by John Morrissey <jwm@horde.net>, for the Debian project (and may be used by others).
December 13, 2010 NAGIRCBOT(1)