1. 程式人生 > >python學習-python與rrdtool的結合模塊

python學習-python與rrdtool的結合模塊

rrdtools

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等方法,本節對rrdtool的基本知識不展開說明,重點放在Python rrdtool模塊的常用方法使用介紹上。

rrdtool模塊的安裝方法如下:

easy_install python-rrdtool    #pip安裝方法  
pip install python-rrdtool    #easy_install安裝方法   
#需要rrdtool工具及其他類包支持,CentOS環境推薦使用yum安裝方法  
# yum install rrdtool-python

rrdtool模塊常用方法說明

下面介紹rrdtool模塊常用的幾個方法,包括create(創建rrd)、update(更新rrd)、graph(繪圖)、fetch(查詢rrd)等。

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: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]]]方法,根據指定的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指定查詢記錄的開始與結束時間,選項的值必是 timestamp 的格式,默認可省略。
獲取當前時間的時間戳:date +%s

python學習-python與rrdtool的結合模塊