ロギング

Expedia Group XAP SDKにおける使用状況とエラーの追跡

Java によるロギング

Expedia GroupのJava用XAP SDKは、クライアントに特定のロギングフレームワークを強制するものではなく、代わりにのSLF4J インターフェースを介したロギングをサポートしています。SLF4J はさまざまなロギングフレームワークの抽象化に対応しているため、プロジェクトを構築する際に必要な実装をクライアントでプラグインできます。

ロギングフレームワークがプラグインされていないと、SDK (SLF4J) はデフォルトでノーオペレーションになり、警告メッセージが 1 つだけ表示されてすべてのログリクエストが破棄されます。

プロジェクトの依存関係の宣言

プロジェクトの依存関係として宣言することで、特定のロギングフレームワークをプラグインできます。設計上、SLF4J では一度に 1 つのフレームワークしか使用できず、複数のフレームワークが見つかった場合は警告メッセージが出力されます。

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側でのリクエストの追跡が可能です。