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

调试

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

请求参数

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

系统规定参数,取值为SearchTraces

EndTime Long 1575622455686

结束时间,精确到毫秒(ms)。

RegionId String cn-beijing

地域ID。

StartTime Long 1575561600000

开始时间,精确到毫秒(ms)。

ServiceName String service 1

微服务名称,又称为应用名称。

OperationName String /api

Span名称,即某个跟踪点或埋点的名称。

MinDuration Long 1000

大于某个时间跨度范围,单位为毫秒(ms)。例如,100表示大于100毫秒的数据。

AppType String XTRACE

应用类型,取值为XTRACE或空。

Tag.N.Key String http.status_cod

标签键。

Tag.N.Value String 200

标签值。

PageNumber Integer 1

页码,例如,5表示第5页。

PageSize Integer 100

每页的查询数据条数。

Reverse Boolean false

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

  • true:倒序。
  • false :顺序。
ServiceIp String 10.0.0.0

Span对应的IP地址。

返回数据

名称 类型 示例值 描述
PageBean Struct

返回数据的位置信息。

PageNumber Integer 1

页码。

PageSize Integer 100

每页显示的数据条数。

TotalCount Long 1000

总条数。

TraceInfos Array of TraceInfo

返回的调用链信息。

TraceInfo
Duration Long 100

耗时,单位为毫秒(ms)。

OperationName String /api

Span名称。

ServiceIp String 192.163.XXX.XXX

Span所在的IP地址。

ServiceName String service1

微服务名称,又称为应用名称。

Timestamp Long 1575561600000000

Span产生时间,单位为微秒(μs)。

TraceID String 1c6881aab84191a4

调用链ID。

RequestId String 1E2B6A4C-6B83-4062-8B6F-AEEC1FC47DED

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=SearchTraces
&EndTime=1575622455686
&RegionId=cn-beijing
&StartTime=1575561600000
&<公共请求参数>

正常返回示例

XML格式

<SearchTracesResponse> 
    <PageBean> 
        <TotalCount>1000</TotalCount>  
        <PageSize>100</PageSize>  
        <PageNumber>1</PageNumber>  
        <TraceInfos> 
            <TraceInfo> 
                <ServiceIp>192.163.XXX.XXX</ServiceIp>  
                <ServiceName>service1</ServiceName>  
                <OperationName>/api</OperationName>  
                <TraceID>1c6881aab84191a4</TraceID>  
                <Duration>100</Duration>  
                <Timestamp>1575561600000000</Timestamp> 
            </TraceInfo> 
        </TraceInfos> 
    </PageBean>  
    <RequestId>1E2B6A4C-6B83-4062-8B6F-AEEC1FC47DED</RequestId> 
</SearchTracesResponse>

JSON格式

{
    "PageBean": {
        "TotalCount": 1000,
        "PageSize": 100,
        "PageNumber": 1,
        "TraceInfos": {
            "TraceInfo": {
                "ServiceIp": "192.163.XXX.XXX",
                "ServiceName": "service1",
                "OperationName": "/api",
                "TraceID": "1c6881aab84191a4",
                "Duration": 100,
                "Timestamp": 1575561600000000
            }
        }
    },
    "RequestId": "1E2B6A4C-6B83-4062-8B6F-AEEC1FC47DED"
}

错误码

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