診斷記錄設定參考:API 管理
適用於:所有 API 管理 層
本參考說明從 API 管理 實例進行 API 診斷記錄的設定。 若要啟用 API 要求的記錄,請參閱下列指引:
注意
某些設定,其中已指出,僅適用於對 Application Insights 的記錄。
設定 | 類型 | 描述 |
---|---|---|
啟用 | boolean | 指定是否啟用此 API 的記錄。 您可以針對所有 API 或個別 API 啟用記錄。 如果已啟用,則為所有 API 的個別 API 覆寫設定 設定。 |
Destination | Azure 應用程式 Insights 記錄器 | 指定要用於 Application Insights 記錄的記錄器。 |
取樣 ≤ | decimal | 從 0 到 100 的值(百分比)。 指定記錄的要求百分比。 0% 取樣表示記錄零個要求,而 100% 取樣表示記錄的所有要求。 預設值:100 如需 Application Insights 記錄的效能影響,請參閱 效能影響和記錄取樣。 |
一律記錄錯誤 | boolean | 如果啟用此設定,則不論取樣設定為何,都會記錄所有失敗。 |
記錄用戶端IP位址 | boolean | 如果啟用此設定,則會記錄 API 要求的用戶端 IP 位址。 |
詳細資訊 | 指定記錄檔的詳細資訊,以及是否記錄在追蹤原則中設定的自定義追蹤。 * 錯誤 - 失敗的要求和嚴重性自定義追蹤 error * 資訊 - 失敗和成功的要求,以及嚴重性和 error 自定義追蹤 information * 詳細資訊 - 失敗和成功的要求,以及嚴重性 error 、 information 和 的自定義追蹤 verbose 預設資訊: |
|
相互關聯通訊協定 | 指定用來將多個元件所傳送的遙測相互關聯至 Application Insights 的通訊協定。 默認值:舊版 如需詳細資訊,請參閱 Application Insights 中的遙測相互關聯。 |
|
要記錄的標頭 | 清單 | 指定針對要求和回應記錄的標頭。 預設值:不會記錄任何標頭。 |
要記錄的承載位元組數目 | 整數 | 指定針對要求和回應所記錄主體的初始位元元組數目。 最大值:8,192。 預設值:0 |
前端要求 | 指定前端要求(傳入 API 管理 閘道的要求)的記錄方式和方式。 如果啟用此設定,請指定要記錄的標頭、要記錄的承載位元元組數目,或兩者。 |
|
前端回應 | 指定前端回應(從 API 管理 閘道傳出回應)的記錄和方式。 如果啟用此設定,請指定要記錄的標頭、要記錄的承載位元元組數目,或兩者。 |
|
後端要求 | 指定是否已記錄後端要求(從 API 管理 閘道傳出的要求) 和方式。 如果啟用此設定,請指定要記錄的標頭、要記錄的承載位元元組數目,或兩者。 |
|
後端回應 | 指定後端回應(傳入 API 管理 閘道的回應)的記錄方式和方式。 如果啟用此設定,請指定要記錄的標頭、要記錄的承載位元元組數目,或兩者。 |