rollup

尝试将汇总和/或预聚合的数据指向存储。请注意，Telnet 样式 API 可能无法正确处理 UTF-8 字符，因此请改用/api/rollup方法或直接使用 Java API。另请参阅../user_guide/rollup 文档以获取更多信息。该端点的行为与put API 相似。

Request

命令格式为：

rollup <rollup spec> <metric> <timestamp> <value> <tagk_1>=<tagv_1>[ <tagk_n>=<tagv_n>]

在这种情况下，汇总规格为以下之一：

• <interval>-<aggregator>进行间隔内的原始或非预汇总 汇总 。

• <group_by_aggregator>表示尚未汇总的“原始” 预汇总 值。

• <interval>-<aggregator>:<group_by_aggregator>表示*“汇总” *“预先汇总” *的值。

Note:

• 由于字段是用空格分隔的，因此 Metrics 和标记值可能不包含空格。

• 时间戳记必须为正 Unix 纪元时间戳记。例如。 1479496100代表Fri, 18 Nov 2016 19:08:20 GMT

• 该值必须是数字。它可以是整数(Java long数据类型的最大值和最小值)，浮点值或科学计数法(格式为[-]<#>.<#>[e|E][-]<#>)。

• 必须至少存在一个标签对。可以在其他标签对之间添加空格。

Examples

rollup 1h-SUM sys.if.bytes.out 1479412800 1.3E3 host=web01 interface=eth0
rollup SUM sys.procs.running 1479496100 42 colo=lga
rollup 1h-SUM:SUM sys.procs.running 1479412800 24 colo=lga

Response

成功的请求将不会返回响应。只有在出错时，套接字才会返回一行数据。一些示例如下所示：

请求和响应示例

rollup
rollup: illegal argument: not enough arguments (need least 5, got 1)

rollup SUM metric.foo notatime 42 host=web01
rollup: invalid value: Invalid character 'n' in notatime

如果禁用了tsd.core.auto_create_metrics，将返回以下内容。

rollup SUM new.metric 1479496160 1.3e3 host=web01
rollup: unknown metric: No such name for 'metrics': 'new.metric'