追蹤
適用於:所有 API 管理 層
trace
原則會將自訂追蹤新增至測試主控台、Application Insights 遙測和/或資源記錄中。
- 原則會在觸發追蹤時,將自定義追蹤新增至 測試控制台中的要求追蹤 輸出。
- Application Insights 整合啟用時,若原則中指定的
severity
大於或等於診斷設定中指定的verbosity
時,原則就會在 Application Insights 中建立追蹤遙測。 - 資源記錄啟用時,若原則中指定的嚴重性層級高於或等於診斷設定中指定的詳細程度層級,原則就會在記錄項目中新增屬性。
- 此原則不會受到 Application Insights 取樣的影響。 系統會記錄所有原則呼叫。
重要
- 設定 ,就無法再啟用 API 管理 要求追蹤要求中的 Ocp-Apim-Trace 標頭,並在回應中使用 Ocp-Apim-Trace-Location 標頭的值來擷取追蹤。
- 為了改善安全性,現在透過使用 API 管理 REST API 取得限時令牌,並將令牌傳遞至網關,以在個別 API 層級啟用追蹤。 如需詳細資訊,請參閱本教學課程稍後的。
- 啟用追蹤時請小心,因為它可以在追蹤數據中公開敏感性資訊。 請確定您已具備適當的安全性措施來保護追蹤數據。
注意
目前,基本 v2 和標準 v2 層不支援 API 要求的追蹤。
注意
請依照原則陳述式中提供的順序,來設定原則的元素和子元素。 深入了解如何設定或編輯 APIM 原則。
原則陳述式
<trace source="arbitrary string literal" severity="verbose | information | error">
<message>String literal or expressions</message>
<metadata name="string literal or expressions" value="string literal or expressions"/>
</trace>
屬性
屬性 | 描述 | 是必要欄位 | 預設 |
---|---|---|---|
來源 | 對追蹤檢視器有意義,並指定了訊息來源的字串常值。 不允許使用原則運算式。 | Yes | N/A |
severity | 指定追蹤的嚴重性層級。 允許的值為 verbose 、information 、error (從最低到最高)。 不允許使用原則運算式。 |
No | verbose |
元素
名稱 | 描述 | 必要 |
---|---|---|
message | 要記錄的字串或運算式。 允許使用原則運算式。 | Yes |
中繼資料 | 將自訂屬性新增至 Application Insights 追蹤遙測。 | No |
中繼資料屬性
屬性 | 描述 | 是必要欄位 | 預設 |
---|---|---|---|
NAME | 屬性的名稱。 | Yes | N/A |
value | 屬性的值。 | Yes | N/A |
使用方式
範例
<trace source="PetStore API" severity="verbose">
<message>@((string)context.Variables["clientConnectionID"])</message>
<metadata name="Operation Name" value="New-Order"/>
</trace>
相關原則
相關內容
如需使用原則的詳細資訊,請參閱:
- 教學課程:轉換及保護 API
- 原則參考,取得原則陳述式及其設定的完整清單
- 原則運算式
- 設定或編輯原則
- 重複使用原則設定
- 原則程式碼片段存放庫 (英文)
- 使用 Microsoft Copilot for Azure 撰寫原則