查询调用链
功能介绍
根据查询条件，查询调用链数据。
URI
GET /v1/{project_id}/ats/traces
请求消息
参数 | 描述 | 是否为必选 | 示例 |
|---|---|---|---|
clusterId | 集群ID | 否 | default |
namespace | 命名空间 | 否 | manage |
参数 | 参数类型 | 描述 |
|---|---|---|
project_id | string | 工程ID |
参数 | 是否必选 | 取值类型 | 取值范围 | 描述 |
|---|---|---|---|---|
startTime | 是 | long | <endTime | 调用链查询开始时间(单位ms) |
endTime | 是 | long | >startTime | 调用链查询结束时间(单位ms) |
application | 是 | string | 参见查询服务列表 | 服务名称 服务名称中的英文字母必须小写，如：“test-service” |
monitorGroup | 否 | string | 参见查询应用列表 | 应用名称 |
instance | 否 | string | 参见查询服务实例列表 | 实例名称 实例名称中的英文字母必须小写，如：“test-service-4195149926-0fvhn” |
transaction | 否 | string | 参见查询服务事务列表 | 事务名称, 如：“GET_/rest/healthz/*” |
limit | 否 | int | <=1000，>0的整数 | 默认为20，单次查询返回的条数限制，最大单次返回1000条 |
duration | 否 | int | >=0的整数 | 默认为0，调用链最小耗时（单位ms） |
status | 否 | int | 1：事务执行失败 | 事务状态，默认查询所有状态的数据，为1时查询调用失败的数据 |
请求示例
/v1/0/ats/traces?startTime=1506214200000&endTime=1506214428000&application=datamgmtservice&monitorGroup=apm&limit=1
响应消息
参数 | 参数类型 | 描述 |
|---|---|---|
errorCode | string | 响应错误码， SVCSTG.ATS.2000：查询成功 SVCSTG.ATS.400101：参数校验失败 SVCSTG.ATS.200103：没有找到调用链数据 |
errorMessage | string | 响应错误信息描述 |
responseInfo | result | 调用链查询结果 |
参数 | 参数类型 | 描述 |
|---|---|---|
count | int | 本次查询到的调用链数量 |
traceChains | List<TraceChainBase> | 调用链数据集合 |
参数 | 参数类型 | 描述 |
|---|---|---|
traceId | string | 调用链的ID，全局唯一 |
type | string | 服务类型 |
status | int | 调用返回状态 |
duration | long | 业务调用耗时(单位μs) |
application | string | 服务名称 |
instance | string | 实例名称 |
transaction | string | 业务调用接口/业务名称 |
startTime | long | 业务调用开始时间(单位μs) |
endTime | long | 业务调用结束时间(单位μs) |
address | string | 调用发起端IPV4地址 |
响应示例
{
"errorCode": "SVCSTG.ATS.2000",
"errorMessage":null,
"responseInfo": {
"count": 1,
"traceChains": [
{
"traceId": "000000004fa102d1",
"type": "TOMCAT_METHOD",
"status": 0,
"duration": 10000,
"application": "datamgmtservice",
"instance": "datamgmtservice-4267750592-2ngmz",
"transaction": "/rest/plat/sysmgr/v1/sysagent/alarm/report",
"startTime": 1506214214095000,
"endTime": 1506214214105000,
"address": "192.168.0.1"
}
]
}
} 状态码
- 正常
