/api/tree/notmatched

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

Note

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

Note

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

Verbs

  • GET

Requests

以下字段用于此端点

NameData TypeRequiredDescriptionDefaultQSRWExample
treeIdIntegerRequired通过 TSMeta 对象传递的树的 ID treeid 1
tsuidsStringRequired用于搜索不匹配条目的一个或多个 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"
}