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] [--failure-thresh-
     old=failure-threshold]  [--window-length=window-length]  [--alpha=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 termi-
	 nates 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)  AVERAGE  RRAs
	 will be taken.

     --delta=scale-value, --deltapos=scale-value, --deltaneg=scale-value,
     --failure-threshold=failure-threshold, --window-length=window-length, --al-
     pha=adaption-parameter, --beta=adaption-parameter, --gamma=adaption-parame-
     ter, --gamma-deviation=adaption-parameter
	 Set the Holt-Winters algorithm parameters. See rrdtune(1) and the arti-
	 cle 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  sam-
	 ples).

     --defaults
	 Use  the default values for all Holt-Winters parameters. Individual pa-
	 rameters 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 devel-
     opment 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.1.quarterly>

home | help