B カスタム・アクセス・ログ・ファイル形式の使用

この付録では、で使用するログ形式について説明します。これらの形式オプションを使用して、ログ・ファイルの形式をカスタマイズします。管理コンソールからこれらを入力するか、server.xmlファイル内でaccess-log要素のformatサブ要素を編集することができます。

ログ形式では、$variableおよび$(expression)という構文で変数および式を使用できます。

カスタム・ログ形式を作成する場合、パーセント記号(%)で囲まれた文字列は、サーバー内のパラメータ・ブロックに格納された名前-値ペアの名前部分として認識されます。それ以外の追加テキストはリテラルのテキストとして扱われるため、行にテキストを追加して読みやすくすることができます。パーセント記号ルールの例外は%SYSDATE%コンポーネントであり、これは現在のシステム日付を表します。%SYSDATE%の形式は、時刻形式%d/%b/%Y:%H:%M:%SおよびGMTからのオフセットで表現されます。

ログ・ファイル用に形式パラメータが指定されていない場合は、共通ログ形式が使用されます:

"%Ses->client.ip% - %Req->vars.auth-user% [%SYSDATE%]
\"%Req->reqpb.clf-request%\" %Req->srvhdrs.clf-status%
%Req->srvhdrs.content-length%"

次の表に、ログ・ファイル形式の一般的なコンポーネントを示します。特定のコンポーネントはスペースを含む値に解決される可能性があるため、エスケープ引用符(\")で囲まれています。

---

オプション	コンポーネント
クライアントのホスト名(iponlyがflex-log内で指定されているかDNS名が使用できない場合を除く)またはIPアドレス	%Ses->client.ip%
クライアントのDNS名	%Ses->client.dns%
システム日付	%SYSDATE%
完全なHTTPリクエスト行	\"%Req->reqpb.clf-request%\"
ステータス	%Req->srvhdrs.clf-status%
レスポンス・コンテンツの長さ	%Req->srvhdrs.content-length%
レスポンス・コンテンツ・タイプ	%Req->srvhdrs.content-type%
リファラ・ヘッダー	\"%Req->headers.referer%\"
ユーザー・エージェント・ヘッダー	\"%Req->headers.user-agent%\"
HTTPメソッド	%Req->reqpb.method%
HTTP URI	%Req->reqpb.uri%
HTTP問合せ文字列	%Req->reqpb.query%
HTTPプロトコル・バージョン	%Req->reqpb.protocol%
受入れヘッダー	%Req->headers.accept%
日付ヘッダー	%Req->headers.date%
If-Modified-Sinceヘッダー	%Req->headers.if-modified-since%
認可ヘッダー	%Req->headers.authorization%
任意のヘッダー値	%Req->headers.headername%
許可されているユーザーの名前	%Req->vars.auth-user%
Cookieの値	%Req->headers.cookie.name%
Req->vars内にある任意の変数の値	%Req->vars.varname%
仮想サーバーID	%vsid%
ECID	%Req->vars.ecid%。詳細は、httpの要素を参照してください。
RID	%Req->vars.rid%。詳細は、httpの要素を参照してください。
期間	%duration% サーバーでのリクエストの処理にかかった時間をマイクロ秒単位で記録します。%duration%を使用するには、事前に統計を有効にする必要があります。
システム時間	%Time 1970年1月1日00:00:00 UTCを基準として秒単位で表したシステム時間。
相対時間	%RELATIVETIME% ロギング開始時点を基準として秒単位で表したシステム時間。
メソッド番号	%Req->method_num% NSAPIで使用されるHTTPメソッドを表す番号。
HTTPプロトコル・バージョン	%Req->protv_num% NSAPIで使用されるHTTPプロトコル・バージョンを表す番号。
HTTPリクエスト行	%Req->reqpb.clf-request.method% HTTPリクエスト行のメソッド。
HTTP URI	%Req->reqpb.clf-request.uri% HTTPリクエスト行のURI。
URIパス	%Req->reqpb.clf-request.uri.abs_path% URIの絶対パス・コンポーネント
URI問合せ	%Req->reqpb.clf-request.uri.query% URIの問合せコンポーネント。
user_dn	%Ses->client.user_dn% WebセキュリティのSSLクライアント証明書認証。
HTTPプロトコル	%Req->reqpb.clf-request.protocol% HTTPリクエスト行のプロトコル。
プロトコル名	%Req->reqpb.clf-request.protocol.name% プロトコルの名前。
プロトコル・バージョン	%Req->reqpb.clf-request.protocol.version% プロトコルのバージョン。
オリジン・サーバー	%Req->vars.origin-server% リクエストを処理したオリジン・サーバー。
アクセス・ログのキャッシュの「終了」ステータス	%Req->vars.proxy-cache-finish-status% プロキシ・サーバー内のオリジン・サーバー・レスポンスのキャッシュ・ステータス

---

次の表に、構成可能な追加のログ・ファイル・パラメータを示します。

---

オプション	コンポーネント
暗号名	%Ses->client.cipher%
暗号鍵のサイズ(ビット)	%Ses->client.keysize%
秘密鍵のサイズ(ビット)	%Ses->client.secret-keysize%
証明書発行者のDN	%Ses->client.issuer_dn%
証明書ユーザーのDN	%Ses->client.user_dn%
SSLセッション識別子	%Ses->client.ssl-id%

---