关于RRD的介绍和示例代码请翻阅以前的文章,本篇只写一些步骤操作。网上资料很多但感觉还是有很多概念混淆等
首先是创建RRD实例,首先你需要一个后缀为.rrd
的File文件。
RRD数据库创建和表定义
- 创建RRD实例
//rrdFile rrd文件
//insertTime 大概意思就是创建时间
//nDataStoreRate step也就是rrd的存储频率
RrdDef rrdDef = new RrdDef(rrdFile, insertTime-nDataStoreRate, nDataStoreRate);
- 添加DS
//添加DS(DataScource 也就是资源),说白了就是关系型数据库的列名,它可以设置多个,最大名称长度20个字符
//attributeName 列名
//DsTypes.DT_GAUGE 是数据类型
//3 * nDataStoreRate 心跳指数
//Double.NaN
rrdDef.ashujusource(attributeName, DsTypes.DT_GAUGE,3 * nDataStoreRate, 0, Double.NaN);
- attribugeName就不废话了,列名
- 数据类型有四种,具体哪四种,翻我以前的文章,转过,不可自定义
- 心跳的意思就是,如果超过这个时长你没有更新存储数据,它就给你存NaN(Not a Number),一般设置为存储频率的2-3倍,别太小。
- 第四个参数,不解释,就是第三个参数超时的时候存的东东。
我用到的就这几个,当然你也可以设置取值区间最大值、最小值,如果超出区间数值就是UNKNOW,具体操作我在最后把Jrobin的手册地址附上自己查。
- RRA(归档)
有些时候,我们需要查询最近一天、一周、一个月、一年的数据。这个时候如果我们用原始存储的数据也就是5分钟存一次的数据,这个量是非常大的,这个时候就需要RRA。一个rrd文件可以有多个RRA。我们称基础采集到的数据为PDP,RRA的是CDP,一个CDP是由多个PDP计算得出来的。
//首先第一个参数,直译取平均值,数量是1,一共存储288条 也就是一天
//MAX、MIN、LAST(最后一个)、AVERAGE
rrdDef.addArchive("AVERAGE", 0.5, 1, 288);
//一周
rrdDef.addArchive("AVERAGE", 0.5, 7, 288);
//一个月
rrdDef.addArchive("AVERAGE", 0.5, 30, 288);
....以此类推
这个0.5叫xff系数。大概的意思是这个样子的:
以一个月的为例,取平均,系数0.5,条数30,该RRA一共存储288条。
白话:30条数据,如果这其中有15条是有效的不是NaN,那我就求平均,给它合成一条,然后这样的数据我一共要存288条。
- 生成RRD对象
//这个RrdDbPool可以防止一次性开太多的rrd文件等...很智能的玩意,具体看手册
rrdDb = RrdDbPool.getInstance().requestRrdDb(rrdDef);
到这里其实我们的rrd数据库表就建完了。
//rrd对象用完记得释放
RrdDbPool.getInstance().release(rrdDb);
RRD数据库,数据插入
//insertTime是插入时间
Sample sample = rrdDb.createSample(insertTime);
//attributeName 列名 value 值
sample.setValue(attributeName, value);
//操作完之后需要update一下子
sample.update();
RRD数据库,数据查询
RrdDb rrd = new RrdDb("D:/test/jrobin/demo_flow.rrd");
//这个第一个参数需要和存的时候的保持一致
//第二个参数是查询开始时间
//第三个参数是查询结束时间
//第四个参数是提取分辨率,当多个RRA符合标准时就靠它了,这个参数是可选的
FetchRequest request = rrd.createFetchRequest("AVERAGE", Util.getTime()-(86400), Util.getTime(),604800);
然后就是正常的获取数据了不做阐述.....翻之前的文章。
RRD读取时的读取机制,它的读取机制是智能根据查询开始时间和结束时间,来匹配合适的RRA。
举个例子:
假设你有一个RRA 有 600 个记录,每个记录相隔300秒,则总的时间覆盖范围是180000 秒≈2天,那么如果你的查询时间范围大于2天,那么它就不会匹配到这个RRA,如果你还有一个3天范围的RRA和一个4天范围的RRA,它会优先给你这个3天范围的RRA,这个前提是你没有设定createFetchRequert的“提取分辨率属性”,如果你设置了那么以提取分辨率属性为准。
提取分辨率(resolution),就是RRA俩条数据之间的那个时间差,当有多个RRA符合查询条件的时候,如果不指定resolution默认使用resolution 小的那个RRA,如果指定就取和resolution 参数相等的RRA。
手册地址
Jrobin的手册地址:
有啥不明白的去查
Jrobin手册