RRDtool文档

RRDtool

---

rrdtool

描述

概述

从各种事物收集状态信息是相当容易的，从您的办公室的温度到通过您的路由器FDDI接口的八位字节数量。但以有效且系统的方式存储这些数据并不是那么简单。这就是RRDtool派上用场的地方。它可以记录、分析从各种数据源（DS）收集到的数据。RRDtool的数据分析部分基于快速生成图形表示的能力，其中数据在可定义的时间段内获取。
在此手册中，您将找到有关Round Robin数据库工具（RRDtool）的设计性、功能性的一般信息。使用RRDtool具体函数的详细描述，请查看相应的手册。

函数

手册中提供了一些运行RRDtool的命令行语句，除此之外，RRDtool还可以利用提供的通道实现远程控制。当你需要快速使用RRDtool来做一些事情的时候，这会节省很多时间。更多信息请查看远程控制部分。你还可以通过Perl，python，Tcl，PHP等语言来使用RRDtool。

• create
  创建一个新的Round Robin数据库（RRD），查看rrdcreate。
• update
  在RRD中保存数据值，查看rrdupdate。
• updatev
  与update操作相同，输出不同，查看rrdupdate。
• graph
  根据一个或多个RRD中数据生成一张图表。除了生成图表，数据还可以提取到标准输出。查看rrdgraph。
• graphv
  根据一个或多个RRD中数据生成一张图表。与graph相同，但是在生成图标前打印元数据。查看rrdgraph。
• dump
  以纯ASCII格式转存（dump）RRD的内容。与恢复（restore）搭配使用可将数据在计算机之间转移。查看rrddump。
• restore
  将XML格式的RRD数据恢复为二进制的RRD数据。查看rrdrestore。
• fetch
  获取RRD中特定时间内的数据。graph函数使用fetch函数检索RRD中的数据。检查rrdfetch。
• tune
  更改RRD的设置和结构。查看rrdtune。
• first
  查找RRD的第一次更新时间。查看rrdfirst。
• last
  查找RRD的最后一次更新时间。查看rrdlast。
• lastupdate
  查找RRD的最后一次更新时间。还返回最新更新的每一个数据的值。查看rrdlastupdate。
• info
  获取RRD的信息。查看rrdinfo。
• resize
  更改独立的RRA的大小，这很危险。查看rrdresize。
• xport
  导出一个或多个RRD中的数据。查看rrdxport。
• flushcached
  刷新内存中指定RRD文件的数据。查看rrdflushcached。

rrdgraph

描述

RRDtool的graph函数用来将RRD格式的数据可视化。它的主要功能是用来生成一个优秀的图表化展示，也可以生成一个数据报告。

概述

rrdtool graph函数需要数据才能运行，所以你必须有一个或多个数据定义（查看rrdgraph_data DEF）表述来存放数据。数据不限于来自一个数据库，可以从多个数据库收集数据（尽管一个表述只对应一个数据库）。
如果想要展示均值、极值、百分位值等，最好利用可变定义（查看rrdgraph_data VDEF）表述存放数据。目前来说没什么区别，但是在RRDtool未来的版本中会倾向于这种表述方式。
取自RRA的数据会被整合，这样在图表的一个像素上会有一个数据点。如果未进行定义，RRDtool会在必要时扩大范围。注意，这种情况下，第一个或最后一个像素不可知。
有时数据并不是想要展示的格式。例如，以每秒字节数（byte/s）收集的数据希望以每秒位数(bit/s)展示。这就会用到数据计算命令（查看rrdgraph_data CDEF）。数据整合之后，会创建一个副本，这个副本会由相当强大的RPN(查看rrdgraph_rpn)命令集进行编辑。