NAME
Nagios::Scrape - Scrapes and Parses the status.cgi page of a Nagios installation
VERSION
Version 0.04
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
Original author: Joe Topjian, <joe at terrarum.net>
Maintainership since 2018: David Precious (BIGPRESH) davidp@preshweb.co.uk
BUGS
Please report any bugs or feature requests on GitHub:
https://github.com/bigpresh/Nagios-Scrape/issues
SUPPORT
You can find documentation for this module with the perldoc command.
perldoc Nagios::ScrapeACKNOWLEDGEMENTS
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.