rrdtool模块常用的几个方法，包括create（创建rrd）、update（更新rrd）、graph（绘图）、fetch（查询rrd）等。

1. Create方法
create filename [--start|-b start time] [--step|-s step] [DS:ds-name:DST:heartbeat:min:max] [RRA:CF:xff:steps:rows]方法，创建一个后缀为rrd的rrdtool 数据库，参数说明如下：
filename创建的rrdtool 数据库文件名，默认后缀为.rrd；
--start指定rrdtool条记录的起始时间，必须是timestamp的格式；
--step指定rrdtool每隔多长时间就收到一个值，默认为5分钟；
DS用于定义数据源，用于存放脚本的结果的变量；
DST用于定义数据源类型，rrdtool支持COUNTER（递增类型）、DERIVE（可递增可递减类型）、ABSOLUTE（假定前一个时间间隔的值为0，再计算平均值）、GUAGE（收到值后直接存入RRA）、COMPUTE（定义一个表达式，引用DS并自动计算出某个值）5种，比如网卡流量属于计数器型，应该选择COUNTER；
RRA用于指定数据如何存放，我们可以把一个RRA看成一个表，保存不同间隔的统计结果数据，为CF做数据合并提供依据，定义格式为：[RRA:CF:xff:steps:rows]；
CF统计合并数据，支持AVERAGE（平均值）、MAX（大值）、MIN（小值）、LAST（新值）4种方式。
2. update方法
update filename [--template|-t ds-name[:ds-name]...] N|timestamp:value[:value...] [timestamp:value[:value...] ...] 方法，存储一个新值到rrdtool数据库，updatev和update类似，区别是每次插入后会返回一个状态码，以便了解是否成功（updatev用0表示成功，–1表示失败）。参数说明如下：
filename指定存储数据到的目标rrd文件名；
-t ds-name[:ds-name]指定需要更新的DS名称；
N|Timestamp表示数据采集的时间戳，N表示当前时间戳；
value[:value...]更新的数据值，多个DS则多个值。
3. graph方法
graph filename [-s|--start seconds] [-e|--end seconds] [-x|--x-grid x-axis grid and label] [-y|--y-grid y-axis grid and label] [--alt-y-grid] [--alt-y-mrtg] [--alt-autoscale] [--alt-autoscale-max] [--units-exponent] value [-v|--vertical-label text] [-w|--width pixels] [-h|--height pixels] [-i|--interlaced] [-f|--imginfo formatstring] [-a|--imgformat GIF|PNG|GD] [-B|--background value] [-O|--overlay value] [-U|--unit value] [-z|--lazy] [-o|--logarithmic] [-u|--upper-limit value] [-l|--lower-limit value] [-g|--no-legend] [-r|--rigid] [--step value] [-b|--base value] [-c|--color COLORTAG#rrggbb] [-t|--title title] [DEF:vname=rrd:ds-name:CF] [CDEF:vname=rpn-expression] [PRINT:vname:CF:format] [GPRINT:vname:CF:format] [COMMENT:text] [HRULE:value#rrggbb[:legend]] [VRULE:time#rrggbb[:legend]] [LINE{1|2|3}:vname[#rrggbb [:legend]]] [AREA:vname[#rrggbb[:legend]]] [STACK:vname[#rrggbb[:legend]]]方法，根据指定的rrdtool数据库进行绘图，关键参数说明如下：
filename指定输出图像的文件名，默认是PNG格式；
--start指定起始时间；
--end指定结束时间；
--x-grid控制X轴网格线刻度、标签的位置；
--y-grid控制Y轴网格线刻度、标签的位置；
--vertical-label指定Y轴的说明文字；
--width pixels指定图表宽度（像素）；
--height pixels指定图表高度（像素）；
--imgformat指定图像格式（GIF|PNG|GD）；
--background指定图像背景颜色，支持#rrggbb表示法；
--upper-limit指定Y轴数据值上限；
--lower-limit指定Y轴数据值下限；
--no-legend取消图表下方的图例；
--rigid严格按照upper-limit与lower-limit来绘制；
--title图表顶部的标题；
DEF:vname=rrd:ds-name:CF指定绘图用到的数据源；
CDEF:vname=rpn-expression合并多个值；
GPRINT:vname:CF:format图表的下方输出大值、小值、平均值等；
COMMENT:text指定图表中输出的一些字符串；
HRULE:value#rrggbb用于在图表上面绘制水平线；
VRULE:time#rrggbb用于在图表上面绘制垂直线；
LINE{1|2|3}:vname使用线条来绘制数据图表，{1|2|3}表示线条的粗细；
AREA:vname使用面积图来绘制数据图表。
4. fetch方法
fetch filename CF [--resolution|-r resolution] [--start|-s start] [--end|-e end]方法，根据指定的rrdtool数据库进行查询，关键参数说明如下：
filename指定要查询的rrd文件名；
CF包括AVERAGE、MAX、MIN、LAST，要求必须是建库时RRA中定义的类型，否则会报错；
--start --end指定查询记录的开始与结束时间，默认可省略。

本文出自《Python自动化运维 技术与佳实践》
————————————————
版权声明：本文为CSDN博主「冰 河」的原创文章，遵循CC 4.0 BY-SA版权协议，转载请附上原文出处链接及本声明。
原文链接：https://blog.csdn.net/l1028386804/article/details/78989364