---
name: "nagircbot"
section: "1"
platform: "linux"
package: "nagircbot"
version: "0.0.33-2"
release: "Debian 7 (Wheezy)"
platforms: ["linux"]
url: "https://new.carta.tech/nagircbot"
---

# nagircbot(1)

announce Nagios status to an IRC channel

## 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).