search
Note
2.1 版本
search 命令允许搜索 OpenTSDB 来检索时间序列列表或相关的元数据。搜索不会返回存储在数据表中的实际数据点或时间序列对象。使用查询工具访问该数据。当前仅执行lookup命令。
Lookup
查找查询使用元数据表或主数据表来确定哪些时间序列与给定的 Metrics，标签名称，标签值，标签对或其组合相关联。例如，如果您想知道标签对host=web01可用的度量标准，则可以执行查找来查找。
Note
默认情况下，对tsdb-meta表执行查找。您必须启用实时元数据创建或使用uid命令执行metasync以便从查询中检索数据。或者，您可以查询原始数据表，但这可能需要很长时间，具体取决于系统中的数据量。
Command Format
search lookup <query>
Parameters
| Name | Data Type | Description | Default | Example |
|---|---|---|---|---|
| query | String | 一个或多个命令行查询，类似于数据 CLI 查询。请参阅下面的查询部分。 | tsd.hbase.rpcs type= | |
| --use_data_table | Flag | 可选标志，它将使查找针对主tsdb-data表运行。 *注意：*这可能需要很长时间才能完成。 |
Not set | --use_data_table |
Query Format
有关制作查询的详细信息，请参见/api/search/lookup。 CLI 查询类似于 API 查询，但是 CLI 空格代替逗号而不是逗号，并且不使用花括号。
[<metric>] [[tagk]=[tagv]] ...[[tagk]=[tagv]]
至少需要一个 Metrics，tagk 或 tagv。
Example Command
search lookup tsd.hbase.rpcs type=
Output
在查找过程中，结果将被打印为标准输出。请注意，如果启用了日志记录，则消息可能会散布在结果中。在logback.xml配置中将日志记录级别设置为 WARN 或 ERROR 以禁止这些警告。您可能希望在后台运行查找并将标准捕获到文件中，尤其是在对数据表运行查找时，因为这些查找可能需要很长时间才能完成。
<tsuid> <metric name> <tag/value pairs>
Where:
Note
tsuid 是时间序列的十六进制编码的 UID
度量名称 是该行代表的度量的解码名称
标记/值对 标记是否与时间序列相关联
Example Response
0023E3000002017358000006017438 tsd.hbase.rpcs type=openScanner host=tsdb-1.mysite.com
Note
扫描期间，如果无法将度量标准，标签名称或标签值的 UID 解析为名称，则会引发异常。