4.17.3 HTTPアクセスログ

ファイル名

server_access_log.txt

ログファイルの出力先

DAS

[運用資産格納ディレクトリー]\domains\domain1\logs\access

[運用資産格納ディレクトリー]/domains/domain1/logs/access

GlassFish Serverクラスター

[運用資産格納ディレクトリー]\nodes\localhost-domain1\<GlassFish Serverインスタンス名>\logs\access

[運用資産格納ディレクトリー]/nodes/localhost-domain1/<GlassFish Serverインスタンス名>/logs/access

ログファイルの出力先の変更: HTTPアクセスログのログ出力先ディレクトリは、asadminコマンドのsetサブコマンドで、HTTPサービスの定義項目を設定することで変更可能です。変更については、「設定方法」を参照してください。

出力内容

HTTPサービスの通信情報が出力されます。

仕様

HTTPアクセスログを有効に設定すると、HTTPアクセスログファイルが作成されます。設定方法については、「設定方法」を参照してください。
同名のファイルが存在する場合は、追加出力されます。

リクエストラインに出力される値はクライアントから送付された値がそのまま出力されます。
リクエストURLに%エンコードされた文字を含む場合は、デコードされずにクライアントから送付された値がそのまま出力されます。

"192.0.2.237" "-" "userA" "29/Dec/2015:13:36:44 +0900" "GET /web/%E3%83%9E%E3%83%AB%E3%83%81%E3%83%90%E3%82%A4%E3%83%88 HTTP/1.1" "200" "1635" "192.0.2.237:8080" "sCoTMyIolLXQzBKj7DhLZgO0mzem10Zn9rco1I4tbZplLlklzRcm0LGzcOVP0007" "15" "ThreadID=36" "ThreadName=http-listener-1(9)" "192.0.2.237"

同じディレクトリーに出力される__asadmin_access_log.txtは、管理用のアプリケーションに対するHTTPアクセスログです。
書き込み権限がない場合、サーバーログに警告メッセージが出力されます(注)。この場合、HTTPアクセスログは出力されません。
注)
一般ユーザーでGlassFish Serverクラスターを実行する場合の動作です。
一般ユーザーでのGlassFish Serverクラスターの実行については、「2.1.6 運用ユーザーのカスタマイズ」を参照してください。

設定方法

HTTPアクセスログの設定項目は、asadminコマンドのsetサブコマンドで変更可能です。

アクセスログの有効化
HTTPアクセスログの出力を有効にするかを指定します。
形式
HTTPアクセスログに出力する項目を指定します。
ローテーションに関する設定
ローテーションのタイプなど設定します。ローテーションについては、「4.17.6 ログファイルのローテーション」を参照してください。
ログ出力ディレクトリ
ログファイルの出力先を変更できます。

詳細は、「8.8.2 HTTPサービスの定義項目」、「10.1 asadmin」を参照してください。

出力フォーマット

HTTPアクセスログの出力フォーマットはカスタマイズできます。設定方法については、「設定方法」を参照してください。

項目名は“%”で囲んで小文字で指定します。ただし、%cookies.any%のanyに指定する値は、大文字、小文字を区別するのでHTTP/1.1で定義された値を指定してください。
複数の項目を指定する場合は、空白で区切って指定します。
出力形式の初期値：
%client.name% %client.id% %auth-user-name% %datetime% %request% %status% %response.length%
%headers.host% %cookies.JSESSIONID% %time-taken% %thread.id% %thread.name% %webserver.name%
フォーマットに空白のみを指定した場合や登録されていない項目名を指定した場合は、下記の値が設定されます。
%client.name% %auth-user-name% %datetime% %request% %status% %response.length%
項目が複数定義されている場合は、“;”で区切って出力されます。

指定可能な項目は、以下の表を参照してください。

リクエスト情報

項目名	説明	デフォルト
%client.name%	クライアントまたは、プロキシサーバーなどのIPアドレス／ホスト名を出力します。	○
%client.id%	クライアントから返信されるユーザー個人情報を出力します。ただし、常に“-”を出力します。	○
%auth-user-name%	Webサーバーを経由する場合 Webサーバーが認証したユーザー名を出力します。 Webサーバーを経由しない場合 Webコンテナで認証したユーザー名を出力します。リクエストにユーザー名が付与されていない場合は、“－”を出力します。	○
%datetime%	ログを出力した時点の日時を出力します。	○
%request%	リクエストラインの内容を出力します。	○
%status%	ステータスコードを出力します。	○
%response.length%	レスポンスのデータ長を出力します。単位はbyteです。	○
%headers.host%	Hostヘッダーの内容を出力します。	○
%cookies.JSESSIONID%	セッションIDを出力します。	○
%time-taken%	リクエストの処理開始から、Webアプリケーションの処理終了までの時間(ミリ秒)を出力します。以下についても含みます。初回アクセス時のJSPコンパイル、クラスのロード、Servletなどの初期化処理 HTTP/2のServer Pushのリクエストに対する%time-taken%の値は参照しないでください。	○
%thread.id%	スレッドIDを出力します。	○
%thread.name%	スレッド名を出力します。	○
%webserver.name%	Webサーバーを経由する場合 WebサーバーのIPアドレスを出力します。 Webサーバーを経由しない場合クライアントまたは、プロキシサーバーなどのIPアドレスを出力します。	○
%cookies.any%	Cookieヘッダーの内容を出力します。 anyには出力するHTTP/1.1で定義されているCookieの名前を大文字、小文字を区別して指定します。
%headers.any%	リクエストHTTPヘッダーの値を出力します。anyには、HTTP/1.1で定義された任意の有効なリクエストHTTPヘッダーの値を小文字で指定します。
%headers.referer%	Refererヘッダーの内容を出力します。
%headers.user-agent%	User-Agentヘッダーの内容を出力します。
%response.headers.any%	レスポンスHTTPヘッダーの値を出力します。anyには、HTTP/1.1で定義された任意の有効なレスポンスHTTPヘッダーの値を小文字で指定します。
%response.headers.set-cookie%	レスポンス時のSet-Cookieヘッダーの内容を出力します。
%http-method%	HTTPメソッドを出力します。
%http-uri%	URIを出力します。
%http-version%	プロトコルバージョンを出力します。
%query-str%	クエリー文字列を出力します。

出力例

出力フォーマットに指定した値が空白で区切られて出力されます。

"192.0.2.237" "-" "userA" "29/Dec/2015:13:39:28 +0900" "POST /web/ HTTP/1.1" "200" "1635" "192.0.2.237:8080" "ZptWfQkSV6lXgjFiKMRzFLbuModhaqVFe7R-HpPnZ2hGvhibLwCm0LClNjZG0004" "15" "ThreadID=34" "ThreadName=http-listener-1(12)" "192.0.2.237"

注意

HTTPアクセスログの出力を有効にしている場合、性能に影響があります。影響の程度は、アプリケーション、環境/運用、負荷等に依存します。