import

import 命令可将时间序列数据批量加载到 OpenTSDB 中。您提供一个或多个文件,OpenTSDB 将解析并加载数据。数据必须以 Telnet put格式格式化,文本文件中每行一个数据点。每个文件可以选择用 GZip 压缩,如果这样,则必须以.gzextensions 结尾。

有关在 OpenTSDB 中存储数据的更多信息,请参见../writing

Parameters

import path [...paths]

路径可以是绝对路径或相对路径

Example

import /home/hobbes/timeseries1.gz /home/hobbes/timeseries2.gz

Input Format

格式与 Telnet put接口相同。

Note

\ <timestamp><value><tagk=tagv> [\ <tagkN=tagvN>]

Where:

Note

  • metric 是 Metrics 的名称。请注意,度量标准名称可能不包含空格。

  • 时间戳 是数据点的绝对时间戳,以秒或毫秒为单位

  • 是要存储的值

  • tagk = tagv 是一对或多个空间备用标签名称和值对。请注意,标签中可能没有空格。

Example:

Note

sys.cpu.user 1356998400 42 host = web01 cpu = 0

成功的处理将导致如下响应:

Note

23:07:05.323 [main]信息 net.opentsdb.tools.TextImporter-处理文件的时间为 22 毫秒,2 个数据点(90.9 点/秒)

但是,如果发生错误,则导入程序将停止并打印错误行。例如:

Note

23:07:06.375 [main]错误 net.opentsdb.tools.TextImporter-处理文件 timeseries1.gz line = sys.cpu.system 1356998400 42 host = web02 novalue =时捕获到异常

Warning

处理到错误为止的数据点将写入存储。您应该编辑文件并清除所有数据点,直到出现错误的行。如果您修复了线路并重新启动导入,则现有数据可能会发生冲突。将来对 OpenTSDB 的更新将很好地处理这种情况。