調用GetTrace API擷取調用鏈路詳情-可觀測鏈路 OpenTelemetry 版-阿里雲

調用GetTrace介面擷取調用鏈路詳情。

調試

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

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

xtrace:SearchTrace

get

*全部資源

*

無

請求參數

名稱	類型	必填	描述	樣本值
TraceID	string	是	調用鏈 ID，鏈路請求的唯一標識。可在控制台的調用鏈分析頁面擷取，也可通過 SearchTraces API 擷取。	1c6881aab84191a4******
AppType	string	否	應用類型，取值為空白或`XTRACE`，推薦設定為空白。空：查詢 XTRACE 和 ARMS 調用鏈。 `XTRACE`：只查詢 XTRACE 調用鏈。	XTRACE
RegionId	string	是	地區 ID。	cn-beijing
PageNumber	integer	否	查詢分頁的頁碼。	1
PageSize	string	否	查詢分頁的每頁專案數量，最大值為 100。	5

返回參數

名稱	類型	描述	樣本值
	object
RequestId	string	請求 ID。	1E2B6A4C-6B83-4062-8B6F-AEEC1F******
Spans	object
Span	array<object>	Span 列表。
	array<object>	span 列表。
SpanId	string	Span ID。	fec891bb8f8XXX
HaveStack	boolean	是否有子 Span。取值： `true`：有子 Span。 `false`：無子 Span。	false
ServiceIp	string	服務 IP 位址，即 Span 所在的機器 IP 位址。	192.168.XXX.XXX
OperationName	string	Span 名稱。	/api
ParentSpanId	string	父 Span ID。	fec891bb8f8XXX
ResultCode	string	返回碼。	200
Duration	integer	耗時，單位為毫秒（ms）。	1000
RpcId	string	表示 Span 之間的父子兄弟關係。例如 1.1 是 1.1.1 的父親 Span，而 1.1.2 和 1.1.1 是兄弟 Span。	1.1
Timestamp	integer	Span 的產生時間戳記。單位為微秒（μm）。	1689845513298000
ServiceName	string	服務名稱，又稱為應用程式名稱。	server1
TraceID	string	調用鏈 ID，鏈路請求的唯一標識。	1c6881aab84191a4
TagEntryList	object
TagEntry	array<object>	標籤列表。
	object	標籤列表。
Key	string	Span 的標籤鍵。	logLevel
Value	string	Span 的標籤值。	Warning
LogEventList	object
LogEvent	array<object>	日誌事件列表。
	array<object>	日誌事件列表。
Timestamp	integer	日誌事件的產生時間戳記。單位為微秒（μm）。	1689845513298000
TagEntryList	object
TagEntry	array<object>	標籤列表。
	object	標籤列表。
Key	string	日誌事件的標籤鍵。	logLevel
Value	string	日誌事件的標籤值。	Warning
StatusCode	integer	狀態代碼。	200

樣本

正常返回樣本

JSON格式

{
  "RequestId": "1E2B6A4C-6B83-4062-8B6F-AEEC1F******",
  "Spans": {
    "Span": [
      {
        "SpanId": "fec891bb8f8XXX",
        "HaveStack": false,
        "ServiceIp": "192.168.XXX.XXX",
        "OperationName": "/api",
        "ParentSpanId": "fec891bb8f8XXX",
        "ResultCode": "200",
        "Duration": 1000,
        "RpcId": "1.1",
        "Timestamp": 1689845513298000,
        "ServiceName": "server1",
        "TraceID": "1c6881aab84191a4",
        "TagEntryList": {
          "TagEntry": [
            {
              "Key": "logLevel",
              "Value": "Warning"
            }
          ]
        },
        "LogEventList": {
          "LogEvent": [
            {
              "Timestamp": 1689845513298000,
              "TagEntryList": {
                "TagEntry": [
                  {
                    "Key": "logLevel",
                    "Value": "Warning"
                  }
                ]
              }
            }
          ]
        },
        "StatusCode": 200
      }
    ]
  }
}

錯誤碼

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

變更歷史

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