diff options
author | Micah Anderson <micah@riseup.net> | 2011-04-11 12:30:51 -0400 |
---|---|---|
committer | Micah Anderson <micah@riseup.net> | 2011-04-11 12:30:51 -0400 |
commit | 7735baa65f0dc37f94d4854fd62c817de94d64f2 (patch) | |
tree | 1a4e7a70e27897e08e0e0bb754b4b4d1f2889967 /README | |
parent | 2f2eb1cb12a57d8a85801086b6fbfce19e9c7a1b (diff) | |
parent | f2df62c9d17d481a3d616a4f2de9496638fadc0a (diff) |
Merge commit 'f2df62c9d17d481a3d616a4f2de9496638fadc0a'
Conflicts:
manifests/defaults/commands.pp
Diffstat (limited to 'README')
-rw-r--r-- | README | 35 |
1 files changed, 35 insertions, 0 deletions
@@ -85,6 +85,18 @@ nagios::target::fqdn instead of nagios::target . previous versions of nagios_host used the parameter named 'ip', that has been changed to 'address' + +IRC bot +======= + +Notifications can easily be sent to an IRC channel by using a bot. To do so, +simply include 'nagios::irc_bot' on the nagios server and define the right +$nagios_nsa_* variables (see the 'Variables' section below). + +You can then use the notification commands 'notify-by-irc' and +'host-notify-by-irc' with service and host definitions to make them report +state changes over IRC. + Caveats ======= @@ -127,6 +139,29 @@ Options to change the behavior of the nagios module: may also need to flip "check_external_commands" in "nagios.cfg" to enable this functionality. +- nagios_nsa_socket: This optional variable can be used to specify the path to + the socket file that the IRC daemon should use. + +- nagios_nsa_server: When using the IRC bot, this defines the server address of + the IRC network on which the bot will connect. + +- nagios_nsa_port: Defines the port number on the IRC server on which the bot + should connect. When this variable is not set, the port used + by default is 6667. + +- nagios_nsa_nickname: This is the nickname that the IRC bot will take. + +- nagios_nsa_password: Some networks require a password to connect to them. + This defines such a password. + +- nagios_nsa_channel: The name of the channel that the IRC bot will join and + will post notifications to. + +- nagios_nsa_pidfile: This optional variable can be used to define the path to + the file that will contain the process ID of the IRC bot + daemon. +- nagios_nsa_realname: The IRC bot user's real name that will be displayed. By + default, the real name is 'Nagios'. Examples ======== |