日誌記錄

追蹤 Expedia Group XAP SDK 的使用情況與錯誤

使用 Java 記錄日誌

Expedia Group 的 Java 版 XAP SDK 並未強制客戶端使用特定的記錄框架，而是透過SLF4J 介面來支援記錄功能。SLF4J 為各種日誌框架提供了抽象空間，讓客戶得以在建立專案時插入所需的執行方式。

若尚未插入日誌記錄框架，SDK (SLF4J) 預設為無操作，並顯示一則警告通知，告知已丟棄所有日誌請求。

宣告專案相依性

透過宣告為專案相依性以插入特定的日誌記錄框架。根據設計，SLF4J 一次只能使用一個框架，若發現多個框架，則會傳送警告通知。

簡單記錄器

Java Util 日誌記錄

Logback

日誌格式

日誌記錄框架可支援自訂日誌格式和配置，並在原始活動記錄中納入時間戳和記錄器名稱等詳細資訊有助於 SDK 的故障排除。此外，日誌訊息標註了前置字元 ExpediaGroupSDK，可以據此篩選出訊息。

13:36:59.287 [DefaultDispatcher-worker-1] INFO  c.e.s.c.c.c.ConfigurationCollector MDC= - ExpediaSDK: Successfully loaded [endpoint] from [runtime configuration]

可追溯性

SDK 會為每次 API 呼叫產生一個唯一的transaction ID，這對於透過追蹤您這邊的請求來排除問題非常有用。交易 ID 會以 DEBUG 級別記錄在日誌中。

除了 SDK-generated transaction ID之外，XAP API 還會生成並返回其專屬的transaction ID，該標籤會同時出現在回應標頭中 (作為TxnId) 以及回應正文中TransactionId。此transaction ID 可用於在 XAP 端追蹤該請求。