Swiss Original. Mirrors: DE, US, IE, TW

Smokeping::Info

OVERVIEW

This module provides methods to further process information contained in smokeping rrd files. The smokeinfo tool is a simple wrapper around the functionality contained in here.

 my $si = Smokeping::Info->new("config/file/path");

 my $array_ref = $si->fetch_nodes(pattern=>'/node/path',
                                  mode=>'recursive');

 my $hash_ref = $si->stat_node(path,start,end);

IMPLEMENTATION

new(path)

Create a new Smokeping::Info instance. Instantiating Smokeping::Info entails reading the configuration file. This is a compute heavy procedure. So you may want to use a single info object to handle multiple requests.

fetch_nodes(pattern=>'/...',mode=>{recursive|regexp})

The fetch_nodes method will find all nodes sitting in the given pattern (absolute path) including the path itself. By setting the recursive mode, all rrd files in paths below will be returned as well. In regexp mode, all rrd paths matching the given expression will be returned.

stat_node(node,start,end)

Return a hash pointer to statistics based on the data stored in the given rrd path.

 med_avg - average median
 med_min - minimal median
 med_max - maximal median
 med_now - current median
 loss_avg - average loss
 loss_max - maximum loss
 loss_now - current loss

COPYRIGHT

Copyright 2009 by OETIKER+PARTNER AG

LICENSE

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

AUTHOR

Tobias Oetiker <tobi@oetiker.ch>, development sponsored by Swisscom Hospitality

NOTE: The content of this website is accessible with any browser. The graphical design though relies completely on CSS2 styles. If you see this text, this means that your browser does not support CSS2. Consider upgrading to a standard conformant browser like Mozilla Firefox or Opera but also Apple's Safari or KDE's Konqueror for example. It may also be that you are looking at a mirror page which did not copy the CSS for this page.