15.2. アクセスログ

アクセスログは、Hot Rod および REST エンドポイントのすべてのインバウンドクライアント要求を $RHDG_HOME/server/log ディレクトリー内のファイルを記録します。

org.infinispan.HOTROD_ACCESS_LOG: Hot Rod アクセスメッセージを hotrod-access.log ファイルに書き込むロギングカテゴリー。
org.infinispan.REST_ACCESS_LOG: REST アクセスメッセージを rest-access.log ファイルに書き込むロギングカテゴリー。

Hot Rod および REST エンドポイントアクセスメッセージを記録するには、log4j2.xml でロギングカテゴリーを有効にする必要があります。

手順

任意のテキストエディターで $RHDG_HOME/server/conf/log4j2.xml を開きます。
org.infinispan.HOTROD_ACCESS_LOG および org.infinispan.REST_ACCESS_LOG のロギングカテゴリーのレベルを TRACE に変更します。
log4j2.xml を保存し、閉じます。

<Logger name="org.infinispan.HOTROD_ACCESS_LOG" additivity="false" level="TRACE">
   <AppenderRef ref="HR-ACCESS-FILE"/>
</Logger>

アクセスログのデフォルト形式は以下のとおりです。

%X{address} %X{user} [%d{dd/MMM/yyyy:HH:mm:ss Z}] &quot;%X{method} %m
%X{protocol}&quot; %X{status} %X{requestSize} %X{responseSize} %X{duration}%n

前述のフォーマットは、以下のようなログエントリーを作成します。

127.0.0.1 - [DD/MM/YYYY:HH:MM:SS +0000] "PUT /rest/v2/caches/default/key HTTP/1.1" 404 5 77 10

ロギングプロパティーは %X{name} 表記を使用し、アクセスログの形式を変更可能にします。以下は、デフォルトのロギングプロパティーです。

プロパティー	説明
`address`	`X-Forwarded-For` ヘッダーまたはクライアント IP アドレスのいずれか。
`user`	認証を使用する場合のプリンシパル名。
`メソッド`	使用されるメソッド。`PUT`、`GET` など。
`protocol`	使用されるプロトコル`HTTP/1.1`、`HTTP/2`、`HOTROD/2.9` など。
`status`	REST エンドポイントの HTTP ステータスコード。`OK` または Hot Rod エンドポイントの例外。
`requestSize`	リクエストのサイズ (バイト単位)。
`responseSize`	応答のサイズ (バイト単位)。
`duration`	サーバーによる要求の処理にかかった時間 (ミリ秒数)。

ヒント

h: で始まるヘッダー名を使用して、リクエストに含まれるヘッダーをログに記録します (例: %X{h:User-Agent})。