/api/tree/notmatched

在处理 TSMeta 时,如果树启用了strictMatch并且元集在集合中任何级别的规则上均不匹配,则将记录不匹配条目。此端点允许检索未能与规则集匹配的 TSUID 列表。这对于调试很有用,因为如果在此列表中找到 TSUID,则可以将其通过/tree/test端点传递,以获取有关元数据为什么不匹配的详细信息。

Note

调用没有一个或多个 TSUID 列表的端点将返回树中所有不匹配的 TSUID。如果您的系统中有大量时间序列,则响应可能会非常大。因此,最好将此端点与特定的 TSUID 一起使用。

Note

如果为树禁用了storeFailures,则此端点将不返回任何数据。未匹配的条目仍将出现在 TSD 的日志中。

Verbs

Requests

以下字段用于此端点

Name Data Type Required Description Default QS RW Example
treeId Integer Required 通过 TSMeta 对象传递的树的 ID treeid 1
tsuids String Required 用于搜索不匹配条目的一个或多个 TSUID 的列表。如果要求测试多个 TSUID,则应以逗号分隔。 tsuids 000001000001000001,00000200000200002

Response

成功的响应将返回键/值对的 Map,其中未记录的 TSUID 作为键,以及一条关于哪个规则未能匹配的消息作为值的消息。响应将仅返回找到的不匹配条目。如果请求的一个或多个 TSUID 没有导致不匹配的条目,则不会将其与结果一起返回。这可能意味着 TSMeta 尚未处理。请注意,如果未发生任何失败的匹配,或者树尚未处理任何数据,则结果集将为空。如果请求的树在系统中不存在,则将返回404并显示一条错误消息。如果提供了无效数据,将返回400错误。

Example Request

Example Response

{
    "010101": "Failed rule 0:0",
    "020202": "Failed rule 1:1"
}
首页