sevenJ's Chaos

rrdtool采用的是自己的round robin database.理解它的内部存储格式就可以知道怎么使用rrdtool。rrdtool有很多命令，其中最主要的是create命令。

rrdtool create 用法：

rrdtool create filename [--start|-b start time] [--step|-s step] [DS:ds-name:DST:dst arguments] [RRA:CF:cf arguments]

其中start time是表示数据只记录大于这个时间的值，它是以1970-01-01开始的秒数。

step表示每次记录的时间间隔。

DS:ds-name:DST:dst arguments

DS是关键字，ds-name是数据库内部表示的名字。DST有GAUGE, COUNTER, DERIVE, ABSOLUTE，COMPUTE几种。

DST defines the Data Source Type. The remaining arguments of a data source entry depend on the data
source type. For GAUGE, COUNTER, DERIVE, and ABSOLUTE the format for a data source entry is:
DS:ds-name:GAUGE | COUNTER | DERIVE | ABSOLUTE:heartbeat:min:max

For COMPUTE data sources, the format is:
DS:ds-name:COMPUTE:rpn-expression

前4种的区别:

     Values       = 300, 600, 900, 1200
     Step         = 300 seconds
     COUNTER DS   =    1,  1,   1,    1
     DERIVE DS    =    1,  1,   1,    1   (可以为负数）
      ABSOLUTE DS  =    1,  2,   3,    4
     GAUGE DS     = 300, 600, 900, 1200

RRA:CF:cf argumnets
    RRA:AVERAGE | MIN | MAX | LAST:xff:steps:rows
    RRA是关键字，CF为集合函数，可以是MIN,MAX,AVERAGE,LAST.xff表示超过这个数是认为unknow，
    steps表示计算的间隔，rows表示记录的行数。

rrdtool教程

介绍：

RRDtool是代表 “Round Robin Database tool” 。

所谓的“Round Robin” 其实是一种存储数据的方式，使用固定大小的空间来存储数据，并有一个指针指向最新的数据的位置。我们可以把用于存储数据的数据库的空间看成一个圆，上面有很多刻度。这些刻度所在的位置就代表用于存储数据的地方。所谓指针，可以认为是从圆心指向这些刻度的一条直线。指针会随着数据的读写操作自动移动。要注意的是，这个圆没有起点和终点，所以指针可以一直移动，而不用担心到达终点后就无法前进的问题。在一段时间后，当所有的空间都存满了数据，就又从头开始存放。这样整个存储空间的大小就是一个固定的数值。所以RRDtool就是使用类似的方式来存放数据的工具，RRDtool所使用的数据库文件的后缀名是 ‘.rrd’。

要加深理解rrdtool的使用，可以先了解round robin database的原理及存储结构。

rrd文件结构：

RRD术语：

ds：   Data Source (ds) providing input to the database.

dst： Data Source Type (dst).

pdp： Primary Data Point (pdp).

cf：   Consolidation Function (cf).

cdp： Consolidated Data Point (cdp) is the long term storage format for data in the rrd database.

rra： Round Robin Archive (rra). This is the place where the consolidated data points (cdp) get stored.

Create语法：

rrdtool create filename [--start|-b start time] [--step|-s step] \

[DS:ds-name:DST:dst arguments] \

[RRA:CF:cf arguments]

step：Specifies the base interval in seconds with which data will be fed into the RRD。

dst argumet： 有heartbeat:min:max组成。其中最小，最大值表示pdp的范围，可以为UNKNOW。heartbeat：表示2次采样之间最大有效的时间间隔。

CHANGELOG:

Rrdtool-1.2.28后，对pdp的取UNKNOW值有点不同。查看了changelog，原来是作为bug修复了。

参考：

http://www.rrdtool.org

http://bbs.chinaunix.net/viewthread.php?tid=864861&highlight=rrdtool