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

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

调试

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

请求参数

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

系统规定参数。取值:SearchTraces

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地址。

Pid String b590lhguqs@9781be0f44dXXXX

应用ID。

Tag.N.Key String http.status_code

Tag的主键。

Tag.N.Value String 200

Tag的值。

ExclusionFilters.N.Key String http.status_code

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

ExclusionFilters.N.Value String 404

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

返回数据

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

请求ID

TraceInfos Array of TraceInfo

返回的调用链路详细信息

OperationName String get***

埋点的接口名称

ServiceIp String 172.20.**.**

应用所在机器的IP地址

Duration Long 6

调用链路耗时(毫秒)

Timestamp Long 1595174436993

时间戳

ServiceName String arms-k8s-demo-subcomponent

应用名称

TraceID String ac1400a115951744369937024d****

调用链路ID

示例

请求示例

http(s)://[Endpoint]/?Action=SearchTraces
&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
&Pid=b590lhguqs@9781be0f44dXXXX
&Tag=[{"Key":"http.status_code","Value":"200"}]
&ExclusionFilters=[{"Key":"http.status_code","Value":"404"}]
&公共请求参数

正常返回示例

XML格式

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

<SearchTracesResponse>
    <RequestId>4C518054-852F-4023-ABC1-4AF95FF7****</RequestId>
    <TraceInfos>
        <OperationName>get***</OperationName>
        <ServiceIp>172.20.**.**</ServiceIp>
        <Duration>6</Duration>
        <Timestamp>1595174436993</Timestamp>
        <ServiceName>arms-k8s-demo-subcomponent</ServiceName>
        <TraceID>ac1400a115951744369937024d****</TraceID>
    </TraceInfos>
</SearchTracesResponse>

JSON格式

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

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