查询调用链详情
功能介绍
根据调用链的traceId信息查询调用链详情。
URI
GET /v1/{project_id}/ats/spans
请求消息
| 参数 | 描述 | 是否为必选 | 示例 |
|---|---|---|---|
| clusterId | 集群ID | 否 | default |
| namespace | 命名空间 | 否 | manage |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| project_id | string | 工程ID |
| 参数 | 是否必选 | 取值类型 | 取值范围 | 描述 |
|---|---|---|---|---|
| traceId | 是 | string | 从查询的调用链数据中获取 | 调用链的ID |
请求示例
/v1/0/ats/spans?traceId=0000000027046b00
响应消息
| 参数 | 参数类型 | 描述 |
|---|---|---|
| errorCode | string | 响应错误码， SVCSTG.ATS.2000：查询成功 SVCSTG.ATS.400101：参数校验失败 SVCSTG.ATS.200103：没有找到调用数据 |
| errorMessage | string | 响应错误信息描述 |
| responseInfo | list(string),数据结构参见(表5) | 调用链查询结果 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| traceId | string | 调用链ID，全局唯一 |
| name | string | 服务名称:实例名称:事务名称 |
| id | string | Span的ID |
| parentId | string | 当前Span的上级Span ID信息 |
| timestamp | long | 调用的起始时间(单位μs) |
| duration | long | Span调用耗时(单位μs) |
| annotations | list(string)，数据结构参见(表6) | 调用中客户端或服务端服务信息描述 |
| binaryAnnotations | list(string)，数据结构参见(表7) | 调用中的扩展信息描述 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| timestamp | long | 某事件发生的本地当前系统时间(单位μs) |
| endpoint | 数据结构参见表8 | 调用端服务信息描述，可选 |
| value | string | 调用事件类型，取值范围{CS、SR、SS、CR}
|
| 参数 | 参数类型 | 描述 |
|---|---|---|
| key | string | 扩展信息的名称 |
| endpoint | 数据结构参见表8 | 调用端服务信息描述，可选 |
| value | string | 扩展信息的值 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| serviceName | string | 调用端服务名称，可选 |
| ipv4 | string | 调用端服务IP信息，可选 |
| port | string | 调用端服务接口信息，可选 |
响应示例
{
"errorCode": "SVCSTG.ATS.2000",
"errorMessage":null,
"responseInfo": [
"{\"traceId\":\"0000000027046b00\",\"id\":\"b42460f5cf86cab4\",\"name\":\"aos-apiserver:aos-apiserver-1005774711-ll63p:/api/v1/namespaces/manage/pods\",\"timestamp\":1506260836597000,\"duration\":67000,\"annotations\":[{\"timestamp\":1506260836597000,\"value\":\"cs\",\"endpoint\":{\"serviceName\":\"aos-apiserver\",\"ipv4\":\"10.186.60.43\",\"port\":6443}},{\"timestamp\":1506260836664000,\"value\":\"cr\",\"endpoint\":{\"serviceName\":\"aos-apiserver\",\"ipv4\":\"10.186.60.43\",\"port\":6443}}],\"binaryAnnotations\":[{\"key\":\"append\",\"value\":\"GET\"},{\"key\":\"async\",\"value\":\"0\"},{\"key\":\"goid\",\"value\":\"58\"},{\"key\":\"result\",\"value\":\"0\"},{\"key\":\"resultCode\",\"value\":\"200\"},{\"key\":\"seqno\",\"value\":\"1506260836597048618\"},{\"key\":\"type\",\"value\":\"1\"}]}"
]
} 状态码
- 正常
