rrdupdate - 云端在线

程序：

您的姓名

rrdupdate - 将一组新值存储到 RRD 中

概要

rrdtool的 {更新 | 更新} 文件名 [- 模板|-t 名称[:名称]...]
[--跳过过去的更新|-s[--守护进程|-d 地址[--] N:折扣值[:折扣值] ...
时间戳:折扣值[:折扣值] ... 时间戳@折扣值[:折扣值] ...

商品描述

这个 更新 函数将新的数据值输入到 减灾。 数据是时间对齐的
（插值）根据的属性 减灾 数据写入的位置。

更新 这个替代版本 更新 采用相同的参数并执行相同的操作
功能。 的 v 代表 详细，它描述了返回的输出。 更新
返回写入磁盘的任何和所有合并数据点 (CDP) 的列表
调用更新的结果。 这些值按时间戳 (time_t) 进行索引，
RRA（合并功能和每个 CDP 的 PDP）和数据源（名称）。 注意
根据当前和先前调用更新的参数，列表
可能没有条目或有大量条目。

建立 更新 需要直接磁盘访问， --守护进程 选项不能与
这个命令。

文件名
的名字 减灾 你想要更新。

- 模板|-t 名称[:名称] ...
默认情况下， 更新 函数期望按数据顺序输入数据
源在 RRD 中定义，不包括任何 COMPUTE 数据源（即，如果
第三数据源 DST 是COMPUTE，第三个输入值将被映射到
第四个数据源 减灾 等等）。 这不是很容易出错，因为您
可能会向 RRD 发送错误的数据。

模板开关允许您指定要使用哪些数据源
更新以及按什么顺序。 如果模板中指定的数据源不是
如果 RRD 文件中存在可用信息，则更新过程将中止并显示错误消息。

虽然看起来可以通过模板切换来更新数据源
异步， RRD工具 隐式分配缺少的非 COMPUTE 数据源
模板的 *未知* 计算值。

不要为 COMPUTE 指定值 DST ，在 更新 功能。 如果这样做了
意外地（这只能使用模板开关来完成）， RRD工具 将
忽略为 COMPUTE 指定的值 DST.

缓存守护进程 rrdcached 尚不能与模板一起使用。

--跳过过去的更新|-s
当使用早于最新更新的数据更新rrd文件时
应用后，rrdtool 将发出错误消息并中止。 该选项指示
rrdtool 会默默地跳过此类数据。 当将旧数据重新播放到
rrd 文件，并且您不确定已经应用了多少更新。

--守护进程|-d 地址
如果给出， RRDTool的 将尝试连接到缓存守护进程 rrdcached 地址.
如果连接成功建立，这些值将被发送到
守护进程而不是直接访问文件。 如果无法连接
建立后它将回退到直接文件访问。 虽然这很方便，但
可能会悄悄地产生问题，因此请阅读示例中的警告。

有关可接受格式的列表，请参阅 -l rrdcached 手册中的选项。

{N | 时间戳}:折扣值[:折扣值] ...
用于更新 RRD 的数据是在某个时间获取的。 这次可以
要么以自 1970-01-01 以来的秒数定义，要么使用字母“N”，其中
如果更新时间设置为当前时间。 负时间值是
从当前时间中减去。 AT_STYLE TIME SPECIFICATION（参见 获取
文档）也可以通过界定时间规范的结束来使用
用“@”字符代替“:”。 将时间精确到秒是
当您使用类型的数据源时尤其重要 COUNTER,
派生, 计数器, 导出 or 绝对.

当使用负时间值时，选项和数据必须用两个分隔
破折号 (--)，否则时间值将被解析为选项。 请参阅下面的
例。

参数的其余元素是 DS 更新。 该列表的顺序是
与 RRA 中定义数据源的顺序相同。 如果没有
某个数据源的数据，字母 U （例如，N:0.1:U:1）可以指定。

从数据源获取的值的格式取决于数据
选择的源类型。 通常它是数字，但数据采集模块
只要冒号 (:)
保留数据源值分隔符。

环境 变数

以下环境变量可用于更改行为
“rrd工具更新”：

RRDCACHED_ADDRESS
如果设置了此环境变量，它将与指定
命令行上的“--daemon”选项。 如果两者都存在，则命令行参数
优先。

RRDCACHED_STRIPPATH
如果设置了此环境变量，它将从文件名中删除前导字符串
在将文件名发送到 rrdcached 之前。 这主要是为了允许
rrdcached 可以与 xymon 和 cacti 工具一起使用，而无需修改这些工具。

示例

· “rrdtool 更新 demo1.rrd N:3.44:3.15:U:23”

将数据库文件 demo1.rrd 更新为 3 已知和 XNUMX *未知* 价值。 使用
当前时间作为更新时间。

·“rrdtool更新demo2.rrd 887457267:U 887457521:22 887457903:2.7”

更新数据库文件 demo2.rrd，该文件需要来自单个数据源（三个）的数据
次。 首先用一个 *未知* 然后通过两个常规读数来确定值。 更新
间隔好像是300秒左右。

· “rrdtool 更新 demo3.rrd -- -5:21 N:42”

更新数据库文件 demo3.rrd 两次，使用过去 XNUMX 秒和
当前时间作为更新时间。

· “rrdtool update --daemon unix:/tmp/rrdd.sock demo4.rrd N:23”

使用 UNIX 域套接字“/tmp/rrdd.sock”来联系缓存守护进程。 如果
缓存守护进程不可用，直接更新文件“demo4.rrd”。 警告： 建立
指定相对路径，可能会发生以下令人不安的影响： 如果守护程序
可用，文件相对于工作目录 of 这些因素包括原料奶的可用性以及达到必要粉末质量水平所需的工艺。 守护 用来。 如果
守护进程不可用，该文件相对于当前工作目录
使用调用过程。 本篇 五月 更新 二 不同 档 根据 on 是否
这些因素包括原料奶的可用性以及达到必要粉末质量水平所需的工艺。 守护 可以 be 达到 or 不是。 不要做相对路径，孩子们！

作者

托比亚斯·欧蒂克[email protected]>, 弗洛里安·福斯特

使用 onworks.net 服务在线使用 rrdupdate