一，python-rrdtool模块安装。
切记！！！ 这个rrdtool模块，在windows环境下安装太费劲，就是因为没安装上所以现在改成了在ubuntu环境下开发，原来没有体会过，现在可真是体会过了。。。。。。
安装命令：pip install python-rrdtool
二，python 封装的rrdtool方法解析
# 1,rrdtool.first(filename) 返回第一个rra 第一次数据更新（采集）的时间戳
fist_time = rrdtool.first('static/rrdfiles/downloads.rrd')
print time.strftime("%Y-%m-%d %H:%M:%S",time.localtime(fist_time))
# 2017-02-21 14:13:00 # 2,rrdtool.last(filename) 返回第一个rra 最近一次数据更新（采集）的时间戳
last_time = rrdtool.last('static/rrdfiles/downloads.rrd')
print time.strftime("%Y-%m-%d %H:%M:%S",time.localtime(last_time))
# 2017-02-22 02:12:00 # 3, rrdtool.damps() 将rrd文件转换成xml文件
# damps = rrdtool.dump('static/rrdfiles/downloads.rrd')
# print(damps) # 4, rrdtool.info(filename) 将rrd文件的结构信息以字典的形式表现起来.
info = rrdtool.info('static/rrdfiles/downloads.rrd')
# print(info)
# print(info["ds[metric].type"]) # GAUGE
# print(info["ds[metric].value"]) # 0.0 # 5, rrdtool.fecth fetch(args..): fetch data from an rrd.
mge1 = rrdtool.fetch("static/rrdfiles/downloads.rrd","AVERAGE")
print(mge1[1][0]) # metric 一个ds名，如果要是监测多个ds,应该是一个元祖多个值. # 6, rrdtool.graph() # 绘图（下面会详细说明）
# 7，rrdtool.create() #创建一个rrd文件（还没有具体用到，以后学习在补充）
#create filename [--start|-b start time] [--step|-s step] [DS:ds-name:DST:heartbeat:min:max] [RRA:CF:xff:steps:rows
# 8, rrdtool.resize()指定-->为rrd文件中的rra数据增加或者减少行数,并生成新文件resize.rrd 不改变源文件。
# size = rrdtool.resize("static/rrdfiles/downloads.rrd","1",'GROW',["10",])(文件，具体哪个rra(从0开始),增加|减少，["具体多少行",])
#9,rrdtool.tune(args___) 可对原rrd文件进行更改,更改心跳值,最大值,最小值,数据源,ds变量名.
#tune filename [--heartbeat|-h ds-name:heartbeat] [--minimum|-i ds-name:min] [--maximum|-a ds-name:max] [--data-source-type|-d ds-name:DST] [--data-source-rename|-r old-name:new-name] # 举例 更改变量名：
# tune = rrdtool.tune("static/rrdfiles/resize.rrd",'-r','metric:memory')
mge1 = rrdtool.fetch("static/rrdfiles/resize.rrd","AVERAGE")
print(mge1[1][0]) # memory
##########还有一些方法，rrdtool.xport()可以编写一个xml格式的数据保存在一个或者多个rrd文件中。 rrdtool.update() 更新，为新创建的rrd文件 插入数据。这些方法目前用不到，先就不用了。
三，rrdtool绘图即rrdtool.graph()参数的解析：
1，单参数单主机绘图详解：
title = "test (" + time.strftime('%Y-%m-%d', time.localtime(time.time())) + ")"
rrdpath = "static/rrdfiles/downloads.rrd"
rrdtool.graph("static/RRDpng/unirrd.png",
# start,end x轴的起始结束时间：
# 如果都不写,默认是从当前算起一天内的。
# 如果没有指定end,默认是从start起到现在。
# 如果没有指定start,默认是1天前到end。
#对于选取数据时：rrd文件的rra有 一天，两天，一个星期，三个月，十二个月五种（我认为可变）。
#针对你的start end 时间的设定，graph自动从相对应的rra中提取数据。
"--start","", # 监测的起始时间.
"--end","", # 检测的结束时间.
"--vertical-label=Bytes/s", #图片左侧竖着写的一段字
"--width", "", "--height", "", # 图片的宽高设置.
# "--full-size-mode", # 图片自适应.
# "--only-graph", # 图片微缩图. 一会试一下！
"--title",title, # 图片的题目.
"--upper-limit","",
"--lower-limit","", # y 轴的最高最低限制，默认最低限制就是0.
# "--x-grid", "MINUTE:12:HOUR:1:HOUR:1:0:%H", # x轴配置是很复杂的配置,如果没有极特殊，就按照默认的配置。
# "MINUTE:12"表示控制每隔12分钟放置一根次要格线 "HOUR:1"表示控制每隔1小时放置一根主要格线 "HOUR:1" # 表示控制1个小时输出一个label标签"0:%H" # 0表示数字对齐格线，%H表示标签以小时示
"DEF:ds0=%s:metric:AVERAGE"%rrdpath, # DEF:<vname>=<rrdfile>:<ds-name>:<CF>[:step=<step>][:start=<time>][:end=<time>]
# "DEF:max=%s:metric:MAX"%rrdpath,
# "DEF:min=%s:metric:MIN"%rrdpath, # DEF就是指定数据源,和CF字段.后面也可加step,start,end,用的比较少.
"AREA:ds0#00FF00", # 以面积的方式将ds0变量绘制成图表.AREA:value[#color[#color2]][:[legend][:STACK][:skipscale][:gradheight=y]
# "LINE:dso#00FF00", # 以折线的方式将ds0变量绘制成图表.LINE[width]:value[#color][:[legend][:STACK][:skipscale]
# 图表（下方罗列最大最小平均值）表现方式1：
# "VDEF:ds0max=ds0,MAXIMUM", # VDEF:vname=RPN VDEF就是通过RPN函数,返回给vname一个计算后结果.
# "VDEF:ds0aver=ds0,AVERAGE",
# "VDEF:ds0min=ds0,MINIMUM",
#
# "COMMENT:Classified display", # COMMENT就是设置图表下面的文本.
# "COMMENT:Maximum",
# "COMMENT:Average",
# "COMMENT:Minimum\\r", # 这四个是设置图标下面的显示标题.
# "AREA:ds0#00FF00:metric",
# "GPRINT:ds0max:%6.2lf %Sbps", # GPRINT:vname:CF:format GPRINT就是可将变量进行格式化输出,可以有很多指定参数.
# "GPRINT:ds0aver:%6.2lf %Sbps",
# "GPRINT:ds0min:%6.2lf %Sbps",
#图表（下方罗列最大最小平均值）表现方式2：
"HRULE:65535#FF0000:Alarm value",
# "AREA:ds0#FF0000:Alarm value",
# HRULE:value#color[:[legend][:dashes[=on_s[,off_s[,on_s,off_s]...]][ :dash-offset=offset]]]
"COMMENT:\\r", # 在网格下方输出一个换行符
"COMMENT:\\r",
"GPRINT:ds0:AVERAGE:Avg In metric\: %6.2lf %Sbps", # 绘制入流量平均值
"COMMENT: ",
"GPRINT:ds0:MAX:Max In metric\: %6.2lf %Sbps", # 绘制入流量最大值
"COMMENT: ",
"GPRINT:ds0:MIN:MIN In metric\: %6.2lf %Sbps\\r", # 绘制入流量最
# 绘制水平线，作为告警线，阈值为10
)
2，单参数多主机的绘图详解：
这个跟上面那个差不度，将多个rrd文件中的检测对象绘制成一个图：
a,这些参数的单位量级必须差不多。（举例：不能一个是3200k，一个0.32k）
b,需要更改的地方也不多，只需根据rrd文件数量设定DEF数量，根据不同的vname，设定不同的柱状图或者折线图就行了。
title = "UNIpic (" + time.strftime('%Y-%m-%d', time.localtime(time.time())) + ")"
#1,设置多个 rrd 文件
rrdpath1 = "static/rrdfiles/f2_GAUGE_60.rrd"
rrdpath2 = "static/rrdfiles/f5_GAUGE_60.rrd"
rrdtool.graph("static/RRDpng/unirrd.png",
"--start", "",
"--end", "",
"--vertical-label=Bytes/s",
"--width", "", "--height", "", # 图片的宽高设置.
"--title", title, # 图片的题目.
#2,给不同的导入多个rrd文件源及ds名。
"DEF:ds0=%s:metric:AVERAGE" % rrdpath1,
"DEF:ds1=%s:metric:AVERAGE" % rrdpath2,
#3,根据不同的ds名进行绘图。
"LINE:ds0#FF0000",
"LINE:ds1#00FF33",
# 图表（下方罗列最大最小平均值）表现方式2：
"COMMENT:\\r", # 在网格下方输出一个换行符
"COMMENT:\\r",
"GPRINT:ds0:AVERAGE:Avg In metric\: %6.2lf %Sbps", # ds0绘制平均值
"COMMENT: ",
"GPRINT:ds0:MAX:Max In metric\: %6.2lf %Sbps", # ds0绘制最大值
"COMMENT: ",
"GPRINT:ds0:MIN:MIN In metric\: %6.2lf %Sbps\\r", # ds0绘制入流量最小值
"COMMENT:\\r", # 在网格下方输出一个换行符
"COMMENT:\\r",
"GPRINT:ds1:AVERAGE:Avg In metric\: %6.2lf %Sbps", # ds1绘制平均值
"COMMENT: ",
"GPRINT:ds1:MAX:Max In metric\: %6.2lf %Sbps", # ds1绘制最大值
"COMMENT: ",
"GPRINT:ds1:MIN:MIN In metric\: %6.2lf %Sbps\\r", # ds1绘制最小值
)
3，针对与网卡流量（多参数单主机涉及简单计算的）的绘图详解：
title = "test (" + time.strftime('%Y-%m-%d', time.localtime(time.time())) + ")"
# 重点解释"--x-grid","MINUTE:12:HOUR:1:HOUR:1:0:%H"参数的作用（从左往右进行分解）
"MINUTE:12" # 表示控制每隔12分钟放置一根次要格线
"HOUR:1" # 表示控制每隔1小时放置一根主要格线
"HOUR:1" # 表示控制1个小时输出一个label标签
"0:%H" # 0表示数字对齐格线，%H表示 标签以小时显示
PNG = rrdtool.graph("Flow.png", "--start", "-1d", "--vertical-label=Bytes/s",
"--x-grid", "MINUTE:12:HOUR:1:HOUR:1:0:%H",
"--width", "", "--height", "", "--title", title,
"DEF:inoctets=static/rrdfiles/downloads.rrd:eth0_in:AVERAGE", # 指定网卡入流量数据源DS及CF
"DEF:outoctets=static/rrdfiles/downloads.rrd:eth0_out:AVERAGE", # 指定网卡出流量数据源DS及CF
"CDEF:total=inoctets,outoctets,+", # 通过CDEF合并网卡出入流量，得出总流量total
"LINE1:total#FF8833:Total traffic", # 以线条方式绘制总流量
"AREA:inoctets#00FF00:In traffic", # 以面积方式绘制入流量
"LINE1:outoctets#0000FF:Out traffic", # 以线条方式绘制出流量
"HRULE:6144#FF0000:Alarm value\\r", # 绘制水平线，作为告警线，阈值为6.1k
"CDEF:inbits=inoctets,8,*", # 将入流量换算成bit，即*8，计算结果给inbits
"CDEF:outbits=outoctets,8,*", # 将出流量换算成bit，即*8，计算结果给outbits
"COMMENT:\\r", # 在网格下方输出一个换行符
"COMMENT:\\r",
"GPRINT:inbits:AVERAGE:Avg In traffic\: %6.2lf %Sbps", # 绘制入流量平均值
"COMMENT: ",
"GPRINT:inbits:MAX:Max In traffic\: %6.2lf %Sbps", # 绘制入流量最大值
"COMMENT: ",
"GPRINT:inbits:MIN:MIN In traffic\: %6.2lf %Sbps\\r", # 绘制入流量最小值
"COMMENT: ",
"GPRINT:outbits:AVERAGE:Avg Out traffic\: %6.2lf %Sbps", # 绘制出流量平均值
"COMMENT: ",
"GPRINT:outbits:MAX:Max Out traffic\: %6.2lf %Sbps", # 绘制出流量最大值
"COMMENT: ",
"GPRINT:outbits:MIN:MIN Out traffic\: %6.2lf %Sbps\\r") # 绘制出流量最小值