Joe Topjian > Nagios-Scrape-0.03 > Nagios::Scrape

Download:
Nagios-Scrape-0.03.tar.gz

Dependencies

Annotate this POD

CPAN RT

New  1
Open  0
View/Report Bugs
Module Version: 0.03   Source  

NAME ^

Nagios::Scrape - Scrapes and Parses the status.cgi page of a Nagios installation

VERSION ^

Version 0.03

SYNOPSIS ^

This module uses LWP to retrieve the status.cgi page of a Nagios installation, parses the data into a manageable format, and then makes it accessible.

This is a more lightweight solution to Nagios installations where the status.dat file can reach 1+mb in size.

    use Nagios::Scrape;

    my $foo = Nagios::Scrape->new(username => $username, password => $password, url => $url);
    @service_alerts = $foo->get_service_status();
    @host_alerts = $foo->get_host_status();

SUBROUTINES/METHODS ^

new

Creates a new class given a username and password.

    my $nagios = Nagios::Scrape->new(username => $username, password => $password, url => $url);

host_state

This method allows you to filter certain host states. The table is as follows:

Hosts: PENDING 1 UP 2 DOWN 4 UNREACHABLE 8

Add the number for each state that you want to see. For example, to see DOWN and UNREACHABLE states, set this value to 12. (Default value).

service_state

This method allows you to filter certain service states. The table is as follows:

Services: PENDING 1 OK 2 WARNING 4 UNKNOWN 8 CRITICAL 16

Add the number for each state you would like to see. For example, to see WARNING, UNKNOWN, and CRITICAL states, set the number to 28. (Default value).

get_service_status

Connects to given URL and retrieves the requested service statuses

get_host_status

Connects to given url and retrieves host statuses

parse_service_content

Will parse the service status page into a manageable array of hashed service details.

parse_host_content

Will parse the host status page into a manageable array of hashed service details.

decode_html

Simple helper method that smooths out HTML strings from Nagios status.cgi page

AUTHOR ^

Joe Topjian, <joe at terrarum.net>

BUGS ^

Please report any bugs or feature requests to bug-nagios-scrape at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Nagios-Scrape. 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 Nagios::Scrape

ACKNOWLEDGEMENTS ^

Some of this code was taken from www.nagios3book.com/nagios-3-enm/tts/nagios-ttsd.pl which is no longer online.

LICENSE AND COPYRIGHT ^

Copyright 2010 Joe Topjian.

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: