Python下rrdtool模块的基本使用方法


Posted in Python onNovember 13, 2015

最近需要用python根据收集到的数据进行绘图,决定使用rrd数据库,然后配合rrdtool来绘图,故学习一下rrdtool的用法。

用法如下:

创建:
create(...)
create(args..): Set up a new Round Robin Database
    create filename [--start|-b start time] [--step|-s step] [DS:ds-name:DST:heartbeat:min:max] [RRA:CF:xff:steps:rows]
    filename:是rrd的文件名,可以以rrd结尾。
    --step:rrdtool期望每隔多长事件收到一个值,默认是5分钟。
    --start:rrdtool第一个记录的起始时间,rrdtool不会接收任何数据的时间小于起始时间。例如你在update时给出的时间小于起始时间,则rrdtool会拒绝该值
    DS:DS用于定义数据源,是用来存放结果的变量名。该变量名在画图时会用到。
    DST:用来设置数据源的类型,有COUNTER、GUAGE、DERIVE、ABSOLUTE、COMPUTE等5种类型。
        COUNTER:数值必须是递增的
        DERIVE:和COUNTER类似,不过数据可递增可递减
        ABSOLUTE:他每次假定前一个时间间隔的值是0,然后计算平均值
        GAUGE:不做任何变化,直接存入rra中
        COMPUTE:他不接收具体值,而是定义一个表达式,然后算出某个值
    heartbeat:
    min:
    max:
    RRA:rra指定数据如何存放,他可以保存不同时间间隔的数据。力图每5分钟产生一条数据,这样一小时就是12条,如果每30分钟一条数据,这样一小时就是两条数据,这样一天,一年下来会有很多条数据,但是rrd数据库的大小是固定的,所以就有一个合并数据的方式了。这就是rra的功能。合并方式由CF指定。
    CF:CF就是用来设置数据合并的功能,有AVERAGE、MAX、MIN、LAST等4种类型,分别表示对PDP取平均、最大、最小、当前值。
    xff:xff字段设置一个比例值,rrdtool会把多个PDP合并为一个CDP,如果这写PDP中有值为UNKNOW的PDP,那么CDP的值该怎么计算,xff就是设置一个比例,当PDP中UNKNOW的比例超过多少是,就无法合成正常的CPD,合成的CPD值也为UNKNOW。
    steps:表示多少个PDP合成一个CDP
    rows:表示总共存多少个CDP?也就是可以保存多少数据?

    PDP:在每个规定的时间间隔内rrdtool都会收到一个值,rrdtool在收到该值后,根据DST的设置,会计算出另一个值,这个值就是PDP。
    CDP:rrdtool使用多个PDP合并出一个CDP,也就是执行CF的后果,然后把这个CDP的值存入rra中。

查看第一次/最后一次数据更新时间:
first(...)
first(filename): Return the timestamp of the first data sample in an RRD

last(...)
last(filename): Return the timestamp of the last data sample in an RRD

查看rrd结构信息:
info(...)
info(filename): extract header information from an rrd

取出rrd的值:
fetch(...)
fetch(args..): fetch data from an rrd.
    fetch filename CF [--resolution|-r resolution] [--start|-s start] [--end|-e end]
    filename:要取出数据的rrd文件
    --start:可选,默认是end-1day
    --end:可选,默认是now
    CF:AVERAGE、MAX、MIN、LAST。前提是你的rrd中有该类型的rra才可以。

更新rrd数据:
update(...)
update(args..): Store a new set of values into the rrd
    update filename [--template|-t ds-name[:ds-name]...] N|timestamp:value[:value...] [timestamp:value[:value...] ...]
    filename:要更新的rrd文件
    --template:
    -t ds-name[:ds-name]:设置更新那个DS的数据
    N|timestamp:时间戳,表示数据在哪个时间点采集的,N表示now。
    value[:value...]:一个rrd文件可以有多个DS,所以一次update可以更新多个value。

