全部產品
Search

搜尋本產品

    Application Real-Time Monitoring Service：GetTrace - 擷取調用鏈詳情

    文件中心

    Application Real-Time Monitoring Service：GetTrace - 擷取調用鏈詳情

    更新時間：Apr 10, 2026

    加快擷取調用鏈詳情。

    介面說明

    說明

    Java SDK 需更新至版本 v2.7.24。

    調試

    您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

    調試

    授權資訊

    當前API暫無授權資訊透出。

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    TraceID

    string

    是

    調用鏈 ID。可在 ARMS 控制台的調用鏈路查詢頁面或介面快照頁面擷取。

    ac14001a15954493811405707d****
    RegionId

    string

    是

    地區 ID。

    cn-hangzhou
    StartTime

    integer

    否

    開始時間的時間戳記，精確到毫秒。

    說明

    若 TraceID 長度為 30，可不填；若 TraceID 長度不是 30，則必填。

    1623827602000
    EndTime

    integer

    否

    結束時間的時間戳記，精確到毫秒。

    說明

    若 TraceID 長度為 30，可不填；若 TraceID 長度不是 30，則必填。

    1623827603000
    PageNumber

    integer

    否

    查詢分頁的頁碼。

    1
    PageSize

    integer

    否

    查詢分頁的每頁專案數量，最大值為 100。

    10

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    RequestId

    string

    請求 ID。

    6A9AEA84-7186-4D8D-B498-4585C6A2****
    Spans

    array<object>

    調用鏈路詳細資料。

    array<object>

    SpanId

    string

    Span ID。

    1234
    OperationName

    string

    埋點的介面名稱。

    /api/demo
    ResultCode

    string

    返回碼。

    222
    Timestamp

    integer

    Span 的產生時間戳記。

    1590388651
    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

    1
    ServiceIp

    string

    應用所在機器的 IP 位址。

    172.20.XX.XX
    HaveStack

    boolean

    是否有方法棧：

    • true：有方法棧。

    • false：沒有方法棧。

    false
    ParentSpanId

    string

    父 Span ID。

    18
    Duration

    integer

    調用鏈路耗時，單位為毫秒。

    1000
    RpcId

    string

    RPC ID。

    0
    ServiceName

    string

    應用程式名稱。

    arms-demo
    TraceID

    string

    調用鏈路 ID。

    ac14001a15954493811405707d****
    TagEntryList

    array<object>

    調用鏈路的 Tag 列表。

    object

    Key

    string

    Tag 的鍵。

    http.status.code
    Value

    string

    Tag 的值。

    200
    LogEventList

    array<object>

    調用鏈路中的日誌事件。

    array<object>

    Timestamp

    integer

    日誌事件的產生時間戳記。

    1590388651
    TagEntryList

    array<object>

    調用鏈路的 Tag 列表。

    object

    Key

    string

    Tag 的鍵。

    http.status.code
    Value

    string

    Tag 的值。

    200
    Children

    array<object>

    當前 Span 的子 Span 的列表。

    object

    子 Span 詳情。

    [ { "ParentSpanId":"c33603355032xxxx", "ServiceIp":"10.208.xxx.xxx", "OperationName":"/product/toy/8ac7ddeb-1c3c-4911-850c-665a5a0xxxx", "RpcType":0, "Duration":2, "TagEntryList":[ { "Value":"10.208.0.xxx", "Key":"source.ip" } ], "Timestamp":1652669026201, "HaveStack":true, "LogEventList":[ ], "ServiceName":"xxxxxx", "RpcId":"0.2", "TraceID":"ea1ad000a1165266902619685xxxxx", "Children":[ ], "ResultCode":"0", "SpanId":"7069ab30d7cbxxxx" } ]

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "6A9AEA84-7186-4D8D-B498-4585C6A2****",
  "Spans": [
    {
      "SpanId": "1234",
      "OperationName": "/api/demo",
      "ResultCode": "222",
      "Timestamp": 1590388651,
      "RpcType": 1,
      "ServiceIp": "172.20.XX.XX",
      "HaveStack": false,
      "ParentSpanId": "18",
      "Duration": 1000,
      "RpcId": "0",
      "ServiceName": "arms-demo",
      "TraceID": "ac14001a15954493811405707d****",
      "TagEntryList": [
        {
          "Key": "http.status.code",
          "Value": "200"
        }
      ],
      "LogEventList": [
        {
          "Timestamp": 1590388651,
          "TagEntryList": [
            {
              "Key": "http.status.code",
              "Value": "200"
            }
          ]
        }
      ],
      "Children": [
        [
          {
            "ParentSpanId": "c33603355032xxxx",
            "ServiceIp": "10.208.xxx.xxx",
            "OperationName": "/product/toy/8ac7ddeb-1c3c-4911-850c-665a5a0xxxx",
            "RpcType": 0,
            "Duration": 2,
            "TagEntryList": [
              {
                "Value": "10.208.0.xxx",
                "Key": "source.ip"
              }
            ],
            "Timestamp": 1652669026201,
            "HaveStack": true,
            "LogEventList": [],
            "ServiceName": "xxxxxx",
            "RpcId": "0.2",
            "TraceID": "ea1ad000a1165266902619685xxxxx",
            "Children": [],
            "ResultCode": "0",
            "SpanId": "7069ab30d7cbxxxx"
          }
        ]
      ]
    }
  ]
}

    錯誤碼

    訪問錯誤中心查看更多錯誤碼。

    變更歷史

    更多資訊，參考變更詳情。