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

调试

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

请求参数

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

系统规定参数,取值为 SearchTraces

EndTime Long 1575622455686

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

RegionId String cn-beijing

地域 ID,例如杭州填写为 cn-hangzhou,北京填写为 cn-beijing 等。

StartTime Long 1575561600000

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

ServiceName String service 1

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

OperationName String /api

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

MinDuration Long 1000

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

AppType String XTRACE

应用类型,非必选值,可填写为 XTRACE 或不填。

Tag.N.Key String http.status_cod

Tag Key。

Tag.N.Value String 200

Tag Value。

PageNumber Integer 1

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

PageSize Integer 100

每页的查询数据条数。

Reverse Boolean false

按照时间正序或者倒序排列,true 表示倒序,false 表示顺序。默认为 false。

ServiceIp String 10.0.0.0

Span 对应的 IP 地址。

返回数据

名称 类型 示例值 描述
PageBean Struct

返回数据的位置信息。

PageNumber Integer 1

页码。

PageSize Integer 100

每页显示的数据条数。

TotalCount Long 1000

总条数。

TraceInfos Array

返回的调用链信息。

TraceInfo
Duration Long 100

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

OperationName String /api

Span 名称。

ServiceIp String 192.163.0.1

Span 所在的 IP 地址。

ServiceName String service1

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

Timestamp Long 1575561600000000

Span 产生时间,单位是微秒。

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 格式

<PageBean>
    <TotalCount>17539818</TotalCount>
    <PageSize>10</PageSize>
    <TraceInfos>
        <TraceInfo>
            <ServiceIp>11.194.110.238</ServiceIp>
            <OperationName>checkAndRefresh</OperationName>
            <ServiceName>xtrace-collector</ServiceName>
            <TraceID>547713e07af0139e</TraceID>
            <Duration>0</Duration>
            <Timestamp>1583683202048</Timestamp>
        </TraceInfo>
    </TraceInfos>
</PageBean>
<RequestId>B00B2E34-416A-46D7-8894-05EAD557947A</RequestId>

JSON 格式

{
  "PageBean": {
    "TotalCount": 17539818,
    "PageSize": 10,
    "TraceInfos": {
      "TraceInfo": [
        {
          "ServiceIp": "11.194.110.238",
          "OperationName": "checkAndRefresh",
          "ServiceName": "xtrace-collector",
          "TraceID": "547713e07af0139e",
          "Duration": 0,
          "Timestamp": 1583683202048
        }]
        }
        },
        "RequestId": "B00B2E34-416A-46D7-8894-05EAD557947A"
        }

错误码

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