SearchTracesByPage - 分页查询调用链列表信息 - 应用实时监控服务ARMS

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

调试

您可以在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
PageNumber	integer	否	查询分页的页码。	1
PageSize	integer	否	查询分页的每页项目数量，最大值为 100。	5
Pid	string	否	应用 ID。	b590lhguqs@9781be0f44dXXXX
ExclusionFilters	array<object>	否	用于排除的筛选条件的结构体。
	object	否
Key	string	否	用于排除的筛选条件的主键。	http.status_code
Value	string	否	用于排除的筛选条件的值。	404
Tags	array<object>	否	标签列表。
	object	否
Key	string	否	Tag 的主键。系统预置字段如下： traceId：调用链 ID serverApp：服务端应用名 clientApp：客户端应用名 service：接口名称 rpc：调用类型 msOfSpan：耗时大于 clientIp：客户端 IP serverIp：服务端 IP isError：是否异常调用	http.status_code
Value	string	否	Tag 的值。	200
IsError	boolean	否	是否过滤错误的调用链。 `true`：过滤 `false`（默认）：不过滤	false

返回参数

名称	类型	描述	示例值
	object
RequestId	string	请求 ID。	4C518054-852F-4023-ABC1-4AF95FF7****
PageBean	object	返回结构体。
PageNumber	integer	返回结果的页码。	1
PageSize	integer	返回结果的每页项目数量。	5
Total	integer	返回结果的总项目数量。	1601
TraceInfos	array<object>	返回的调用链路详细信息。
	object
OperationName	string	埋点的接口名称。	/demo/queryException/12
ServiceIp	string	应用所在机器的 IP 地址。	172.20.XX.XX
Duration	integer	调用链路耗时，单位为毫秒。	679
Timestamp	integer	时间戳。	1595174436994
ServiceName	string	应用名称。	arms-k8s-demo-subcomponent
TraceID	string	调用链路 ID。	ac1400a115951744369947025d****
SpanID	string	调用链路 SpanID。	be3d6dcf5750e***

示例

正常返回示例

JSON格式

{
  "RequestId": "4C518054-852F-4023-ABC1-4AF95FF7****",
  "PageBean": {
    "PageNumber": 1,
    "PageSize": 5,
    "Total": 1601,
    "TraceInfos": [
      {
        "OperationName": "/demo/queryException/12",
        "ServiceIp": "172.20.XX.XX",
        "Duration": 679,
        "Timestamp": 1595174436994,
        "ServiceName": "arms-k8s-demo-subcomponent",
        "TraceID": "ac1400a115951744369947025d****",
        "SpanID": "be3d6dcf5750e***"
      }
    ]
  }
}

错误码

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

变更历史

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