rrdtool 1.4.7源码编译安装指南：从解压到生成监控图

简介RRDTool 1.4.7是经典的开源时序数据存储与绘图工具广泛用于网络流量、CPU、内存等性能指标的采集和可视化也是Smokeping、Cacti、MRTG等监控系统的底层依赖。该源码包面向运维工程师和二次开发人员既可手动编译部署也可深入阅读源码理解其环形数据库结构、心跳更新机制以及图形渲染流程。资源共包含314个文件压缩后仅1.29MB以C源文件、头文件、configure配置脚本为主同时提供Perl模块、makefile模板及大量pod、html帮助文档便于在编译前查阅功能说明和API接口。已有263人学习使用适合需要自建监控平台或定制RRDTool绘图能力的读者。结合包内自带教程和man手册能够快速掌握rrdtool的创建、更新、查询与graph绘图等核心命令为网络监控和故障排查提供可靠支持。1. 解开 rrdtool-1.4.7.tar.gz为什么 2012 年的老工具今天还要装拿到rrdtool-1.4.7.tar.gz这个包第一反应通常是“又来个要编译的远古源码”。但真实场景里它出现的频率比想象中高监控系统要画流量曲线、机房要展示温度趋势、业务要出日报图后端一查依赖系统自带的 rrdtool 版本太老或根本没装而生产环境的 yum/apt 源里又只有旧版于是运维和开发就只能手动下载这个 tarball 来编译。rrdtool 全称 Round Robin Database Tool核心是环形数据库加绘图引擎用固定大小文件存时间序列数据画出来的图就是监控大屏上那些曲线。1.4.7 是 2012 年前后的稳定版至今仍被大量老项目锁定因为它的绘图 API 和 Python/Perl 绑定稳定升级到 1.7.x 后部分脚本的--start、--end参数行为有变化老项目不敢动。这篇文章就是给需要手动装它的人写的。我会从解压开始把编译参数、依赖坑、绘图验证、周边工具联动按一线做法讲清楚。适合两类人一类是被监控系统或报表脚本绑住、不得不手动装 1.4.7 的运维另一类是刚接触 tar.gz 源码包、想搞懂“解压之后到底发生了什么的”新手。1.4.7 的编译流程和现代 autotools 项目大同小异但有几个老版本特有的坑不提前避开会浪费半天时间。2. 解压与编译前的依赖检查先把环境喂饱再让 configure 跑起来2.1 tar.gz 解压的正确姿势与文件内容识别rrdtool-1.4.7.tar.gz是 gzip 压缩的 tar 归档解压命令一行bash tar -xzvf rrdtool-1.4.7.tar.gz cd rrdtool-1.4.7-x表示解压-z表示通过 gzip 解压缩-v打印解压过程便于确认文件完整-f指定文件名。解压后目录里会有configure、Makefile.in、src/、bindings/等文件。configure是 autotools 生成的脚本Makefile.in是模板src/放核心 C 源码bindings/下是 Perl、Python、Ruby 等语言绑定。看到这些就知道这是标准 autotools 项目可以走./configure make make install的老三篇。注意一个细节如果在 Windows 上用 WinRAR 或 7-Zip 解压configure脚本可能丢失可执行权限。传到 Linux 服务器后需要先chmod x configure否则会报Permission denied。Windows 解压还会把符号链接弄丢src/里如果有软链会变成普通文件编译一般不受影响但保险起见生产环境建议直接在 Linux 上解压。2.2 必须提前装好的编译工具链和基础库1.4.7 的configure对依赖检测比较严格缺一个库就报一个错。最省事的做法是先装齐这一组bashDebian/Ubuntuapt-get install -y build-essential libxml2-dev libpango1.0-dev libcairo2-dev libglib2.0-dev libpixman-1-dev zlib1g-dev libpng-dev libart-2.0-devRHEL/CentOS 7/8yum install -y gcc gcc-c make libxml2-devel pango-devel cairo-devel glib2-devel pixman-devel zlib-devel libpng-devel libart_lgpl-devel这些库的作用libxml2 是 rrdtool 的 XML 导入导出依赖cairo、pango、pixman 是绘图核心1.4.7 用 cairo 后端画图没有它编译出的 rrdtool 画图功能直接瘫痪glib 是基础数据结构库zlib 和 libpng 用来处理 PNG 输出。缺 libxml2 时 configure 报错Cannot find xml2-config缺 cairo 时报Cannot find cairo。看到这类信息直接定位到对应-devel或-dev包装上不要跟 configure 较劲。2.3 configure 的关键参数与静态编译思路在源码根目录执行bash ./configure --prefix/usr/local/rrdtool-1.4.7--disable-tcl--disable-python--disable-perl--disable-ruby--disable-lua--prefix指定安装路径好处是卸载时直接删目录不影响系统其他部分。--disable-tcl等选项关掉用不到的语言绑定能减少编译时间也能避免某些语言绑定在编译时报错。比如系统 Python 版本太老时--disable-python能跳过 Python 模块编译。如果后续要从 Python 调用 rrdtool则去掉--disable-python但需要确保系统里有python-dev。另外一个实用参数是LDFLAGS和CFLAGS老版本在 64 位系统上偶尔找不到 32 位库明确指一下库路径能少踩坑bash ./configure --prefix/usr/local/rrdtool-1.4.7--disable-tcl --disable-rubyCFLAGS-O2 -gLDFLAGS-L/usr/lib64这里的-O2是优化级别-g保留调试信息生产环境建议保留出问题时能借助 gdb 看调用栈。-L/usr/lib64是给 64 位库路径的提示RHEL 系尤其常用。configure 结束后看一眼输出的摘要确认cairo: yes、libxml2: yes如果cairo: no画图功能会在 make 阶段报很多 undefined reference别硬着头皮编译。3. make 编译与安装从源码到可执行文件的完整链路3.1 并行编译与常见编译错误处理依赖齐了之后编译就很快bash make -j4-j4表示用 4 个并行任务编译服务器核数多就写-j8。如果在虚拟机或容器里建议从-j2开始避免内存不够被 OOM kill。编译过程中控制台会滚很多gcc命令看到error:才需要停下来。常见编译错误分三类第一类是头文件找不到典型报错fatal error: pango/pango.h: No such file or directory原因是没装libpango1.0-dev或pango-devel补包后重跑 configure 即可第二类是链接错误报了undefined reference to cairo_*说明 cairo 检测出问题或库路径不对重跑 configure 时注意摘要里cairo是否 yes第三类是与编译器版本相关的告警比如 GCC 10 以下编译老代码时常见implicit declaration of function警告1.4.7 在 GCC 8/9 下基本能过到了 GCC 10 上某些文件会报错误因为默认-fno-common导致重复定义。遇到这种在 CFLAGS 里加-fcommon可以绕过bash make clean ./configure --prefix/usr/local/rrdtool-1.4.7CFLAGS-O2 -g -fcommon make -j4make clean必须执行否则旧的编译产物会干扰重编。-fcommon是 GCC 10 的兼容开关它让全局变量按传统方式合并老项目经常靠它续命。3.2 make install 与 ldconfig 配置编译通过后安装bash make install默认装到/usr/local/rrdtool-1.4.7/bin可执行文件有rrdtool、rrdcgi、rrd_graph等。为了让 shell 直接找到命令加个软链bash ln -s /usr/local/rrdtool-1.4.7/bin/rrdtool /usr/local/bin/rrdtoolrrdtool 动态链接了 cairo 等库如果安装路径不在系统库搜索范围内运行时可能报error while loading shared libraries: libcairo.so.2: cannot open shared object file。此时把库路径加入/etc/ld.so.conf.d/rrdtool.confbash echo /usr/local/rrdtool-1.4.7/lib /etc/ld.so.conf.d/rrdtool.conf ldconfigldconfig刷新动态链接库缓存不加ldconfig光写文件不起作用。这一步经常被漏掉结果 rrdtool 编译安装成功却跑不起来。3.3 验证安装rrdtool 命令的 smoke test安装完先跑一下版本和帮助确认基本可用bash rrdtool --version rrdtool --help | head -20--version会输出RRDtool 1.4.7这样的版本号--help列出可用命令。这两个命令不依赖绘图库只要二进制能加载动态库就能通过。但版本号正常不代表绘图功能正常下一步要创建测试数据库并画图验证。4. 创建第一张 RRD 图从数据入库到 PNG 输出的完整流程4.1 rrdtool create 的语法与数据源规划rrdtool 的核心是 Round Robin Archive环形归档先建库再喂数据bash rrdtool create test.rrd--start N --step 60DS:temp:GAUGE:120:0:100RRA:AVERAGE:0.5:1:288RRA:AVERAGE:0.5:5:2016RRA:MAX:0.5:5:2016--start N表示从当前时间开始--step 60表示每 60 秒一个数据点。DS:temp:GAUGE:120:0:100定义数据源名称为temp类型为GAUGE直接存数值120是 heartbeat允许的最大间隔超过 120 秒没数据则记为未知0和100是下限和上限。RRA:AVERAGE:0.5:1:288定义归档方式AVERAGE表示存平均值0.5是 xff 因子允许 50% 的未知值1是每 1 个 step 合并一次288是存 288 个点即 288 分钟。RRA:AVERAGE:0.5:5:2016表示每 5 个 step5 分钟合并一次存 2016 个点即 7 天。这些参数决定曲线的时间跨度和精度。4.2 update 和 fetch写入数据与验证数据一致性建库后写入模拟数据bash rrdtool update test.rrd N:25.5 rrdtool update test.rrd N:26.1 rrdtool update test.rrd N:25.8这里N表示当前时间冒号后是temp数据源的值。多数据源时用冒号分隔比如N:25.5:60。update 之后查一下数据是否入库bash rrdtool fetch test.rrd AVERAGE --start N-5min --end Nfetch的输出是三列时间戳、temp的值、以及该归档的值。如果数据源类型是COUNTER计数器类型如网卡流量fetch 出来的是速率而不是原始值。用N-5min表示时间范围的写法比较直观等价于写秒级时间戳。4.3 graph 命令画一张能看的 PNG数据有了画图bash rrdtool graph temp.png--start N-1h --end N--title Server Temperature (1.4.7 test)--vertical-label Celsius--width 600 --height 200DEF:temptest.rrd:temp:AVERAGELINE2:temp#FF0000:temperatureDEF从 rrd 文件里取数temp是 DEF 的名字test.rrd是库文件第二个temp是数据源名AVERAGE是归档类型。LINE2表示线宽为 2#FF0000是红色temperature是图例名称。执行后当前目录多出temp.png用file temp.png确认格式bash file temp.png输出应为 PNG image data, 600 x 200如果报ERROR: unable to determine image size通常是 cairo 库问题回到第 2 章检查依赖。PNG 能正常生成说明 rrdtool 核心链路完整后面接监控脚本时只需要把数值写进来定时画图就行。5. 避坑rrdtool 1.4.7 编译和使用中的 5 个典型踩坑记录5.1 现象configure 报Cannot find xml2-config原因系统缺少 libxml2 的开发包。很多精简安装的服务器只有运行时库没有xml2-config这个可执行文件configure 靠它定位头文件和库。解决Debian/Ubuntu 装libxml2-devRHEL/CentOS 装libxml2-devel。装完重跑 configure不用 make clean后缀会自动判断。5.2 现象make 到一半报rrd_graph.c: undefined reference to cairo_pdf_surface_create原因configure 没检测到 cairo-pdf 支持或者 cairo 版本太旧。1.4.7 的 graph 功能依赖 cairo 的 PDF surface 支持有些发行版默认的 cairo 编译时没开 PDF。解决先确认cairo-config --version存在然后装libcairo2-dev或cairo-devel。如果系统 cairo 确实太老比如 1.8 之前的版本就只能换系统或用 rrdtool 自带的--disable-cairo走旧版绘图路径但那样图形质量差不少不建议。5.3 现象rrdtool 编译安装后其他程序调用时报librrd.so.4: cannot open shared object file原因--prefix指定了非系统路径动态链接库没进/etc/ld.so.conf.d。解决像第 3 章那样写/etc/ld.so.conf.d/rrdtool.conf并执行ldconfig。如果还不行检查是不是权限问题echo重定向需要 root 或 sudo。5.4 现象用 Python 调用 rrdtool 模块import rrdtool报 ModuleNotFoundError原因编译时用了--disable-pythonPython 绑定没装上。解决重编一次去掉--disable-python并且保证 Python 开发头文件存在python-dev或python3-dev。重编前make clean后再 configure。5.5 现象graph 画出的图时间范围不对明明指定了--start N-1d却只显示很短一段原因RRA 的保留点数不够。比如只建了RRA:AVERAGE:0.5:1:288最多覆盖 288 分钟4.8 小时--start N-1d超过这个范围的数据查不到。解决建库时按时间跨度规划 RRA 层级。需要一天的数据就加RRA:AVERAGE:0.5:5:20167 天需要一个月就加RRA:AVERAGE:0.5:30:1488约 31 天。RRA 的点数乘步长就是覆盖时长。6. 进阶用 rrdcgi 生成动态图并嵌入监控页替代每次手敲 graphrrdtool 不仅提供命令行还带一个rrdcgi工具能在 CGI 脚本里嵌入RRD::graph标签。配合 Web 服务器访问 URL 就能自动根据当前时间参数生成 PNG。这个能力对监控场景很实用不用写 Python/Perl 定时任务浏览器一刷新就是新图。比如写一个temp.cgibash #!/usr/bin/env bash echo Content-type: text/html echo cat EOF RRD::graph /var/www/html/temp.png --width 600 --height 200 --start N-6h --end N DEF:temp/var/www/rrd/temp.rrd:temp:AVERAGE LINE2:temp#00CC00:temp /RRD::graph EOF这段脚本不是普通 HTML而是 rrdcgi 的模板。把脚本放到 web 服务器的 cgi-bin 目录加可执行权限浏览器访问时rrdcgi解析模板、生成 PNG、返回 HTML。注意路径权限/var/www/html要允许 www-data 用户写。我习惯先把temp.rrd建在/var/www/rrd下再让定时任务每 5 分钟rrdtool update一次CGI 只负责画图输出。部署完成后用 curl 验证页面能正常加载检查 PNG 时间戳是否为最近几分钟。老版本 rrdtool 的坑还在于时间基准。1.4.7 默认用本地时区如果服务器时区设成了 UTC画出来的图横轴时间会跟北京时间差 8 小时。解决方式是在rrdtool graph里加--right-axis-label的同时在系统层面让/etc/localtime指向正确时区。我吃过一次亏监控图时间轴全偏了查了半天发现是容器时区问题。另外生产环境的 rrd 文件建议单独放分区或目录因为 rrd 文件采用环形覆盖写入一旦磁盘满或断电文件损坏后无法自动恢复只能从备份重建。我现在的习惯是/var/lib/rrd挂独立磁盘并纳入 nightly 备份。这个方向值得投入监控数据积累半年后回顾曲线排查故障的价值超过当时花一下午编译的老包。希望上面这些步骤和坑能帮你一次性装通 1.4.7让监控图顺顺当当跑起来。本文还有配套的精品资源点击获取