1 RRDTUNE(1) rrdtool RRDTUNE(1)
6 rrdtune - Modify some basic properties of a Round Robin Database
9 r\brr\brd\bdt\bto\boo\bol\bl t\btu\bun\bne\be _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be [-\b--\b-h\bhe\bea\bar\brt\btb\bbe\bea\bat\bt|-\b-h\bh _\bd_\bs_\b-_\bn_\ba_\bm_\be:_\bh_\be_\ba_\br_\bt_\bb_\be_\ba_\bt] [-\b--\b-m\bmi\bin\bni\bi-\b-
10 m\bmu\bum\bm|-\b-i\bi _\bd_\bs_\b-_\bn_\ba_\bm_\be:_\bm_\bi_\bn] [-\b--\b-m\bma\bax\bxi\bim\bmu\bum\bm|-\b-a\ba _\bd_\bs_\b-_\bn_\ba_\bm_\be:_\bm_\ba_\bx]
11 [-\b--\b-d\bda\bat\bta\ba-\b-s\bso\bou\bur\brc\bce\be-\b-t\bty\byp\bpe\be|-\b-d\bd _\bd_\bs_\b-_\bn_\ba_\bm_\be:_\bD_\bS_\bT] [-\b--\b-d\bda\bat\bta\ba-\b-s\bso\bou\bur\brc\bce\be-\b-r\bre\ben\bna\bam\bme\be|-\b-r\br _\bo_\bl_\bd_\b-
12 _\bn_\ba_\bm_\be:_\bn_\be_\bw_\b-_\bn_\ba_\bm_\be] [-\b--\b-d\bde\bel\blt\bta\bap\bpo\bos\bs _\bs_\bc_\ba_\bl_\be_\b-_\bv_\ba_\bl_\bu_\be] [-\b--\b-d\bde\bel\blt\bta\ban\bne\beg\bg _\bs_\bc_\ba_\bl_\be_\b-_\bv_\ba_\bl_\bu_\be]
13 [-\b--\b-f\bfa\bai\bil\blu\bur\bre\be-\b-t\bth\bhr\bre\bes\bsh\bho\bol\bld\bd _\bf_\ba_\bi_\bl_\bu_\br_\be_\b-_\bt_\bh_\br_\be_\bs_\bh_\bo_\bl_\bd] [-\b--\b-w\bwi\bin\bnd\bdo\bow\bw-\b-l\ble\ben\bng\bgt\bth\bh _\bw_\bi_\bn_\bd_\bo_\bw_\b-_\bl_\be_\bn_\bg_\bt_\bh]
14 [-\b--\b-a\bal\blp\bph\bha\ba _\ba_\bd_\ba_\bp_\bt_\bi_\bo_\bn_\b-_\bp_\ba_\br_\ba_\bm_\be_\bt_\be_\br] [-\b--\b-b\bbe\bet\bta\ba _\ba_\bd_\ba_\bp_\bt_\bi_\bo_\bn_\b-_\bp_\ba_\br_\ba_\bm_\be_\bt_\be_\br] [-\b--\b-g\bga\bam\bmm\bma\ba _\ba_\bd_\ba_\bp_\b-
15 _\bt_\bi_\bo_\bn_\b-_\bp_\ba_\br_\ba_\bm_\be_\bt_\be_\br] [-\b--\b-g\bga\bam\bmm\bma\ba-\b-d\bde\bev\bvi\bia\bat\bti\bio\bon\bn _\ba_\bd_\ba_\bp_\bt_\bi_\bo_\bn_\b-_\bp_\ba_\br_\ba_\bm_\be_\bt_\be_\br] [-\b--\b-a\bab\bbe\ber\br-\b-
19 The tune option allows you to alter some of the basic configuration
24 intervals than what you would normally want to permit. Be very careful
36 -\b--\b-h\bhe\bea\bar\brt\btb\bbe\bea\bat\bt|-\b-h\bh _\bd_\bs_\b-_\bn_\ba_\bm_\be:_\bh_\be_\ba_\br_\bt_\bb_\be_\ba_\bt
38 high value the RRD will accept things like one value per day.
41 alter the minimum value acceptable as input from the data
45 alter the maximum value acceptable as input from the data
48 -\b--\b-d\bda\bat\bta\ba-\b-s\bso\bou\bur\brc\bce\be-\b-t\bty\byp\bpe\be|-\b-d\bd _\bd_\bs_\b-_\bn_\ba_\bm_\be:_\bD_\bS_\bT
51 -\b--\b-d\bda\bat\bta\ba-\b-s\bso\bou\bur\brc\bce\be-\b-r\bre\ben\bna\bam\bme\be|-\b-r\br _\bo_\bl_\bd_\b-_\bn_\ba_\bm_\be:_\bn_\be_\bw_\b-_\bn_\ba_\bm_\be
52 rename a data source.
55 Alter the deviation scaling factor for the upper bound of the
56 confidence band used internally to calculate violations for the
58 is not related to graphing confidence bounds which must be
59 specified as a CDEF argument to generate a graph with confi-
60 dence bounds. The graph scale factor need not to agree with the
64 Alter the deviation scaling factor for the lower bound of the
65 confidence band used internally to calculate violations for the
66 FAILURES R\bRR\bRA\bA. The default value is 2. As with -\b--\b-d\bde\bel\blt\bta\bap\bpo\bos\bs, this
67 argument is unrelated to the scale factor chosen when graphing
68 confidence bounds.
70 -\b--\b-f\bfa\bai\bil\blu\bur\bre\be-\b-t\bth\bhr\bre\bes\bsh\bho\bol\bld\bd _\bf_\ba_\bi_\bl_\bu_\br_\be_\b-_\bt_\bh_\br_\be_\bs_\bh_\bo_\bl_\bd
71 Alter the number of confidence bound violations that constitute
73 integer less than or equal to the window length of the FAILURES
75 one can reset failure-threshold and window-length simultane-
76 ously. Setting this option will reset the count of violations
77 to 0.
79 -\b--\b-w\bwi\bin\bnd\bdo\bow\bw-\b-l\ble\ben\bng\bgt\bth\bh _\bw_\bi_\bn_\bd_\bo_\bw_\b-_\bl_\be_\bn_\bg_\bt_\bh
80 Alter the number of time points in the temporal window for
81 determining failures. This must be an integer greater than or
83 equal to 28. Setting this option will reset the count of viola-
84 tions to 0.
86 -\b--\b-a\bal\blp\bph\bha\ba _\ba_\bd_\ba_\bp_\bt_\bi_\bo_\bn_\b-_\bp_\ba_\br_\ba_\bm_\be_\bt_\be_\br
87 Alter the intercept adaptation parameter for the Holt-Winters
88 forecasting algorithm. This parameter must be between 0 and 1.
90 -\b--\b-b\bbe\bet\bta\ba _\ba_\bd_\ba_\bp_\bt_\bi_\bo_\bn_\b-_\bp_\ba_\br_\ba_\bm_\be_\bt_\be_\br
91 Alter the slope adaptation parameter for the Holt-Winters fore-
92 casting algorithm. This parameter must be between 0 and 1.
94 -\b--\b-g\bga\bam\bmm\bma\ba _\ba_\bd_\ba_\bp_\bt_\bi_\bo_\bn_\b-_\bp_\ba_\br_\ba_\bm_\be_\bt_\be_\br
95 Alter the seasonal coefficient adaptation parameter for the
98 -\b--\b-g\bga\bam\bmm\bma\ba-\b-d\bde\bev\bvi\bia\bat\bti\bio\bon\bn _\ba_\bd_\ba_\bp_\bt_\bi_\bo_\bn_\b-_\bp_\ba_\br_\ba_\bm_\be_\bt_\be_\br
99 Alter the seasonal deviation adaptation parameter for the
103 This option causes the aberrant behavior detection algorithm to
104 reset for the specified data source; that is, forget all it is
106 sets the intercept and slope coefficients to unknown. For the
110 tion history. Note that reset does not erase past predictions
116 Due to the implementation of this option, there is an indirect
117 impact on other data sources in the RRD. A smoothing algorithm
118 is applied to SEASONAL and DEVSEASONAL values on a periodic
119 basis. During bootstrap initialization this smoothing is
120 deferred. For efficiency, the implementation of smoothing is
121 not data source specific. This means that utilizing reset for
122 one data source will delay running the smoothing algorithm for
123 all data sources in the file. This is unlikely to have serious
124 consequences, unless the data being collected for the non-reset
125 data sources is unusually volatile during the reinitialization
126 period of the reset data source.
128 Use of this tuning option is advised when the behavior of the
129 data source time series changes in a drastic and permanent man-
130 ner.
133 "rrdtool tune data.rrd -h in:100000 -h out:100000 -h through:100000"
135 Set the minimum required heartbeat for data sources 'in', 'out' and
136 'through' to 10'000 seconds which is a little over one day in data.rrd.
137 This would allow to feed old data from MRTG-2.0 right into RRDtool
138 without generating *UNKNOWN* entries.
141 "rrdtool tune monitor.rrd --window-length 5 --failure-threshold 3"
144 9 and the default failure-threshold is 7. This command now defines a
145 failure as 3 or more violations in a temporal window of 5 time points.
148 Tobias Oetiker <tobi@oetiker.ch>
152 1.2.28 2008-07-23 RRDTUNE(1)