Python的rrdtool模块常用方法说明

版权声明:本文为博主原创文章,未经博主允许不得转载。 https://blog.csdn.net/chengqiuming/article/details/87731317

一 点睛

rrdtool(round robin database)工具为环状数据库的存储格式, round robin是一种处理定量数据以及当前元素指针的技术。rrdtool主要用来跟踪对象的变化情况,生成这些变化的走势图,比如业务的访问流量、系统性能、磁盘利用率等趋势图,很多流行监控平台都使用到 rrdtool,比较有名的为Cacti、Ganglia、Monitorix等。更多rrdtool介绍见 官网http://oss.oetiker.ch/rrdtool/

rrdtool是一个复杂的工具,涉及较多参数概念,本篇主要通过Python的rrdtool模块对rrdtool的几个常用方法进行封装,包括create、fetch、graph、info、update等方法。

二 安装

[root@localhost ~]# yum install python-rrdtool

三 rrdtool模块常用方法说明

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:dsname: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指定查询记录的开始与结束时间,默认可省略

猜你喜欢

转载自blog.csdn.net/chengqiuming/article/details/87731317