文档中心

日志服务

Trace 存储

SearchTraces

SearchTraces

调用 SearchTraces 接口，根据特定条件查询 Trace 详情列表。

请求说明

请求方式：POST

请求地址：https://{tls-endpoint}/SearchTraces

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Body

参数	类型	是否必选	示例值	描述
Query	Object of TraceQueryParameters	是	/	查询条件，用于筛选符合条件的 Trace 详情。支持多种查询条件组合，包括排序、分页、时间范围、服务名称等。
TraceInstanceId	String	是	0fdaa6b6-3c9f-424c-8664-fc0d222c****	Trace 实例 ID。

TraceQueryParameters

参数	类型	是否必选	示例值	描述
Asc	Boolean	否	true	指定查询结果的排序方式是否为升序。true 表示升序，false表示降序。
Kind	String	否	internal	类型。
Limit	Integer	否	10	指定查询结果返回的最大记录数，用于分页控制。
Order	String	否	Start	指定查询结果的排序字段，支持以下字段进行排序： Kind：类型； Name：名称； ServiceName：服务名称； Start：开始时间； End：结束时间； Duration：持续时间； Attributes 中显式添加并开启统计的索引字段（如 Attributes.request_id）。
Offset	Integer	否	0	分页查询时的偏移量，表示从查询结果的第几条记录开始返回。通常与 Limit配合使用实现分页功能。
TraceId	String	否	ef97a7****	Trace ID。
Attributes	JSON Map	否	[object Object]	Attributes中字段为key， value为该字段可能得取值。
StatusCode	String	否	OK	Trace 的状态码，用于筛选特定状态的 Trace记录。
DurationMax	Integer	否	1000000	Trace 持续时间的最大值，单位为微秒。用于筛选持续时间不超过指定值的 Trace记录。
DurationMin	Integer	否	1000	Trace 持续时间的最小值，单位为微秒。用于筛选持续时间超过指定值的 Trace记录。
ServiceName	String	否	mysql	用于筛选特定服务名称的 Trace 记录。该字段支持精确匹配，查询结果将仅包含服务名称与指定值完全一致的 Trace记录。
StartTimeMax	Integer	否	1625097600000000	Span 的最大开始时间，单位为微秒时间戳。用于筛选开始时间不超过指定值的 Trace记录。
StartTimeMin	Integer	否	1625097600000000	Span 的最小开始时间，单位为微秒时间戳。用于筛选开始时间超过指定值的 Trace记录。
OperationName	String	否	create	Trace 的操作名称，用于筛选特定操作名称的 Trace 记录。该字段支持精确匹配，查询结果将仅包含操作名称与指定值完全一致的 Trace记录。

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构。

参数	类型	示例值	描述
Total	Integer	100	符合条件的 Trace详情总数。
TraceInfos	Array of TraceInfo	-	包含查询到的 Trace 详情列表，每个详情项包含 TraceID、服务名称、操作名称、开始时间、结束时间、持续时间、状态码以及自定义属性等信息。

TraceInfo

参数	类型	示例值	描述
EndTime	Integer	1625097600000000	Trace的结束时间，单位为微秒，表示该次追踪操作完成的精确时刻。
TraceId	String	ef97a7****	Trace ID。
Duration	Integer	1500000	Trace 的持续时间，单位为微秒，表示从 StartTime 到 EndTime的时间差。
StartTime	Integer	1625097600000000	Trace的开始时间，单位为微秒，表示该次追踪操作开始的精确时刻。
Attributes	JSON Map	[object Object]	Attributes中字段为key， value为该字段可能得取值。
StatusCode	String	OK	Trace 的状态码，用于筛选特定状态的 Trace记录。
ServiceName	String	mysql	用于筛选特定服务名称的 Trace 记录。该字段支持精确匹配，查询结果将仅包含服务名称与指定值完全一致的 Trace记录。
OperationName	String	create	Trace 的操作名称，用于筛选特定操作名称的 Trace 记录。该字段支持精确匹配，查询结果将仅包含操作名称与指定值完全一致的 Trace记录。

请求示例

返回示例

错误码

您可访问公共错误码，获取更多错误码信息。

最近更新时间：2025.12.23 17:35:13

这个页面对您有帮助吗？

有用

有用

无用

无用