文档首页 > > API参考> API说明> 查询调用链

查询调用链

分享
更新时间:2020/07/29 GMT+08:00

功能介绍

根据查询条件,查询调用链数据。

URI

GET /v1/{projectId}/ats/traces

请求消息

请求消息头

请求消息头如表1 请求消息头所示。

表1 请求消息头

参数

描述

是否为必选

示例

clusterId

集群ID

default

namespace

命名空间

manage

路径参数

路径参数表2 路径参数如所示。

表2 路径参数

参数

参数类型

描述

projectId

string

工程ID

请求参数

请求参数如表3 请求参数所示。

表3 请求参数

参数

是否必选

取值类型

取值范围

描述

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

响应消息

响应参数

响应参数如表4 响应参数所示。

表4 响应参数

参数

参数类型

描述

errorCode

string

响应错误码,

SVCSTG.ATS.2000:查询成功

SVCSTG.ATS.400101:参数校验失败

SVCSTG.ATS.200103:没有找到调用链数据

errorMessage

string

响应错误信息描述

responseInfo

result

调用链查询结果

表5 result字段数据结构说明

参数

参数类型

描述

count

int

本次查询到的调用链数量

traceChains

List<TraceChainBase>

调用链数据集合

表6 TraceChainBase字段数据结构说明

参数

参数类型

描述

traceId

string

调用链的ID,全局唯一

type

string

服务类型

status

int

调用返回状态

duration

long

业务调用耗时(单位us)

application

string

服务名称

instance

string

实例名称

transaction

string

业务调用接口/业务名称

startTime

long

业务调用开始时间(单位us)

endTime

long

业务调用结束时间(单位us)

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"
      }
    ]
  }
}

状态码

  • 正常
    状态码如表7 状态码所示。
    表7 状态码

    状态码

    描述

    200

    请求响应成功

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问