调用链span详情查询
更新时间 2026-08-05 10:24:01
最近更新时间: 2026-08-05 10:24:01
接口功能介绍
调用链span详情查询
接口约束
无
URI
GET /v1/transactions/traceSpanDetail
路径参数 无
Query参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| traceId | 是 | String | 调用链Id | f4d605359ae5095b82d16c91610 | |
| spanId | 是 | String | span Id | 0559ae696fc0b | |
| timestamp | 是 | Long | 时间戳(ms) | 1717430400000 |
请求参数
请求头header参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| regionId | 是 | String | 资源池编码,请参考资源池列表 | bb9fdb42056f11eda1610242ac110002 |
请求体body参数 无
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| statusCode | Integer | 响应状态码(800:成功;900:失败) | 800 | |
| error | String | 错误码,仅错误时返回 | APM_5000 | |
| message | String | 响应信息 | success | |
| returnObj | Object | 调用链span详情 | SpanDTO |
表 SpanDTO
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| dstServiceResource | String | 目标服务Resource | 123.60.43.175:6379 | |
| dstServiceName | String | 目标服务Name | redis | |
| dstServiceType | String | 目标服务类型 | db | |
| responseStatusCode | String | http响应状态码 | 200 | |
| clientAddress | String | 客户端地址 | 127.0.0.1 | |
| clientPort | String | 客户端端口 | 3000 | |
| serverAddress | String | 服务端地址 | 127.0.0.1 | |
| serverPort | String | 服务端端口 | 3000 | |
| processId | Integer | 进程Id | 1 | |
| processCommandLine | String | 进程命令 | java -jar myService | |
| threadId | Integer | 线程Id | 126 | |
| threadName | String | 线程名 | http-nio-8080-exec-5 | |
| hostName | String | 主机名 | 172-26-215-203 | |
| hostArchitecture | String | 主机CPU架构 | amd64 | |
| hostOSPlatform | String | 主机操作系统类型 | linux | |
| hostOSFull | String | 主机操作系统名称 | x86_64 | |
| otherAttributes | Object | 其他属性 | ||
| httpObject | Object | http相关属性 | ||
| dbObject | Object | 数据库相关属性 | ||
| rpcObject | Object | rpc相关属性 | ||
| messagingObject | Object | 消息相关属性 | ||
| netObject | Object | 网络相关属性 |
枚举参数
无
请求示例
请求url
GET https://arms-global.ctapi.ctyun.cn/v1/transactions/traceSpanDetail?traceId=f4d605359ae5095b82d16c91610&spanId=0559ae696fc0b
请求头header
{
"regionId":"bb9fdb42056f11eda1610242ac110002"
}
请求体body
无
响应示例
{
"statusCode": 800,
"error": null,
"message": "success",
"returnObj": {
"dstServiceResource": "123.60.43.175:6379",
"dstServiceName": "server",
"dstServiceType": "http",
"responseStatusCode": null,
"clientAddress": "4.0.1.226",
"clientPort": null,
"serverAddress": "123.60.43.175:6379",
"serverPort": 6379,
"processId": 47016,
"processCommandLine": "D:\\tools\\Java\\jdk-1.8\\jre;bin;java.exe
"threadId": 90,
"threadName": "http-nio-8080-exec-1",
"hostName": "myHost",
"hostArchitecture": "amd64",
"hostOSPlatform": "windows",
"hostOSFull": "Windows 11 10.0",
"otherAttributes": {
"dropType": "DROP_TYPE_UNSAMPLED",
"jdk.version": "1.8.0_361-b09",
"environment.code": "_carms_",
"ip": "172.16.3.242",
"container.id": "62830d198ad013416824e5787b44e18b26c4b27cf34278470c53d3e294e62780",
"is.error.span": "true",
"agent.version": "1.9.0-P1",
"carms.agent.type": "carms",
"is.slow.span": "true",
"app.from": "ecs",
"app.language": "java",
"carms.license.type": "1"
},
"httpObject": {
"http.flavor": "1.1",
"http.method": "POST",
"http.url": "http://198.20.1.79:27195/nacos/v1/auth/users/login?username=nacos"
},
"dbObject": {},
"rpcObject": {},
"messagingObject": {},
"netObject": {
"net.transport": "ip_tcp",
"net.peer.addr": "198.20.1.79:27195",
"net.peer.port": "27195",
"net.peer.name": "198.20.1.79"
}
}
状态码
请参考 状态码
错误码
请参考 错误码