調用SearchTraces按條件過濾查詢調用鏈-應用即時監控服務-阿里雲

調用SearchTraces查詢調用鏈列表，可根據時間、應用程式名稱、IP地址、Span名稱、Tag等資訊對調用鏈進行過濾查詢。

調試

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

調試

授權資訊

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

xtrace:SearchTrace

get

*全部資源

*

無

請求參數

名稱	類型	必填	描述	樣本值
StartTime	integer	是	開始時間，精確到毫秒（ms）。	1714298814000
EndTime	integer	是	結束時間，精確到毫秒（ms）。	1714385214000
RegionId	string	是	地區 ID。	cn-beijing
ServiceName	string	否	微服務名稱，又稱為應用程式名稱。	service 1
OperationName	string	否	Span 名稱，即某個跟蹤點或埋點的名稱。	/api
MinDuration	integer	否	大於某個時間跨度範圍，單位為毫秒（ms）。例如，200 表示大於 200 毫秒的資料。	2
AppType	string	否	應用類型，取值為空白或`XTRACE`，推薦設定為空白。空：查詢 XTRACE 和 ARMS 調用鏈。 `XTRACE`：只查詢 XTRACE 調用鏈。	XTRACE
PageNumber	integer	否	頁碼，例如，5 表示第 5 頁。	1
PageSize	integer	否	每頁的查詢資料條數。	20
Reverse	boolean	否	按照時間正序或者倒序排列。預設為`false`。取值： `true`：倒序。 `false` ：順序。	false
ServiceIp	string	否	Span 對應主機的 IP 位址。	192.163.XXX.XXX
Tag	array<object>	否	標籤列表。
	object	否	標籤列表。
Key	string	否	標籤鍵。	http.status_cod
Value	string	否	標籤值。	200
StatusCode	string	否

返回參數

名稱	類型	描述	樣本值
	object
RequestId	string	請求 ID。	1E2B6A4C-6B83-4062-8B6F-AEEC1F******
PageBean	object	返回資料的位置資訊。
PageSize	integer	每頁顯示的資料條數。	20
PageNumber	integer	頁碼。	1
TotalCount	integer	總條數。	500
TraceInfos	object
TraceInfo	array<object>	返回的調用鏈資訊。
	array<object>	返回的調用鏈資訊。
OperationName	string	Span 名稱。	/api
ServiceIp	string	Span 所在的主機 IP 位址或主機名稱。	192.163.XXX.XXX
Duration	integer	耗時，單位為毫秒（ms）。	500
Timestamp	integer	Span 產生時間，單位為毫秒（ms）。	1714306014000
ServiceName	string	微服務名稱，又稱為應用程式名稱。	service1
TraceID	string	調用鏈 ID。	1c6881aab841******
TagMap	object	標籤資訊。	{"env":"dev"}
StatusCode	integer

樣本

正常返回樣本

JSON格式

{
  "RequestId": "1E2B6A4C-6B83-4062-8B6F-AEEC1F******",
  "PageBean": {
    "PageSize": 20,
    "PageNumber": 1,
    "TotalCount": 500,
    "TraceInfos": {
      "TraceInfo": [
        {
          "OperationName": "/api",
          "ServiceIp": "192.163.XXX.XXX",
          "Duration": 500,
          "Timestamp": 1714306014000,
          "ServiceName": "service1",
          "TraceID": "1c6881aab841******",
          "TagMap": {
            "env": "dev"
          },
          "StatusCode": 0
        }
      ]
    }
  }
}

錯誤碼

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

變更歷史

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