RRDTUNE

Section: rrdtool (1)
Updated: 2001-02-21
Index
Return to Main Contents

NAME

rrdtool tune - Modify some basic properties of a Round Robin Database

SYNOPSIS

DESCRIPTION

The tune option allows you to alter some of the basic configuration values stored in the header area of a Round Robin Database (RRD). All these tunable parameters together decide when data fed into an RRD is to be regarded as invalid. Invalid data is entered into the database as *UNKNOWN*.

The main application of the tune function is to relax the validation rules on an RRD. This allows to fill a new RRD with data available in larger intervals than what you would normally want to permit.

filename: The name of the RRD you want to tune.
--heartbeat|-h ds-name:heartbeat: modify the heartbeat of a data source. By setting this to a high value the rrd will accept things like one value per day ...
--minimum|-i ds-name:min: alter the minimum value acceptable as input from the data source. Setting min to 'U' will disable this limit.
--maximum|-a ds-name:max: alter the maximum value acceptable as input from the data source. Setting max to 'U' will disable this limit.
--data-source-type|-d ds-name:DST: alter the type DST of a data source.
[--data-source-rename|-r old-name:new-name]: rename a data source

EXAMPLE

"rrdtool tune data.rrd -h in:100000 -h out:100000 -h through:100000"

Set the minimum required heartbeat for data sources 'in', 'out' and 'through' to 10000 seconds which is a little over one day in data.rrd. This would allow to feed old data from mrtg-2.0 right into rrdtool without generating *UNKNOWN* entries.

AUTHOR

Tobias Oetiker <oetiker@ee.ethz.ch>

This document was created by man2html, using the manual pages.
Time: 12:23:06 GMT, April 23, 2024