


RRDUPDATE(1)                 rrdtool                 RRDUPDATE(1)


NAME
       rrdtool update - Store a new set of values into the rrd

SYNOPSIS
       rrdtool update filename [--template|-t ds-name[:ds-
       name]...]  N|timestamp:value[:value...]
       [timestamp:value[:value...] ...]

DESCRIPTION
       The update function feeds new data values into an RRD. The
       data gets time aligned according to the properties of the
       RRD to which the data is written.

       filename
               The name of the RRD you want to update.

       --template|-t ds-name[:ds-name]...
               by default, the update function expects the data
               input in the order, the data sources are defined
               in the RRD. This is not very error resistant, as
               you might be sending the wrong data into a RRD.

               The template switch allows you to specify which
               data sources you are going to update and in which
               order. If the data sources specified in the
               template are not available in the rrd file, the
               update process will abort with an error message.

       N|timestamp:value[:value...]
               The data used for updating the RRD was acquired at
               a certain time. This time can either be defined in
               seconds since 1970-01-01. Or by using the letter
               'N' the update time is set to be the current time.
               Negative time values are subtracted from the
               current time.  Getting the timing right to the
               second is especially important when you are
               working with data-sources of type COUNTER, DERIVE
               or ABSOLUTE.

               The remaining elements of the argument are DS
               updates. The order of this list is the same as the
               order the data sources were defined in the rra.
               If there is no data for a certain data-source, the
               letter U (eg. N:0.1:U:1) can be defined.

               The format of the value acquired from the data
               source is dependent of the data source type
               chosen. Normally it will be numeric, but the data
               acquisition modules may impose their very own
               parsing of this parameter as long as the colon (:)
               remains the data source value separator.

EXAMPLE
       `rrdtool update demo1.rrd N:3.44:3.15:U:23'



2002-02-26                    1.0.38                            1





RRDUPDATE(1)                 rrdtool                 RRDUPDATE(1)


       Update the database file demo1.rrd with 3 known and one
       *UNKNOWN* value. Use the current time as the update time.

       `rrdtool update demo2.rrd 887457267:U 887457521:22
       88745790:2.7'

       Update the database file demo2.rrd which expects data from
       a single data-source, three times. First with an *UNKNOWN*
       value then with two normal readings. The update interval
       seems to be around 300 seconds.

AUTHOR
       Tobias Oetiker <oetiker@ee.ethz.ch>












































2002-02-26                    1.0.38                            2


