文档首页/ 应用性能管理 APM/ API参考（2.0）/ API/ 视图信息/ 调用链拓扑图
更新时间：2025-06-10 GMT+08:00
在线调试
CLI示例
查看PDF
分享

调用链拓扑图

功能介绍

调用链拓扑图。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

URI

GET /v1/apm2/openapi/view/trace/topology

表1 Query参数

参数

是否必选

参数类型

描述

trace_id

是

String

调用链traceId。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

从IAM服务获取的用户Token。

响应参数

状态码： 200

表3 响应Body参数

参数

参数类型

描述

global_trace_id

String

全局traceId。

line_list

Array of TraceTopologyLine objects

组件之间调用指向线列表。

node_list

Array of TraceTopologyNode objects

组件节点列表。
表4 TraceTopologyLine

参数

参数类型

描述

start_node_id

Long

开始节点id。

end_node_id

Long

结束节点id。

span_id

String

调用跨度id。

client_info

TraceTopologyLineInfo object

客户端看到的信息。

server_info

TraceTopologyLineInfo object

服务端信息。

id

String

id。

hint

String

获取一条线的提示信息。
表5 TraceTopologyLineInfo

参数

参数类型

描述

start_time

Long

开始时间。

time_used

Long

耗时。

argument

String

参数信息，比如调用的url信息等。

event_id

String

event的id。
表6 TraceTopologyNode

参数

参数类型

描述

node_id

Long

节点id。

node_name

String

节点名称。

hint

String

节点提示字段。

请求示例

查询trace_id为16-1666684411910-1326的调用链拓扑图。

/v1/apm2/openapi/view/trace/topology?region=xxx-roma-2&trace_id=16-1666684411910-1326

响应示例

状态码： 200

OK，请求响应成功。

{
  "node_list" : [ {
    "node_id" : 11,
    "node_name" : "apm-pu-task:xxx-roma-2",
    "hint" : null
  } ],
  "line_list" : [ {
    "start_node_id" : null,
    "end_node_id" : 11,
    "span_id" : "1",
    "client_info" : null,
    "server_info" : {
      "start_time" : 1666684411910,
      "time_used" : 1,
      "argument" : "(GET)(/apm2/health/v1/health-check)(200)",
      "event_id" : "1"
    },
    "hint" : "(1)((GET)(/apm2/health/v1/health-check)(200))",
    "id" : "1+1"
  } ],
  "global_trace_id" : null
}

状态码

状态码

描述

200

OK，请求响应成功。

400

Bad Request，语义或参数有误。

401

Unauthorized，没有权限。

403

Forbidden，禁止访问。

404

Not Found，没有找到要请求的资源。

错误码

请参见错误码。

父主题： 视图信息

相关文档