NAME

Xymon::Server::History - Return a hash of Xymon events history

SYNOPSIS

use Xymon::Server::History;

my $history = Xymon::Server::History->new({HOME=>'/home/hobbit'})

DESCRIPTION

Various methods for returning differents views of the event data stored in $HOBBITHOME/data/histlogs/

Be aware that this can take considerable time to run if there are a large number of servers and events as it has to troll through the histlogs dir and look for events.

METHODS

new({...})

Instantiates the object.

You must pass it the HOME dir for hobbit. (One level below server).

my $history = Xymon::Server::History->new({ HOME=>'/home/hobbit/server', SERVERS => ['oranprodsys'], TESTS => ['conn'], STARTTIME => "9:00", ENDTIME => "17:00", WORKDAYS => [1,2,3,4,5], RANGESTART => time()-86400*7, RANGEEND => time(), MINSECS => 300 });

allEvents({....})

Returns a hash of events with following structure:

{
	server1 => {
				conn => {
					"file1"=>{
						filename => "fullfilename"
						time => "time in unix format"
					}
					"file2" => {
						filename => "fullfilename"
						time => "time in unix format"
					}
			  },

	server2 => {
				uptime => "file1"=>{
						filename => "fullfilename"
						time => "time in unix format"
					}
					"file2" => {
						filename => "fullfilename"
						time => "time in unix format"
					}
			  }
}

allEvents() will return events for all servers and tests. This may be filter by passing an array of servers, and an array of tests in order to filter the results eg:

allEvents({
	SERVERS => ["servername1","servername2"],
	TESTS => ["conn","uptime"]
})

The filename of the event is in the format: Fri_Dec_14_16:56:14_2007

outagelist()

Returns a list of outages from red to non-red in the following format

	'oranprodsys.conn.1265337130' => {
   
 	       'test' => 'conn',
 	       'server' => 'hostname',
	        'filename' => '/home/hobbit/data/histlogs/server1/conn/Fri_Feb_5_13:56:05_2010',
	        'starttime' => 1265337130,
	        'busstring' => '0 days 0 hours 23 minutes',
	        'duration' => 1435,
	        'endtime' => 1265338565,
	        'server' => 'server1',
	        'bussecs' => 1435,
	        'comment' => 'Still Down'
	
	               },
                                     
                                     

AUTHOR

David Peters
CPAN ID: DAVIDP
davidp@electronf.com
http://www.electronf.com

COPYRIGHT

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

The full text of the license can be found in the LICENSE file included with this module.

SEE ALSO

perl(1).