David Precious > Bot-BasicBot-Pluggable-Module-Nagios > Bot::BasicBot::Pluggable::Module::Nagios

Download:
Bot-BasicBot-Pluggable-Module-Nagios-0.04.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 0.04   Source  

NAME ^

Bot::BasicBot::Pluggable::Module::Nagios - report Nagios alerts to IRC

DESCRIPTION ^

A module for IRC bots powered by Bot::BasicBot::Pluggable to monitor a Nagios install and report alerts to IRC.

Multiple Nagios instances are supported; these could be separate Nagios systems, or just the same Nagios install but using different credentials. As each configured instance can have specific target channels defined, this means you could have the bot check with the username "development" and report all visible problems to the #development channel, then check again with the "sysad" username and report problems visible to that user to the #sysads channel.

Actual monitoring is done using Nagios::Scrape, which scrapes the information from the status.cgi script which powers Nagios' web interface. This means that, assuming your Nagios setup is configured to be viewable over the web, you need no further setup to allow the bot to monitor it.

SYNOPSIS ^

Load the module as you would any other Bot::BasicBot::Pluggable module, then configure it to watch a Nagios install and report problems to the desired channel(s) with the nagios add command.

In a direct message to the bot:

    <user> nagios add http://nagios.example.com/cgi-bin/status.cgi username password #channel
    <bot> OK
    <user> nagios list
    <bot> I'm currently monitoring the following Nagios instances:
          .. 1 : http://example.com/cgi-bin/status.cgi as dave for #chan
    <user> nagios del 1
    <bot> OK, deleted instance 1

(You can supply a list of channel names separated by commas, if you want reports from a given instance to be announced to more than one channel.)

TODO ^

Plenty of improvements are planned, including:

AUTHOR ^

David Precious, <davidp at preshweb.co.uk>

CONTRIBUTING ^

This module is developed on GitHub:

https://github.com/bigpresh/Bot-BasicBot-Pluggable-Module-Nagios

Pull requests / suggestions / bug reports are welcomed.

If you feel like it, even a "I'm using this and find it useful" mail to davidp@preshweb.co.uk would be appreciated - it's nice to know when people find your work useful.

(Reviews on cpanratings and/or ++'s on MetaCPAN are also very welcome.)

BUGS ^

Please report any bugs or feature requests to bug-bot-basicbot-pluggable-module-nagios at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Bot-BasicBot-Pluggable-Module-Nagios. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT ^

You can find documentation for this module with the perldoc command.

    perldoc Bot::BasicBot::Pluggable::Module::Nagios

You can also look for information at:

ACKNOWLEDGEMENTS ^

LICENSE AND COPYRIGHT ^

Copyright 2011 David Precious.

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.

syntax highlighting: