https://github.com/bigpresh/nagios-scrape

Nagios::Scrape Perl CPAN module, to scrape info from Nagios
https://github.com/bigpresh/nagios-scrape

Last synced: about 2 months ago
JSON representation

Nagios::Scrape Perl CPAN module, to scrape info from Nagios

• Host: GitHub
• URL: https://github.com/bigpresh/nagios-scrape
• Owner: bigpresh
• Created: 2018-01-12T09:37:20.000Z (almost 7 years ago)
• Default Branch: master
• Last Pushed: 2018-01-12T10:01:52.000Z (almost 7 years ago)
• Last Synced: 2024-10-13T11:32:39.575Z (3 months ago)
• Language: Perl
• Size: 11.7 KB
• Stars: 0
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README
  • Changelog: Changes

Awesome Lists containing this project

README

        
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, 

    Maintainership since 2018: David Precious (BIGPRESH)

    [email protected]

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::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.