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

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

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String SearchTracesByPage

系统规定参数。取值:SearchTracesByPage

StartTime Long 1595174400000

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

EndTime Long 1595210400000

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

RegionId String cn-hangzhou

地域ID。

ServiceName String arms-k8s-demo-subcomponent

应用名称。

OperationName String /demo/queryNotExistDB/11

埋点的接口名称。

MinDuration Long 2

最小耗时,单位为毫秒。

Reverse Boolean false

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

  • true:表示倒序
  • false:表示正序
ServiceIp String 172.20.XX.XX

应用所在机器的IP地址。

PageNumber Integer 1

查询分页的页码。

PageSize Integer 5

查询分页的每页项目数量,最大值为100。

Pid String b590lhguqs@9781be0f44dXXXX

应用ID。

ExclusionFilters.N.Key String http.status_code

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

ExclusionFilters.N.Value String 404

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

Tags.N.Key String http.status_code

Tag的主键。

Tags.N.Value String 200

Tag的值。

返回数据

名称 类型 示例值 描述
RequestId String 4C518054-852F-4023-ABC1-4AF95FF7****

请求ID。

PageBean Object

返回结构体。

PageNumber Integer 1

返回结果的页码。

PageSize Integer 5

返回结果的每页项目数量。

Total Integer 1601

返回结果的总项目数量。

TraceInfos Array of TraceInfo

返回的调用链路详细信息。

OperationName String /demo/queryException/12

埋点的接口名称。

ServiceIp String 172.20.XX.XX

应用所在机器的IP地址。

Duration Long 679

调用链路耗时,单位为毫秒。

Timestamp Long 1595174436994

时间戳。

ServiceName String arms-k8s-demo-subcomponent

应用名称。

TraceID String ac1400a115951744369947025d****

调用链路ID。

示例

请求示例

http(s)://[Endpoint]/?Action=SearchTracesByPage
&StartTime=1595174400000
&EndTime=1595210400000
&RegionId=cn-hangzhou
&ServiceName=arms-k8s-demo-subcomponent
&OperationName=/demo/queryNotExistDB/11
&MinDuration=2
&Reverse=false
&ServiceIp=172.20.XX.XX
&PageNumber=1
&PageSize=5
&Pid=b590lhguqs@9781be0f44dXXXX
&ExclusionFilters=[{"Key":"http.status_code","Value":"404"}]
&Tags=[{"Key":"http.status_code","Value":"200"}]
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<SearchTracesByPageResponse>
    <RequestId>4C518054-852F-4023-ABC1-4AF95FF7****</RequestId>
    <PageBean>
        <PageNumber>1</PageNumber>
        <PageSize>5</PageSize>
        <Total>1601</Total>
        <TraceInfos>
            <OperationName>/demo/queryException/12</OperationName>
            <ServiceIp>172.20.XX.XX</ServiceIp>
            <Duration>679</Duration>
            <Timestamp>1595174436994</Timestamp>
            <ServiceName>arms-k8s-demo-subcomponent</ServiceName>
            <TraceID>ac1400a115951744369947025d****</TraceID>
        </TraceInfos>
    </PageBean>
</SearchTracesByPageResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/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****"
    } ]
  }
}