Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
RRD_HWREAPPLY(1)		    rrdman		      RRD_HWREAPPLY(1)

NAME
       rrd_hwreapply - Re-apply	Holt-Winters prediction	parameters to RRD data

SYNOPSIS
       rrd_hwreapply  in.rrd out.rrd [--force] [--start=start] [--delta=scale-
       value]	[--deltapos=scale-value]   [--deltaneg=scale-value]   [--fail-
       ure-threshold=failure-threshold]	[--window-length=window-length]	[--al-
       pha=adaption-parameter]	[--beta=adaption-parameter] [--gamma=adaption-
       parameter]    [--gamma-deviation=adaption-parameter]    [--rralen=rows]
       [--season=rows] [--defaults]

DESCRIPTION
       The prorgam takes the input RRD,	and copies all data to the output RRD,
       with new	Holt-Winters prediction	parameters applied.  If	the input file
       is  not	Holt-Winters enabled, all parameters must be specified,	or use
       the --defaults option.

       The resulting RRD will not contain exactly the same data	as the	source
       file.   It  is  a  result  of  numerous transformations during the data
       fetching	and storing. However, the tests	have shown quite good results:
       for a counter with average values of order of 1e+06, the	resulting data
       relative	difference is of order of 1e-10. For a	counter	 with  average
       values at the level of 1e+03, the precision is approximately 1e-08.

OPTIONS
       --force
	   Forces  the	output	file  to be overwritten. Otherwise the program
	   terminates if the output file already presents.

       --start=start
	   Specifies the earliest date to copy the data	for. If	not specified,
	   the earliest	available data with one-step (no consolidation)	 AVER-
	   AGE RRAs will be taken.

       --delta=scale-value, --deltapos=scale-value, --deltaneg=scale-value,
       --failure-threshold=failure-threshold, --window-length=window-length,
       --alpha=adaption-parameter, --beta=adaption-parameter, --gamma=adap-
       tion-parameter, --gamma-deviation=adaption-parameter
	   Set	the  Holt-Winters algorithm parameters.	See rrdtune(1) and the
	   article of Jake Brutlag on Aberrant Behavior	Detection.

       --rralen=rows
	   Set the length of HWPREDICT	RRA.  Default  is  4032	 (2  weeks  of
	   5-minute samples).

       --season=rows
	   Set	the  length of SEASONAL	RRA. Default is	288 (1 day of 5-minute
	   samples).

       --defaults
	   Use the default values for all Holt-Winters parameters.  Individual
	   parameters  may  be	overwritten  by	the above options. The default
	   values are:

	    delta = 2
	    alpha = 0.1
	    beta  = 0.0035
	    gamma = 0.1
	    window_length = 9
	    failure_threshold =	6
	    hw_rra_length = 4032
	    seasonal_period = 288

RESTRICTIONS
       This program requires RRDtool version 1.1.x (currently available	as de-
       velopment snapshot only), Perl version 5.8.2 (version 5.8.0 is known to
       have bugs which break this utility).

NOTES
       RRDman is a set of  utilities  that  manipulate	the  RRDtool  database
       files.

AUTHOR
       Stanislav Sinyagin <ssinyagin@yahoo.com>

rrdman 1.0.1			  2004-05-16		      RRD_HWREAPPLY(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=rrd_hwreapply&sektion=1&manpath=FreeBSD+Ports+15.0>

home | help