update插入值后,并不会有返回,无法知道插入是否正常,可以用updatev

带返回值的插入:
updatev(...)
updatev is called in the same manner as update
    和update类似,不过每次插入后会返回一个状态码。

画图:
graph(...)
graph(args..): Create a graph based on data from one or several RRD
    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]]]

    filename:图片的名称,默认是PNG格式
    --start:图片X轴数据的起始时间
    --end:图片X轴数据的结束时间
    --x-grid x-axis grid and label:
    --y-grid y-axis grid and label:
    --alt-y-grid
    --alt-y-mrtg
    --alt-autoscale
    --alt-autoscale-max
    --units-exponent
    --vertical-label text  Y轴的文字说明
    --width pixels  X轴的大小
    --height pixels  Y轴的大小
    --interlaced
    --imginfo formatstring 
    --imgformat GIF|PNG|GD  图片格式
    --background value
    --overlay value
    --unit value
    --lazy
    --logarithmic
    --upper-limit value  Y轴数据值的上限,默认会自动调整Y轴的数字
    --lower-limit value  Y轴数据值的下限
    --no-legend  取消图表下方的图例
    --rigid  严格按照upper-limit/lower-limit来绘制
    --step value
    --base value  默认1K=1000 可以调整1K=1024
    --color COLORTAG#rrggbb
    --title title  图表上方的标题
    DEF:vname=rrd:ds-name:CF 定义绘图用的数据源,也就是从那个RRD中取数据,因为RRA有多种类型,所以需要指定CF
    CDEF:vname=rpn-expression  定义合并值,
    PRINT:vname:CF:format
    GPRINT:vname:CF:format  在图表的下方输出最大值、最小值之类
    COMMENT:text  用来输出一些字符串
    HRULE:value#rrggbb  在图表上绘制水平线
    VRULE:time#rrggbb  在图表上绘制垂直线
    LINE{1|2|3}:vname  使用线条来绘制vname的数据图
    AREA:vname  使用方块来绘制vname的数据图
    STACK:vname 

下面附上一个例子:

###创建rrd
#!/usr/bin/python
import rrdtool
 
rrdb=rrdtool.create('rest.rrd','--step','60','--start','1369982786',
    'DS:input:GAUGE:120:U:U',
    'DS:output:GAUGE:120:U:U',
    'RRA:LAST:0.5:1:600',
    'RRA:AVERAGE:0.5:5:600',
    'RRA:MAX:0.5:5:600',
    'RRA:MIN:0.5:5:600')
if rrdb:
  print rrdtool.error()
 
###rrd插入数据
#!/usr/bin/python
import time
import psutil
import rrdtool
 
for keys in psutil.network_io_counters(pernic=True):
  if keys == 'em1':
    sent=psutil.network_io_counters(pernic=True)[keys][0]
    recv=psutil.network_io_counters(pernic=True)[keys][1]
    up=rrdtool.updatev('rest.rrd','N:%d:%d' % (sent,recv))
    print up
 
###根据rrd绘图
#!/usr/bin/python
import rrdtool
 
rrdtool.graph('rest.png','--start','1369983960',
    '--title','my rrd graph test',
    '--vertical-label','bits',
    'DEF:input=rest.rrd:input:LAST',
    'DEF:output=rest.rrd:output:LAST',
    'LINE1:input#0000FF:In traffic',
    'LINE1:output#00FF00:Out traffic\\r',
    'CDEF:bytes_in=input,8,*',
    'CDEF:bytes_out=output,8,*',
    'COMMENT:\\n',
    'GPRINT:bytes_in:LAST:LAST in traffic\: %6.2lf %Sbps',
    'COMMENT: ',
    'GPRINT:bytes_out:LAST:LAST out traffic\: %6.2lf %Sbps')
