RRDTool::OO 0.22

RRDTool::OO is an Object-oriented interface to RRDTool.

SYNOPSIS

use RRDTool::OO;

# Constructor
my $rrd = RRDTool::OO->new(
file => "myrrdfile.rrd" );

# Create a round-robin database
$rrd->create(
step => 1, # one-second intervals
data_source => { name => "mydatasource",
type => "GAUGE" },
archive => { rows => 5 });

# Update RRD with sample values, use current time.
for(1..5) {
$rrd->update($_);
sleep(1);
}

# Start fetching values from one day back,
# but skip undefined ones first
$rrd->fetch_start();
$rrd->fetch_skip_undef();

# Fetch stored values
while(my($time, $value) = $rrd->fetch_next()) {
print "$time: ",
defined $value ? $value : "[undef]", "n";
}

# Draw a graph in a PNG image
$rrd->graph(
image => "mygraph.png",
vertical_label => 'My Salary',
start => time() - 10,
draw => {
type => "area",
color => '0000FF',
legend => "Salary over Time",
}
);

RRDTool::OO is an object-oriented interface to Tobi Oetiker's round robin database tool rrdtool. It uses rrdtool's RRDs module to get access to rrdtool's shared library.

RRDTool::OO tries to marry rrdtool's database engine with the dwimminess and whipuptitude Perl programmers take for granted. Using RRDTool::OO abstracts away implementation details of the RRD engine, uses easy to memorize named parameters and sets meaningful defaults for parameters not needed in simple cases. For the experienced user, however, it provides full access to rrdtool's API. (Please check "Development Status" to verify how much of it has been implemented yet, though, since this module is under development.

Product's homepage

Requirements:

· Perl