[rrd-developers] rrd_stats

[Philippe.Simonet at swisscom.com]

Hello all,

You can find 'attached' a small 'zipped' (yes, winzipped) module done for
computing statistics on rrd files. No makefile to build it on unix, but no
problem to do that.

what it does : 

- average, min, max, distribution values.
- very fast.
- very simple to add new functions.

Philippe

--------------------------------------------------------------
README for stats module for rrd
-------------------------------

1 : how to build
	(if you use the NT binary distribution, all is included)
	- add rrd_statsl.c to the rrd library built
	- compile the rrd_stats.c
	- link rrd_stats with rrd library, and you have a command-line
rrd_stats
	
	- replace the perl-shared rrds.xs, and rebuild the rest

2 : examples
	there are some examples in perl-shared/t, some of them requires the
CHART module

3 : documentation

		usage: (4 function are implemented, perl-type call is
described)
	
----------------------------------------------------------------
		mean/max/min: computes the average / minimum / maxmimum /
integration value for a rrd 	
		database, for each ds
		my ($step, $start, $end, $res, $names) = 
			RRDs::stats $rrd,
"func:pstep:cf","--start=stime","--end=etime";
		parameters:
		 func : mean/max/min/int
		 pstep : proposed step (function funds the best based on
time-range and rra/step availability)
		 cf : consolidation function
		 stime-etime : measure time
		results: 
		 $step : the step that was found and choosen
		 $start, $end : the really start and end
		 $res : list of result
		 $names : list of corresponding ds names
		examples: 
		 my ($step, $start, $end, $avg, $names) = RRDs::stats $rrd,
"mean:300:AVERAGE","--start=-1m";
		 my ($step, $start, $end, $avg, $names) = RRDs::stats $rrd,
"min:300:AVERAGE","--start=-1d";
		 my ($step, $start, $end, $avg, $names) = RRDs::stats $rrd,
"max:300:AVERAGE","--start=-1w";
		 my ($step, $start, $end, $avg, $names) = RRDs::stats $rrd,
"int:300:AVERAGE","--start=-1w";
	
----------------------------------------------------------------
		dist: computes the distribution of values for a given ds in
an rrd
		my ($step, $start, $end, $before, $after, $res) = 
			RRDs::stats $rrd,
"dist:minval:maxval:ds:nbdist:pstep:cf",
				"--start=stime","--end=etime";
		parameters:
		 pstep : proposed step (function funds the best based on
time-range and rra/step availability)
		 ds : name of ds
		 nbdist : number of interval to compute dist (between minval
and maxval)
		 cf : consolidation function
		 stime-etime : measure time
		 maxval, minval : minimum and maximum value to compute the
distribution
		results: 
		 $step : the step that was found and choosen
		 $start, $end : the really start and end
		 $res : list of results
		 $before, $after : results that are <minval(before) of >
maxval(after)
		example: 
		my ($step, $sta, $en, $before, $after, $res) = RRDs::stats
$rrd, 					
	
"dist:0:100:ds1:10:300:AVERAGE","--start=-1d";
	
----------------------------------------------------------------
		rrd_stats choose the rra with the following rules : (not
same as fetch or graph)
		- for each rra it computes an overlap factor that is the
factor between the requested 
		  range (end-start) and the available range of this rra
		- for overlap factor that are not 'very' different (90%), it
take the step that is 
		  closest from the proposed step );

4.3.200, philippe.simonet at swisscom.com



-- Attached file removed by Listar and put at URL below --
-- Type: application/octet-stream
-- Size: 13k (14016 bytes)
-- URL : http://www.ee.ethz.ch/~slist/pantomime/rrdstats-1.0.14.zip


--
Unsubscribe mailto:rrd-developers-request at list.ee.ethz.ch?subject=unsubscribe
Help        mailto:rrd-developers-request at list.ee.ethz.ch?subject=help
Archive     http://www.ee.ethz.ch/~slist/rrd-developers