全部产品
Search
文档中心

应用实时监控服务ARMS:SearchTraces - 查询调用链列表信息

更新时间:Aug 28, 2026

查询调用链列表信息,可根据时间、应用名称、IP地址、Span名称和Tag等信息筛选调用链。

接口说明

说明

该接口最多返回 100 条数据。如需查询全量数据,建议使用 SearchTracesByPage。具体详情,请参见 SearchTracesByPage 。

调试

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

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称

类型

必填

描述

示例值

StartTime

integer

是

开始时间的时间戳,精确到毫秒。

1595174400000

EndTime

integer

是

结束时间的时间戳,精确到毫秒。

1595210400000

RegionId

string

是

地域 ID。

cn-hangzhou

ServiceName

string

否

应用名称。

arms-k8s-demo-subcomponent

OperationName

string

否

埋点的接口名称。

/demo/queryNotExistDB/11

MinDuration

integer

否

最小耗时,单位为毫秒。

2

Reverse

boolean

否

按照时间正序或者倒序排列。默认值为false。

  • true:表示倒序

  • false:表示正序

false

ServiceIp

string

否

应用所在机器的 IP 地址。

172.20.XX.XX

Pid

string

否

应用 ID。

b590lhguqs@9781be0f44dXXXX

Tag

array<object>

否

标签列表。

object

否

Key

string

否

Tag 的主键。系统预置字段如下:

  • serverApp:服务端应用名

  • clientApp:客户端应用名

  • service:接口名称

  • rpc:调用类型

  • msOfSpan:耗时大于

  • clientIp:客户端 IP

  • serverIp:服务端 IP

  • isError:是否异常调用

http.status_code

Value

string

否

Tag 的值。

200

ExclusionFilters

array<object>

否

用于排除的筛选条件结构体。

object

否

Key

string

否

用于排除的筛选条件的主键。

http.status_code

Value

string

否

用于排除的筛选条件的值。

404

返回参数

名称

类型

描述

示例值

object

RequestId

string

请求 ID

4C518054-852F-4023-ABC1-4AF95FF7****

TraceInfos

array<object>

返回的调用链路详细信息

object

OperationName

string

埋点的接口名称

get***

ServiceIp

string

应用所在机器的 IP 地址

172.20.**.**

Duration

integer

调用链路耗时(毫秒)

6

Timestamp

integer

时间戳

1595174436993

ServiceName

string

应用名称

arms-k8s-demo-subcomponent

TraceID

string

调用链路 ID

ac1400a115951744369937024d****

SpanID

string

调用链路 SpanID。

be3d6dcf5750e***

示例

正常返回示例

JSON格式

{
  "RequestId": "4C518054-852F-4023-ABC1-4AF95FF7****",
  "TraceInfos": [
    {
      "OperationName": "get***",
      "ServiceIp": "172.20.**.**",
      "Duration": 6,
      "Timestamp": 1595174436993,
      "ServiceName": "arms-k8s-demo-subcomponent",
      "TraceID": "ac1400a115951744369937024d****",
      "SpanID": "be3d6dcf5750e***"
    }
  ]
}

错误码

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

变更历史

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