query

查询命令行工具旨在用作从 OpenTSDB 提取数据的快速调试工具。查询数据时，HTTP API 通常会更快，因为它包含了缓存并打开了与存储的连接。结果以文本格式打印到标准输出，每行一个数据点。

请注意，查询可能会在请求的时间间隔之前和之后返回数据点。这些用于下采样和制图。

Parameters

query [Gnuplot opts] START-DATE [END-DATE] <aggregator> [rate] [counter,max,reset] [downsample N FUNC] <metric> [<tagk=tagv>] [...<tagk=tagv>] [...queries]

Name	Data Type	Description	Default	Example
Gnuplot opts	Strings	用于生成 Gnuplot 脚本和图形的可选值。请注意，不会生成实际的图形 PNG，只会生成文件(写入 temp 目录)		+wxh=1286x836
START-DATE	字符串或整数	查询的开始时间。这可以是绝对时间或相对时间。有关详情，请参见日期和时间		1h-ago
END-DATE	字符串或整数	查询的可选结束时间。如果未提供，则使用当前时间。这可以是绝对时间或相对时间。有关详情，请参见日期和时间	Current timestamp	2014/01/01-00:00:00
aggregator	String	结果中包含多个时间序列时使用的函数		sum
rate	String	如果时间序列表示计数器，则 Literals 为rate，结果应以每秒增量的形式返回		rate
counter	String	表示基础数据的可选 Literalscounter是单调递增的计数器，可能会翻转		counter
max	Integer	代表计数器最大值的正整数	Java Long.MaxValue	65535
resetValue	Integer	一个可选的值，当超过该值时，它将导致聚合器返回 0 而不是计算出的速率。经常重置数据源以避免虚假尖峰时很有用。		65000
下采样 N FUNC	String	可选的下采样说明符，用于将数据分组为更大的时间范围并减少返回的数据量。格式为 Literalsdownsample，后跟毫秒(毫秒)和聚合函数名称		下采样 300000 平均
metric	String	要查询的 Metrics 的必需名称		sys.cpu.user
tagk=tagv	String	标记对和标记值的可选对		host=web01
additional queries	String	要执行的可选其他查询。每个查询必须遵循以聚合器开头的相同格式。所有查询共享相同的开始时间和结束时间。		sum tsd.hbase.rpcs type =扫描

有关查询的更多详细信息，请参阅查询或读取数据。

Example:

query 1h-ago now sum tsd.hbase.rpcs type=put sum tsd.hbase.rpcs type=scan

Output Format

数据被打印到标准输出，每行一个数据点。如果指定了一个或多个 Gnuplot 选项，则每个查询的脚本和数据文件将被写入配置的临时目录。

Where:

Example:

tsd.hbase.rpcs 1393376401000 28067146491 {type=put, fqdn=tsdb-data-1}
tsd.hbase.rpcs 1393376461000 28067526510 {type=put, fqdn=tsdb-data-1}
tsd.hbase.rpcs 1393376521000 28067826659 {type=put, fqdn=tsdb-data-1}
tsd.hbase.rpcs 1393376581000 28068126093 {type=put, fqdn=tsdb-data-1}