简介这是一份 RRDTool 1.4.7 稳定版源码包适合系统运维、网络监控工程师及需要基于时序数据做可视化分析的开发者。RRDTool 是 Smokeping、Cacti、MRTG 的公共底层组件负责网络流量、CPU、内存等指标的高效入库、聚合与绘图拿到压缩包即可完成本地编译安装也为二次开发提供了完整 C 源码。包内共 314 个文件约 1.29MB以 49 个 .c、22 个 .h 源码文件为主体另有 configure、Makefile 等构建脚本31 个 POD 文档、31 个 HTML 帮助页、30 个 TXT 说明及大量 man 手册编译、配置、rrdcached 缓存守护进程与绘图 API 均有覆盖。已有 263 人浏览学习。通过阅读源码与文档可以深入理解环形数据库、Heartbeat 更新策略、RPN 绘图语法等关键机制包内目录结构清晰源码、文档与构建脚本分层存放便于按需查找尤其适合在集成 Cacti、MRTG、Smokeping 时定位数据采集、存储和出图环节的问题同时也有助于理解历史数据归档与压缩的实现思路。 手头正好有个老项目的监控要维护翻到了服务器上那份rrdtool-1.4.7.tar.gz源码包。提到 rrdtool干运维和监控的老哥应该都不陌生——Cacti、Zabbix 老版本、还有一堆自研监控系统底层画趋势图、存时序数据用的都是它。虽然现在 influxdb、prometheus 这些新秀不少但在很多存量系统里rrdtool 依旧在默默干活而且它的设计思路非常值得学对你理解任何一款时序数据库都有帮助。这篇文章我就从这份rrdtool-1.4.7.tar.gz说起把从解压、编译、装到rrdtool create/update/graph整套手动实操走一遍顺带把 tar.gz 的常用解压命令和踩过的坑都整理出来给需要在自己机器上手动折腾一套 RRD 环境的朋友当个参考。1. RRDtool 是什么为什么很多监控系统都在悄悄用它1.1 环形数据库这个思路才是 rrdtool 的灵魂RRDtool 全称是 Round Robin Database Tool也就是轮转数据库工具。它和 MySQL 这类动不动就上 GB 的存储不太一样设计目标只有一个用固定大小的磁盘空间高效地存储和展示随时间变化的数据点。很多人刚接触“环形数据库”这个概念会有点懵我习惯用一个“老板交办写工作日志”的比方解释假设公司只给你一本固定 100 页的本子写满了怎么办不是再买新本子而是从第 1 页开始覆盖旧记录保留最近 100 天的工作情况。rrdtool 干的事情就是这样——它把存储空间划分成一个个“归档位”新数据写进来、旧数据被循环覆盖。因此无论你监控了多少年rrdtool 数据文件的大小都基本保持不变不会像日志那样无限膨胀。当年 Cacti 之所以能在小内存机器上跑得动几百台设备的流量图靠的就是 rrdtool 这种极省空间的存储模型。1.2 1.4.7 这个版本为什么现在还值得装rrdtool 已经发展到了 1.8.x但rrdtool-1.4.7这个版本在很多老系统的私有源里依然被长期使用CentOS 6/7 时期编译的监控套件大量依赖它。它的价值在于第一依赖相对简单编译难度低第二1.4.x 和 1.8.x 在核心数据结构与命令语法上基本一致你学会了 1.4.7 的操作新版本拿到手也能很快上手。我自己维护的采集脚本跑的就是这个版本稳定几年没出过乱子。所以拿这个版本来完整跑一遍安装、建库、画图流程既不耽误理解原理也不怕踩新版本那些奇奇怪怪的坑。1.3 哪些人适合亲手过一遍这套东西运维工程师、监控岗需要给公司自研系统加一个趋势图模块。对时序数据库、数据归档Consolidation机制感兴趣的开发。想读懂 Cacti/Zabbix 老版本数据存储逻辑的人。2. 从 tar.gz 解压到编译安装一步步搞定 rrdtool2.1 tar.gz 到底是什么解压命令逐参数拆解拿到一个xxx.tar.gz文件很多人第一反应就是“解压”但到底怎么解压、为什么命令里带z和v可能没细想过。其实tar.gz是两层概念的合体tar负责打包——把一堆文件合成一个归档文件而.gz是 gzip 压缩负责把归档文件压缩体积。解压时就要分两步思维先解压缩再拆包。在 Linux 下最常用的解压命令就这一条tar -zxvf rrdtool-1.4.7.tar.gz四个参数的含义可以这样记-z表示这是一个 gzip 压缩格式的归档让 tar 先通过 gzip 解压。-xextract执行解包从归档中提取文件的操作。-vverbose把解压出来的文件名逐个打印到屏幕上方便你看到进度。-f指定归档文件名后面必须紧跟包名这个参数建议放在最后。如果遇到.tar.bz2结尾的包把z换成j即可tar -jxvf package.tar.bz2而.tar.xz则需要用J参数。记住这三个日常处理 Linux 源码包基本就够用了。还有一种纯.tar无压缩格式去掉z就行。当时我第一次手动敲tar -xvf去解.tar.gz发现也能解出文件因为新版 tar 能自动识别压缩格式但为了严谨和兼容老系统建议还是按格式加全参数。2.2 配置 configure 和依赖库提前把编译环境弄清楚解压完后进入目录rrdtool-1.4.7惯例的三步走是./configure、make、make install。但这里非常容易出现第一个劝退点configure 检查依赖不通过。RRDtool 的绘图功能依赖libpng、freetype、zlib等图形字体库而底层又需要libxml2和pango/cairo相关模块。如果系统里没装对应的开发包带-devel后缀configure 会报类似checking for pkg-config... no或者找不到libart-2.0的错误。我的建议是先装基础依赖再 configure# CentOS/RHEL 系列 yum install -y gcc make libtool pkgconfig libpng-devel freetype-devel zlib-devel libxml2-devel pango-devel cairo-devel # Debian/Ubuntu 系列 apt-get install -y build-essential autoconf automake libtool pkg-config libpng-dev libfreetype6-dev zlib1g-dev libxml2-dev libpango1.0-dev libcairo2-dev有一点要提醒1.4.7 在 configure 阶段默认会检查tcl模块如果你的机器上没装 tcl或者并不打算用 rrdtool 的 tcl 接口编译时可以直接禁用省去一堆麻烦。我的配置参数是这样的./configure --prefix/usr/local/rrdtool --disable-tcl--prefix指定安装目录的好处是以后想卸载就把整个目录删掉不会污染系统路径但代价是安装后需要手动配置动态库搜索路径和 PATH下面马上讲。还可以加一个--disable-python如果你只需要 C 接口和命令行事的话。2.3 make 编译和 make install遇到细节别慌configure 没报错后面基本就顺了make make install在这里我想多说一个注意事项如果你在 configure 阶段提示某些功能找不到但又没有影响最终生成 Makefile务必要回头看配置输出的 Summary。有时候--disable-tcl生效了但某些模块依旧被标记成“disabled”而不是你想要的状态比如rrd_graph功能被误跳过最后安装完发现rrdtool graph无法使用那就尴尬了。编译完可以通过以下手段检查核心命令是否正常/usr/local/rrdtool/bin/rrdtool --version如果看到版本号1.4.7输出说明安装成功。接下来还需要设置环境变量否则直接敲rrdtool会提示命令找不到echo export PATH/usr/local/rrdtool/bin:$PATH /etc/profile.d/rrdtool.sh echo export LD_LIBRARY_PATH/usr/local/rrdtool/lib:$LD_LIBRARY_PATH /etc/profile.d/rrdtool.sh source /etc/profile.d/rrdtool.shLD_LIBRARY_PATH是动态链接库搜索路径这步不做后面运行rrdtool会报error while loading shared libraries: librrd.so.4: cannot open shared object file之类的错误。如果你不想改全局环境变量也可以装完后用ldconfig把库路径写入系统缓存echo /usr/local/rrdtool/lib /etc/ld.so.conf.d/rrdtool.conf ldconfig两种方式二选一我习惯用环境变量方式因为不依赖系统级别的 ldconfig 管理多版本共存时不至于打架。3. 核心数据结构一把梭create、update、fetch 上手即用3.1 DS、DST、RRA、CF这几个缩写必须搞懂安装好 rrdtool 只是第一步真正学会用它还得明白那几条核心命令背后的数据模型。rrdtool 的存储单元叫 RRD 文件你可以把它想象成一个二维环形表格行对应时间列对应监控项数据源 DSData Source。在创建 RRD 文件时你需要指定每个数据源的类型DSTData Source Type最常用的有GAUGE直接存当前值CPU 温度、内存使用量之类。COUNTER存递增值的变化率网卡流量、请求计数就是这种底层会自动套用速率计算。DERIVE和 COUNTER 类似不过允许值为负。ABSOLUTE用于“重启归零”的计数型数据。随着时间推进数据点先进入“心跳”机制管理的缓冲区间按期聚合成“主数据点”PDPPrimary Data Point。rrdtool 内部再把若干 PDP 通过归并函数CFConsolidation Function浓缩成“归档数据点”CDPConsolidated Data Point存到预先规划好的 RRARound Robin Archive归档区域比如 5 分钟一个点的归档存 1 年或者 1 小时一个点的归档存 5 年。说得直白点越老的数据分辨率越低但历史时间跨度越长这就是为什么 rrdtool 文件体积能做到固定不变的关键。3.2 手把手创建一张 5 分钟粒度的 RRD 文件假定要监控一台 Linux 服务器的 CPU 温度每 300 秒采集一次原始数据打算保留 2 天的精细数据每 5 分钟一个点和 30 天的粗粒度数据每 30 分钟聚合一个平均点。创建命令如下rrdtool create temp.rrd \ --start now-2d \ --step 300 \ DS:temp:GAUGE:600:0:100 \ RRA:AVERAGE:0.5:1:576 \ RRA:AVERAGE:0.5:6:1440逐个字段解释一下免得命令写对了但不知道含义--startRRD 文件起始时间。设置为now-2d是为了给数据预留一个回溯窗口如果不指定默认从当前时刻开始。--step主数据点采集间隔单位秒这里 300 秒一次。DS:temp:GAUGE:600:0:100名字叫temp的数据源类型 GAUGE600是心跳超时阈值如果超过 600 秒没有收到新值该区间标记为 UNKNOWN 未知0和100是合法值范围下限、上限。RRA:AVERAGE:0.5:1:576CF 为 AVERAGE0.5是 xfiles factor允许合并时段内最多 50% 的未知数据否则归档点也标 UNKNOWN1表示每 1 个主数据点合并一次576表示最多存 576 个点即 300 × 576 172800 秒正好 2 天。RRA:AVERAGE:0.5:6:1440每 6 个主数据点即 30 分钟合并一个平均值存 1440 个点即 30 天。建完之后用rrdtool info temp.rrd能看到刚定义的 DS 和 RRA 信息这些参数会直接决定你后续查询与画图时的数据姿态。3.3 更新数据和快速验证往 RRD 文件里塞数据用rrdtool update固定格式是“时间戳:数值”如果没有特殊回溯需求直接用N代表当前时间rrdtool update temp.rrd N:52.5 rrdtool update temp.rrd N:55.3可以写个 for 循环连续写入几十个随机温度值模拟效果for i in $(seq 1 30); do rrdtool update temp.rrd N:$((RANDOM % 20 40)) sleep 1 done注意实际生产采集不是 sleep 1 秒提交而是按你定义的 step比如 300 秒定时写入一次。如果写入间隔超过了心跳阈值600 秒rrdtool 就会把那一段标记为 UNKNOWN画出来的图会断线。要查看历史数据用fetchrrdtool fetch temp.rrd AVERAGE --start -3600 --end now它会按照 RRA 归档粒度输出时间戳和对应平均值--start和--end控制查询窗口这个窗口范围要尽量落在第二步 RRA 覆盖的范围内否则拿不到数据或精度不足。4. 用 graph 把枯燥数字变成一眼看懂的曲线图4.1 画图最简公式DEF 定义数据 图形指令输出数据填进去最终目的是给人看。rrdtool graph支持输出 PNG 图片我的经验是先把它当成“数据筛选 图形绘制”两段式命令理解。前半段用DEF从 RRD 文件里取出变量后半段决定画成线LINE还是填充区AREA。画一张最近 24 小时温度曲线的命令如下rrdtool graph temp.png \ --start -86400 --end now \ --width 800 --height 300 \ DEF:temptemp.rrd:temp:AVERAGE \ LINE2:temp#FF0000:CPU Temperature参数不复杂--start和--end很直观指定绘图的时间窗口。DEF:temptemp.rrd:temp:AVERAGE把temp.rrd中名为temp的数据源用 AVERAGE 归并函数取值赋给虚拟变量temp。LINE2:temp#FF0000:CPU Temperature是画一条 2px 宽的红色曲线后面的字符串是图例名。最终会生成一张 PNG 图坐标轴自动适配开箱即用。这里有一个特别坑的地方如果你建库时的 RRA 里没有覆盖查询窗口的归档画图时会提示“No data points in graph”解决办法不是调整窗口而是回去补建一个更长周期的 RRA。4.2 多条数据叠加、面积填充和时间范围模板监控场景很少只画一条线。假如还要加一个内存占用率可以先建一个包含两个 DS 的 RRD 文件再在 graph 命令里并列两个 DEF 和两个 LINE。我把平时常用的模板写在这直接改名字就能用rrdtool graph system.png \ --start -6h --end now \ --width 900 --height 350 \ --title System Load Mem Usage (6h) \ --vertical-label Percent (%) \ --lower-limit 0 --upper-limit 100 \ DEF:loadsys.rrd:load:AVERAGE \ DEF:memsys.rrd:mem:AVERAGE \ AREA:load#00A000:Load Avg \ LINE2:mem#0000FF:Memory Usage \ COMMENT:\n个人经验是AREA适合展示“总量型”数据有直观的占比感LINE适合展示波动型数据避免大面积色块干扰。两条线用色时要考虑红绿色盲用户蓝黄配色比红绿更稳妥。在自动化监控页面里图例名里可以拼上中文或时间标签但要注意字体问题下一节专门说。4.3 中文乱码和字体问题的终极解决方案rrdtool 绘制图形时默认字体路径很多并不包含中文字体直接在图例里写中文会变成豆腐块或方框。处理办法是给 graph 命令增加--font参数指定一个系统中文字体文件的绝对路径。比如 Linux 上装了wqy-zenhei字体后路径通常是rrdtool graph temp.png \ --font DEFAULT:12:/usr/share/fonts/wqy-zenhei/wqy-zenhei.ttc \ --start -86400 --end now \ DEF:temptemp.rrd:temp:AVERAGE \ LINE2:temp#FF0000:CPU 温度如果你的系统没装中文包优先安装# CentOS yum install -y wqy-zenhei-fonts # Ubuntu apt-get install -y fonts-wqy-zenhei要验证字体是否生效也很简单生成 PNG 后右键图片属性或者直接看图图例里能正常显示中文就说明路径没错。还有一个小细节--font参数的默认值配置会影响全部文字如果只想改图例可以写成--font LEGEND:12:字体路径具体分类名可以用--help查看。5. 常见问题与排查技巧实录5.1 configure 检查不通过报错信息杂怎么快速定位编译期最常见的报错就是依赖缺失解决思路是“缺什么补什么”。重点看 configure 输出里checking for libXXX... no的字段然后去装对应的-devel包。比如报checking for pkg-config... no直接yum install pkgconfig。如果 configure 报了语法错误很可能是 automake 版本过旧执行autoreconf -i重生成配置脚本后再 configure。有一个我踩过的真实案例编译时提示找不到libpango-1.0但我确认系统已经装了pango-devel。后来发现是 64 位系统下 pkg-config 的搜索路径没有包含/usr/lib64/pkgconfig解决办法是指定环境变量export PKG_CONFIG_PATH/usr/lib64/pkgconfig:$PKG_CONFIG_PATH ./configure --prefix/usr/local/rrdtool --disable-tcl5.2 装好了命令也找得到但运行时提示找不到共享库这几乎都是动态链接库路径没配置到位导致的。按前面的LD_LIBRARY_PATH设置后仍不行可以用ldd /usr/local/rrdtool/bin/rrdtool查看哪些.so显示“not found”再根据缺少的库名做软链或配置。比如缺librrd.so.4就确认/usr/local/rrdtool/lib下是否有该文件有的话软链到系统库路径ln -s /usr/local/rrdtool/lib/librrd.so.4 /usr/lib64/librrd.so.45.3 数据更新正常但 graph 画不出完整曲线中间全是断点断点出现的原因大概率是写入间隔超出了心跳值。比如 step 是 300 秒、心跳是 600 秒但采集脚本因为某种原因每隔 900 秒才写一次rrdtool 认为中间超过 600 秒未更新的区间全部不可信标记为 UNKNOWN画图自然就断了。解决办法是推后写入频率或者把 heartbeat 调大比如改成7200允许最多两小时的静默。但要小心心跳值不能小于 step否则会频繁出现 UNKNOWN。5.4 图表时间轴偏移 8 小时跟本地时间对不上jrrd 工具链很多默认按 UTC 处理时间。如果生成的 PNG 横轴显示的时间和服务器本地时间差出 8 小时多半是没设置TZ环境变量或者 rrdtool 编译时用了系统时区。临时解决是在调用 graph 前加export TZAsia/Shanghai rrdtool graph ...更稳妥的办法是在系统层面把/etc/localtime指到正确时区。这个坑在定时任务里尤其明显crontab 环境变量精简容易让你误以为是 rrdtool 在乱报时间。5.5 高频写入导致性能下降要不要调小 step我一直强调“先定 step再定存储周期”是因为 step 越小主数据点越多RRA 计算和磁盘写入越频繁。有人为了追求实时性把 step 设成 10 秒结果监控上百个指标时 RRD 文件写入成为瓶颈最终整个机器负载飙高。实际情况是监控系统 90% 的场景不需要秒级精度。建议先以 60 秒甚至 300 秒为默认 step再把心跳调成 step 的 2 倍。如果你确实需要更细的短期数据可以像前面那样建两个 RRA一个高分辨率短周期、一个低分辨率长周期这样的性价比远高于无脑调小 step。一些小体会从rrdtool-1.4.7.tar.gz出发完整的流程走下来你会发现它不只是一个会画折线图的小工具更是一套约定了清晰存储模型的时序数据处理方案。特别是环形归档这个设计放到今天看也一点不过时。我个人在实际使用中最大的体会是rrdtool 的命令行选项非常多但常用场景就那几条创建之前一定想清楚采集粒度、保留周期和绘图精度三者怎么匹配。很多人用不好 rrdtool并不是命令不会敲而是数据模型没想透建库参数拍脑袋后面画图取数就各种别扭。如果你准备在自己服务器上长期维护监控数据我建议把这篇文章里的命令整理成一份初始化脚本每次都按同一套参数建库。顺便再说个小技巧rrdtool 对旧数据查询很方便定时脚本里用rrdtool fetch --start -30d把历史数据导出后哪怕将来迁移到别的监控平台底层数据也还能复用。技术换代快但老工具解决时序问题的那套思路真的值得你花一个下午好好感受感受。本文还有配套的精品资源点击获取