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 使用get_argument获取url query参数
Apr 28 Python
python3+requests接口自动化session操作方法
Oct 13 Python
Python 堆叠柱状图绘制方法
Jul 29 Python
基于python实现的百度音乐下载器python pyqt改进版(附代码)
Aug 05 Python
Python中list循环遍历删除数据的正确方法
Sep 02 Python
Python解释器及PyCharm工具安装过程
Feb 26 Python
Python基于callable函数检测对象是否可被调用
Oct 16 Python
Python os库常用操作代码汇总
Nov 03 Python
python matplotlib工具栏源码探析二之添加、删除内置工具项的案例
Feb 25 Python
python基础学习之递归函数知识总结
May 26 Python
总结Pyinstaller打包的高级用法
Jun 28 Python
python开发人人对战的五子棋小游戏
May 02 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
深入了解php4(1)--回到未来
2006/10/09 PHP
PHP连接MSSQL方法汇总
2016/02/05 PHP
JavaScript 应用技巧集合[推荐]
2009/08/30 Javascript
window.ActiveXObject使用说明
2010/11/08 Javascript
JS操作Cookies包括(读取添加与删除)
2012/12/26 Javascript
JS异常处理的一个想法(sofish)
2013/03/14 Javascript
用jquery等比例控制图片宽高的具体实现
2014/01/28 Javascript
jquery删除ID为sNews的tr元素的内容
2014/04/10 Javascript
JavaScript中获取高度和宽度函数总结
2014/10/08 Javascript
基于JS实现新闻列表无缝向上滚动实例代码
2016/01/22 Javascript
javascript动态获取登录时间和在线时长
2016/02/25 Javascript
AngularJS控制器继承自另一控制器
2016/05/09 Javascript
JavaScript生成带有缩进的表格代码
2016/06/15 Javascript
canvas时钟效果
2017/02/16 Javascript
JavaScript关联数组用法分析【概念、定义、遍历】
2017/03/15 Javascript
基于JS实现网页中的选项卡(两种方法)
2017/06/16 Javascript
js获取文件里面的所有文件名(实例)
2017/10/17 Javascript
vue移动UI框架滑动加载数据的方法
2018/03/12 Javascript
JavaScript实现淘宝京东6位数字支付密码效果
2018/08/18 Javascript
python操作摄像头截图实现远程监控的例子
2014/03/25 Python
用实例详解Python中的Django框架中prefetch_related()函数对数据库查询的优化
2015/04/01 Python
Python爬虫实例扒取2345天气预报
2018/03/04 Python
详解python3中的真值测试
2018/08/13 Python
python 默认参数相关知识详解
2019/09/18 Python
Tensorflow 模型转换 .pb convert to .lite实例
2020/02/12 Python
Python enumerate内置库用法解析
2020/02/24 Python
解决Python中报错TypeError: must be str, not bytes问题
2020/04/07 Python
Python基于Serializer实现字段验证及序列化
2020/11/04 Python
CSS中几个与换行有关的属性简明总结
2014/04/15 HTML / CSS
斯洛伐克时尚服装网上商店:Cellbes
2016/10/20 全球购物
什么是触发器(trigger)? 触发器有什么作用?
2013/09/18 面试题
四风查摆剖析材料
2014/10/10 职场文书
物业工程部主管岗位职责
2015/04/16 职场文书
如何理解PHP核心特性命名空间
2021/05/28 PHP
MySQL系列之八 MySQL服务器变量
2021/07/02 MySQL
「玫瑰之王的葬礼」舞台剧主视觉图公开
2022/03/21 日漫