共用方式為

追蹤

  • 發行項

適用於：所有 APIM 層

trace 原則會將自訂追蹤新增至測試主控台、Application Insights 遙測和/或資源記錄中。

  • 此原則會在觸發追蹤時，將自訂追蹤新增至測試主控台中的要求追蹤輸出。
  • Application Insights 整合啟用時，若原則中指定的 severity 大於或等於診斷設定中指定的 verbosity 時，原則就會在 Application Insights 中建立追蹤遙測。
  • 資源記錄啟用時，若原則中指定的嚴重性層級高於或等於診斷設定中指定的詳細程度層級，原則就會在記錄項目中新增屬性。
  • 此原則不會受到 Application Insights 取樣的影響。 系統會記錄所有原則呼叫。

重要

  • API 管理 不再支持追蹤或 的訂用帳戶Ocp-Apim-Trace 標頭。
  • 若要改善 API 安全性，您現在可以在個別 API 層級啟用追蹤，方法是使用 API 管理 REST API 取得限時令牌，並將令牌傳遞至網關。 如需詳細資料，請參閱啟用 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>

相關內容

如需使用原則的詳細資訊，請參閱：