Python 相关文章推荐
详解Python的Django框架中的中间件
Jul 24 Python
从源码解析Python的Flask框架中request对象的用法
Jun 02 Python
Python利用matplotlib生成图片背景及图例透明的效果
Apr 27 Python
python中关于for循环的碎碎念
Jun 30 Python
python之virtualenv的简单使用方法(必看篇)
Nov 25 Python
PyCharm代码回滚,恢复历史版本的解决方法
Oct 22 Python
通过python的matplotlib包将Tensorflow数据进行可视化的方法
Jan 09 Python
使用Django简单编写一个XSS平台的方法步骤
Mar 25 Python
在Python中使用filter去除列表中值为假及空字符串的例子
Nov 18 Python
python中使用paramiko模块并实现远程连接服务器执行上传下载功能
Feb 29 Python
python实现输入三角形边长自动作图求面积案例
Apr 12 Python
pandas读取csv文件提示不存在的解决方法及原因分析
Apr 21 Python
简单了解Python下用于监视文件系统的pyinotify包
Nov 13 #Python
Python的pycurl包用法简介
Nov 13 #Python
使用Python下载歌词并嵌入歌曲文件中的实现代码
Nov 13 #Python
Python设置Socket代理及实现远程摄像头控制的例子
Nov 13 #Python
深入解析Python中的urllib2模块
Nov 13 #Python
Python下的常用下载安装工具pip的安装方法
Nov 13 #Python
Python的Flask框架的简介和安装方法
Nov 13 #Python
You might like
PHP MemCached 高级缓存应用代码
2010/08/05 PHP
PHPer 需要了解的 5 个 Composer 小技巧
2014/08/18 PHP
PHP中preg_match正则匹配中的/u、/i、/s含义
2015/04/17 PHP
分享50个提高PHP执行效率的技巧
2015/12/26 PHP
PHP实现RTX发送消息提醒的实例代码
2017/01/03 PHP
thinkPHP5.0框架命名空间详解
2017/03/18 PHP
浅谈Laravel模板实体转义带来的坑
2019/10/22 PHP
ymPrompt的doHandler方法来实现获取子窗口返回值的方法
2010/06/25 Javascript
关于JAVASCRIPT urldecode URL解码的问题
2012/01/08 Javascript
jquery、js调用iframe父窗口与子窗口元素的方法整理
2014/07/31 Javascript
Underscore.js常用方法总结
2015/02/28 Javascript
jQuery检测某个元素是否存在代码分享
2015/07/09 Javascript
jquery中ajax处理跨域的三大方式
2016/01/05 Javascript
jQuery获取及设置表单input各种类型值的方法小结
2016/05/24 Javascript
JavaScript 网页中实现一个计算当年还剩多少时间的倒数计时程序
2017/01/25 Javascript
微信小程序 引入es6 promise
2017/04/12 Javascript
jQuery中DOM常见操作实例小结
2019/08/01 jQuery
使用pkg打包ThinkJS项目的方法步骤
2019/12/30 Javascript
Python程序退出方式小结
2017/12/09 Python
tensorflow实现图像的裁剪和填充方法
2018/07/27 Python
python实现动态创建类的方法分析
2019/06/25 Python
Python获取、格式化当前时间日期的方法
2020/02/10 Python
Python实现验证码识别
2020/06/15 Python
Python暴力破解Mysql数据的示例
2020/11/09 Python
一些Unix笔试题和面试题
2013/01/22 面试题
销售自荐信
2013/10/22 职场文书
机械专业应届毕业生自荐书
2014/06/12 职场文书
鼓舞士气的口号
2014/06/16 职场文书
班级团队活动方案
2014/08/14 职场文书
关于随地扔垃圾的检讨书
2014/09/30 职场文书
2014年化验员工作总结
2014/11/18 职场文书
和谐家庭事迹材料
2014/12/20 职场文书
办公室岗位职责
2015/02/04 职场文书
实习证明模板
2015/06/16 职场文书
大学生读书笔记大全
2015/07/01 职场文书
Python如何识别银行卡卡号?
2021/06/10 Python