调用GetTrace接口获取调用链详情。

调试

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

请求参数

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

系统规定参数,取值为GetTrace

RegionId String cn-hangzhou

地域ID。

TraceID String ac14001a15954493811405707d****

调用链ID。可在ARMS控制台的调用链路查询页面或接口快照页面获取。

返回数据

名称 类型 示例值 描述
Spans Array

调用链路详情信息

Duration Long 1000

调用链路耗时(毫秒)

HaveStack Boolean false

是否有方法栈:

  • true:有方法栈
  • false:没有方法栈
LogEventList Array

调用链路中的日志事件

TagEntryList Array

调用链路的Tag列表

Key String http.status.code

Tag的主键

Value String 200

Tag的值

Timestamp Long 1590388651

时间戳

OperationName String /api/demo

埋点的接口名称

ResultCode String 222

返回码

RpcId String 0

RPC ID

RpcType Integer 1

RPC类型

ServiceIp String 172.20.XX.XX

应用所在机器的IP地址

ServiceName String arms-demo

应用名称

TagEntryList Array

调用链路的Tag列表

Key String http.status.code

Tag的主键

Value String 200

Tag的值

Timestamp Long 1590388651

时间戳

TraceID String ac14001a15954493811405707d****

调用链路ID

RequestId String 6A9AEA84-7186-4D8D-B498-4585C6A2****

请求ID

示例

请求示例

http(s)://[Endpoint]/?Action=GetTrace
&RegionId=cn-hangzhou
&TraceID=ac14001a15954493811405707d****
&<公共请求参数>

正常返回示例

XML 格式

<GetTraceResponse>
	  <RequestId>6A9AEA84-7186-4D8D-B498-4585C6A2****</RequestId>
	  <Spans>
		    <HaveStack>true</HaveStack>
		    <ServiceIp>172.20.XX.XX</ServiceIp>
		    <OperationName>/api/demo</OperationName>
		    <ServiceName>arms-demo</ServiceName>
		    <RpcId>0.1</RpcId>
		    <RpcType>0</RpcType>
		    <TraceID>ac14001a15954493811405707d****</TraceID>
		    <Duration>1000</Duration>
		    <TagEntryList>
			      <Value>200</Value>
			      <Key>http.status.code</Key>
		    </TagEntryList>
		    <TagEntryList>
			      <Value>172.20.XX.XX</Value>
			      <Key>source.ip</Key>
		    </TagEntryList>
		    <Timestamp>1590388651</Timestamp>
		    <ResultCode>0</ResultCode>
	  </Spans>
</GetTraceResponse>

JSON 格式

{
	"RequestId": "6A9AEA84-7186-4D8D-B498-4585C6A2****",
	"Spans": [
		{
			"HaveStack": true,
			"ServiceIp": "172.20.XX.XX",
			"LogEventList": [],
			"OperationName": "/api/demo",
			"ServiceName": "arms-demo",
			"RpcId": "0.1",
			"RpcType": 0,
			"TraceID": "ac14001a15954493811405707d****",
			"Duration": 1000,
			"TagEntryList": [
				{
					"Value": "200",
					"Key": "http.status.code"
				},
				{
					"Value": "172.20.XX.XX",
					"Key": "source.ip"
				}
			],
			"Timestamp": 1590388651,
			"ResultCode": "0"
		}
	]
}