文档

GetMultipleTrace - 获取多个调用链详情

更新时间:

获取多个调用链的详情。

调试

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

授权信息

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

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

请求参数

名称类型必填描述示例值
RegionIdstring

地域 ID。

cn-hangzhou
TraceIDsarray

调用链 ID 列表。

string

调用链 ID,最少填写 1 个,最多填写 9 个。可在 ARMS 控制台的调用链路查询页面获取。

ac1400a115951745017447033d****
StartTimelong

调用链路开始时间的时间戳,单位为毫秒。

1657692507000
EndTimelong

调用链路结束时间的时间戳,单位为毫秒。

1663999380000

返回参数

名称类型描述示例值
object
RequestIdstring

请求 ID。

2983BEF7-4A0D-47A2-94A2-8E9C5E63****
MultiCallChainInfosarray<object>

多个调用链路的信息。

object
TraceIDstring

调用链路 ID。

ac1400a115951745017447033d****
Spansarray<object>

调用链路详情信息。

object
SpanIdstring

Span ID。

1234
OperationNamestring

埋点的接口名称。

/demo/queryNotExistDB/11
ResultCodestring

返回码。

1
Timestamplong

时间戳。

1595174501747
RpcTypeinteger

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
ServiceIpstring

应用所在机器的 IP 地址。

172.20.XX.XX
HaveStackboolean

是否有方法栈:

  • true:有方法栈
  • false:没有方法栈
true
ParentSpanIdstring

父 Span ID。

18
Durationlong

调用链路耗时(毫秒)。

11
RpcIdstring

RPC ID

0.1
ServiceNamestring

应用名称。

arms-k8s-demo-subcomponent
TraceIDstring

调用链路 ID。

ac1400a115951745017447033d****
TagEntryListarray<object>

调用链路的 Tag 列表。

object
Keystring

Tag 的主键。

http.status.code
Valuestring

Tag 的值。

200
LogEventListarray<object>

调用链路中的日志事件。

object
Timestamplong

产生日志时间的时间戳。

1595174501747
TagEntryListarray<object>

调用链路的 Tag 列表。

object
Keystring

Tag 的主键。

http.status.code
Valuestring

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-16API 内部配置变更,不影响调用查看变更详情
2023-12-21API 内部配置变更,不影响调用查看变更详情