GetMultipleTrace - 获取多个调用链详情 - 应用实时监控服务ARMS

获取多个调用链的详情。

调试

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

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作	访问级别	资源类型	条件关键字	关联操作
arms:GetMultipleTrace	none	全部资源 *	无	无

请求参数

名称	类型	必填	描述	示例值
RegionId	string	是	地域 ID。	cn-hangzhou
TraceIDs	array	是	调用链 ID 列表。
	string	是	调用链 ID，最少填写 1 个，最多填写 9 个。可在 ARMS 控制台的调用链路查询页面获取。	ac1400a115951745017447033d****
StartTime	long	是	调用链路开始时间的时间戳，单位为毫秒。	1657692507000
EndTime	long	是	调用链路结束时间的时间戳，单位为毫秒。	1663999380000

返回参数

名称	类型	描述	示例值
	object
RequestId	string	请求 ID。	2983BEF7-4A0D-47A2-94A2-8E9C5E63****
MultiCallChainInfos	array<object>	多个调用链路的信息。
MultiCallChainInfo	object
TraceID	string	调用链路 ID。	ac1400a115951745017447033d****
Spans	array<object>	调用链路详情信息。
Span	object
SpanId	string	Span ID。	1234
OperationName	string	埋点的接口名称。	/demo/queryNotExistDB/11
ResultCode	string	返回码。	1
Timestamp	long	时间戳。	1595174501747
RpcType	integer	RPC 类型： -2 front -3 app 0 http 25 http_client 1 hsf_client 2 hsf 40 local 41 async 52 DB2 53 Informix 54 SequoiaDB 55 Gbase 56 GaussDB 57 KingBase 58 infuxdb 59 clickhouse 60 mysql 61 mysql 62 oracle 63 postgresql 64 mongodb 65 ppas 66 sqlserver 67 mariadb 68 dmdb 69 oceanbase 70 redis 71 memcached 72 elasticsearch 73 kudu 4 tddl 5 tair 13 mq_client 252 mq 23 kafka_client 256 kafka 3 notify_client 254 notify 7 dubbo_client 8 dubbo 11 dsf_client 12 dsf 9 grpc 10 grpc_client 16 thrift 17 thrift_client 18 sofa 19 sofa_client -1 unknown 98 user_method 100 root 101 client 102 server 103 producer 104 consumer 105 db 106 xtrace_other 1301 schedulerx 1302 XXL_Job 1303 Spring_Scheduled 1304 Quartz 1305 ElasticJob 1308 Jdk_Timer	0
ServiceIp	string	应用所在机器的 IP 地址。	172.20.XX.XX
HaveStack	boolean	是否有方法栈： `true`：有方法栈 `false`：没有方法栈	true
ParentSpanId	string	父 Span ID。	18
Duration	long	调用链路耗时（毫秒）。	11
RpcId	string	RPC ID	0.1
ServiceName	string	应用名称。	arms-k8s-demo-subcomponent
TraceID	string	调用链路 ID。	ac1400a115951745017447033d****
TagEntryList	array<object>	调用链路的 Tag 列表。
TagEntry	object
Key	string	Tag 的主键。	http.status.code
Value	string	Tag 的值。	200
LogEventList	array<object>	调用链路中的日志事件。
LogEvent	object
Timestamp	long	产生日志时间的时间戳。	1595174501747
TagEntryList	array<object>	调用链路的 Tag 列表。
TagEntry	object
Key	string	Tag 的主键。	http.status.code
Value	string	Tag 的值。	200

示例

正常返回示例

JSON格式

{
  "RequestId": "2983BEF7-4A0D-47A2-94A2-8E9C5E63****",
  "MultiCallChainInfos": [
    {
      "TraceID": "ac1400a115951745017447033d****",
      "Spans": [
        {
          "SpanId": "1234",
          "OperationName": "/demo/queryNotExistDB/11",
          "ResultCode": "1",
          "Timestamp": 1595174501747,
          "RpcType": 0,
          "ServiceIp": "172.20.XX.XX",
          "HaveStack": true,
          "ParentSpanId": "18",
          "Duration": 11,
          "RpcId": "0.1",
          "ServiceName": "arms-k8s-demo-subcomponent",
          "TraceID": "ac1400a115951745017447033d****",
          "TagEntryList": [
            {
              "Key": "http.status.code",
              "Value": "200"
            }
          ],
          "LogEventList": [
            {
              "Timestamp": 1595174501747,
              "TagEntryList": [
                {
                  "Key": "http.status.code",
                  "Value": "200"
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}

错误码

访问错误中心查看更多错误码。

变更历史

变更时间	变更内容概要	操作
2024-08-16	API 内部配置变更，不影响调用	查看变更详情
2023-12-21	API 内部配置变更，不影响调用	查看变更详情