一,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") # 绘制出流量最小值