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-threshold=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 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) AVERAGE 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=adaption-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 development 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>