日志记录

跟踪 Expedia Group XAP SDK 的使用情况和错误

使用 Java 进行日志记录

Expedia Group XAP SDK for Java 不强制客户端使用日志框架，而是支持通过 SLF4J 接口进行日志记录。SLF4J 用作各种日志记录框架的抽象，允许客户端在构建项目时插入想要的实现。

如果没有插入日志记录框架，SDK (SLF4J) 默认为无操作，丢弃所有日志请求并显示一条警告消息。

声明项目依赖项

将特定的日志记录框架声明为项目依赖项，以将其插入。根据设计，SLF4J 一次只能使用一个框架，如果发现多个框架，会发出警告消息。

Simple logger

Java util logging

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 端的请求。