SearchTraces - 查询调用链列表 - 可观测链路 OpenTelemetry 版

调用SearchTraces查询调用链列表，可根据时间、应用名称、IP地址、Span名称、Tag等信息对调用链进行过滤查询。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

xtrace:SearchTrace

get

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
StartTime	integer	是	开始时间，精确到毫秒（ms）。	1714298814000
EndTime	integer	是	结束时间，精确到毫秒（ms）。	1714385214000
RegionId	string	是	地域 ID。	cn-beijing
ServiceName	string	否	微服务名称，又称为应用名称。	service 1
OperationName	string	否	Span 名称，即某个跟踪点或埋点的名称。	/api
MinDuration	integer	否	大于某个时间跨度范围，单位为毫秒（ms）。例如，200 表示大于 200 毫秒的数据。	2
AppType	string	否	应用类型，取值为空或`XTRACE`，推荐设置为空。空：查询 XTRACE 和 ARMS 调用链。 `XTRACE`：只查询 XTRACE 调用链。	XTRACE
PageNumber	integer	否	页码，例如，5 表示第 5 页。	1
PageSize	integer	否	每页的查询数据条数。	20
Reverse	boolean	否	按照时间正序或者倒序排列。默认为`false`。取值： `true`：倒序。 `false` ：顺序。	false
ServiceIp	string	否	Span 对应主机的 IP 地址。	192.163.XXX.XXX
Tag	array<object>	否	标签列表。
	object	否	标签列表。
Key	string	否	标签键。	http.status_cod
Value	string	否	标签值。	200
StatusCode	string	否

返回参数

名称	类型	描述	示例值
	object
RequestId	string	请求 ID。	1E2B6A4C-6B83-4062-8B6F-AEEC1F******
PageBean	object	返回数据的位置信息。
PageSize	integer	每页显示的数据条数。	20
PageNumber	integer	页码。	1
TotalCount	integer	总条数。	500
TraceInfos	object
TraceInfo	array<object>	返回的调用链信息。
	array<object>	返回的调用链信息。
OperationName	string	Span 名称。	/api
ServiceIp	string	Span 所在的主机 IP 地址或主机名称。	192.163.XXX.XXX
Duration	integer	耗时，单位为毫秒（ms）。	500
Timestamp	integer	Span 产生时间，单位为毫秒（ms）。	1714306014000
ServiceName	string	微服务名称，又称为应用名称。	service1
TraceID	string	调用链 ID。	1c6881aab841******
TagMap	object	标签信息。	{"env":"dev"}
StatusCode	integer

示例

正常返回示例

JSON格式

{
  "RequestId": "1E2B6A4C-6B83-4062-8B6F-AEEC1F******",
  "PageBean": {
    "PageSize": 20,
    "PageNumber": 1,
    "TotalCount": 500,
    "TraceInfos": {
      "TraceInfo": [
        {
          "OperationName": "/api",
          "ServiceIp": "192.163.XXX.XXX",
          "Duration": 500,
          "Timestamp": 1714306014000,
          "ServiceName": "service1",
          "TraceID": "1c6881aab841******",
          "TagMap": {
            "env": "dev"
          },
          "StatusCode": 0
        }
      ]
    }
  }
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。