4.17.4 IIOPアクセスログ

ファイル名

iiop_access.log

ログファイルの出力先

DAS

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

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

GlassFish Serverクラスター

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

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

ログファイルの出力先の変更: IIOPアクセスログのログ出力先ディレクトリは変更可能です。変更方法については、「設定方法」を参照してください。

出力内容

IIOP通信の通信内容が出力されます。

仕様

IIOPアクセスログは、ACCESS/TRACE/NONEの3つの出力モードを選択できます。以下のように、選択したモードによってログの出力内容を切り替えることが可能です。デフォルトでは、ACCESSモードで出力します。出力モードの設定方法については、「設定方法」を参照してください。

ACCESSモード

クライアントでは、サーバーへのリクエスト送信をタイムスタンプ付きで出力します。サーバーでは、クライアントへのレスポンス送信をタイムスタンプ付きで出力します。

クライアントおよびサーバー側で、1回の通信につき1ラインのログを出力します。

TRACEモード

以下の情報をログに出力します。

コネクションの確立／切断
リクエストの送信／受信
レスポンスの送信／受信
フラグメントの送信／受信
リクエストおよびレスポンス以外のメッセージの送信／受信
サーバーアプリケーションの開始／終了

NONEモード: IIOP通信の内容をアクセスログに出力しません。

IIOPアクセスログは、IIOP通信の情報を以下の図で示す事象に分類し、事象発生時にタイムスタンプ付きでログを出力します。

図中の[2]送信、[3]受信、[6]送信、および[7]受信では、以下に関する情報をアクセスログに出力します。

リクエストメッセージ(Request)
レスポンスメッセージ(Reply)
フラグメントされたメッセージ(Fragment)の送受信
リクエストメッセージ／レスポンスメッセージ以外のメッセージの送受信(Other)

以下に、送信(OUT)および受信(IN)で出力されるメッセージ種別と、ACCESSおよびTRACEモードとの出力関係を示します。

通番	送受信(OUT/IN)	メッセージ種別	ACCESSモード	TRACEモード
[2]	OUT	Request	○	○
		Fragment	×	○
		Other	×	○
[3]	IN	Request	×	○
		Fragment	×	○
		Other	×	○
[6]	OUT	Reply	○	○
		Fragment	×	○
		Other	×	○
[7]	IN	Reply	×	○
		Fragment	×	○
		Other	×	○

リクエストメッセージ／レスポンスメッセージ以外のメッセージの送受信(Other)については、CORBA規約で定められているGIOPメッセージタイプのうち、以下のどれかのメッセージタイプに相当します。

メッセージ	メッセージタイプ	意味
Other	CancelRequest	リクエストを取り消します。
	LocateRequest	リクエストに関する問合せを実施します。
	LocateReply	LocateRequestに対する応答です。
	CloseConnection	コネクションの切断を要求します。
	MessageError	送信または受信に問題があることを通知します。

図中の[1]connect、[9]connect_close、および[10]close_resp_infoは、コネクション接続に関する情報をアクセスログに出力します。

[4]app_beginおよび[5]app_endは、アプリケーション呼出しに関する情報をアクセスログに出力します。

[8]reply_statusは、サーバーから受信したメッセージのステータスに関する情報をアクセスログに出力します。

以下に、出力される情報と、ACCESSおよびTRACEモードとの関係を示します。

通番	事象名	意味	ACCESSモード	TRACEモード
[1]	connect	サーバーに対してコネクションを確立します。	×	○
[4]	app_begin	アプリケーション呼出しを開始します。	×	○
[5]	app_end	アプリケーション呼出しを終了します。	×	○
[8]	reply_status	サーバーから受信したメッセージのステータスです。	×	○
[9]	connect_close	コネクションを切断します。	×	○
[10]	close_resp_info	コネクションの切断、閉塞により、レスポンスを破棄します。	×	○

IIOPアクセスログファイルは、ORBの初期化の際に作成されます。同名ファイルがすでに存在する場合は、その同名ファイルにアクセスログが追加出力されます。
読取り権限または書込み権限がない時など、IIOPアクセスログの出力処理中にエラーが発生した場合、サーバーログにエラーメッセージが出力されます。エラーが発生した後は、IIOPアクセスログが出力されなくなります。

注意

GlassFish Serverクラスタープロセス内の呼出しの場合は、GlassFish Serverクラスターに配備したEJBアプリケーションをローカルに呼び出す場合のように、IIOP通信が使用されないため、アクセスログは出力されません。
クライアントマシン上では、Jakarta EEアプリケーションクライアントのIIOP通信情報はアクセスログに出力されません。

設定方法

IIOPサービスの定義項目のプロパティで、以下の項目が設定できます。IIOPサービスの定義項目については、「8.8.4 IIOPサービスの定義項目」を参照してください。

出力モード
ORBの追加プロパティに、IIOPアクセスログの出力モードを設定します。
出力モードの設定方法については、「出力モードの設定」を参照してください。
ローテーションに関する設定
IIOPアクセスログのログサイズおよび世代数に、ローテーションの条件や世代数を設定します。
ローテーションの詳細については、「■IIOPアクセスログの場合」を参照してください。
ログ出力ディレクトリ
IIOPアクセスログのログ出力ディレクトリに、ログファイルの出力先を設定します。

出力モードの設定

IIOPサービスのORB定義の追加プロパティに、以下を設定します。

プロパティ名	説明	プロパティ値	省略値
LogIiopAccessMode	IIOPアクセスログの出力モードを設定します。	ACCESSモード access TRACEモード trace NONEモード none	access

例

asadminコマンドを使用して追加プロパティに出力モードを設定する場合、以下のように設定します。

C:\Interstage\glassfish5\glassfish\bin\asadmin set Cluster001.iiop-service.orb.property.LogIiopAccessMode=trace

/opt/FJSViaps/glassfish5/glassfish/bin/asadmin set Cluster001.iiop-service.orb.property.LogIiopAccessMode=trace

注意

プロパティを設定しない場合、省略値で動作します。
プロパティの設定値を変更した場合は、変更対象のGlassFish ServerクラスターまたはDASを再起動し、サーバーログにエラーメッセージが出力されていないことを確認してください。

出力フォーマット

"[<日付> <時刻>]" "<スレッドID(スレッド名)>" "<メッセージ>"

<日付>

日(2桁10進数)/月(3文字英字)/年(4桁10進数)

<時刻>

時間(2桁10進数):分(2桁10進数):秒(2桁10進数).ミリ秒(3桁10進数) (GMTとの時差)

<スレッドID(スレッド名)>

ID(10進数)(名(英数字))

<メッセージ>

IIOP通信に関する情報を表示します。以下に示すメッセージフォーマットで出力します。

メッセージ送信／受信の場合

<送受信>(<役割>) <メッセージ種別> <補足情報>

<送受信>

IN：受信による通信を表します。

OUT：送信による通信を表します。

<役割>

CL：クライアント機能として動作していることを表します。

SV：サーバー機能として動作していることを表します。

<メッセージ種別>: 以下のどれかが出力されます。

Request
Reply
Fragment
Other

<補足情報>: メッセージ種別ごとの補足情報です。詳細は「メッセージ種別ごとの補足情報」を参照してください。

メッセージ送信／受信以外の場合

<事象名> <補足情報>

<事象名>: 以下が出力されます。

connect
connect_close
close_resp_info
app_begin
app_end
reply_status

<補足情報>: 事象名ごとの補足情報です。詳細は「事象名ごとの補足情報」を参照してください。

メッセージ種別ごとの補足情報

Request

メッセージフォーマットの<送受信>がINの場合

(request_id=<リクエストID>, client=<クライアント情報>, server=<サーバー情報>, more=<フラグメント情報>)

メッセージフォーマットの<送受信>がOUTの場合

(request_id=<リクエストID>, client=<クライアント情報>, server=<サーバー情報>, more=<フラグメント情報>, intf_id=<インターフェイスリポジトリーID>, operation=<メソッド名>, oneway=<oneway呼出し>)

リクエストID

Requestメッセージ送信時のリクエストIDです。

リクエストIDが表示できない場合は、「-」を表示します。

クライアント情報: Requestメッセージ要求元のIPアドレスおよびポート番号です。

サーバー情報: Requestメッセージ要求先のIPアドレスおよびポート番号です。

フラグメント情報

false：Requestメッセージが分割されていないことを表します。

true：Requestメッセージが分割され、後続のFragmentメッセージが存在することを表します。

インターフェイスリポジトリーID

アプリケーションを識別する情報です。

CORBA規約で定められているインターフェイスリポジトリーIDに相当します。

メソッド名: クライアントアプリケーションが呼び出したサーバーアプリケーションのメソッド名です。

oneway呼出し

Requestがサーバーからの応答を期待しないonewayメソッドかを表します。

true：onewayメソッドであることを表します。

false：onewayメソッドでないことを表します。

Reply

メッセージフォーマットの<送受信>がINの場合

(request_id=<リクエストID>, client=<クライアント情報>, server=<サーバー情報>, more=<フラグメント情報>)

メッセージフォーマットの<送受信>がOUTの場合

<リプライステータス> <経過時間> (request_id=<リクエストID>, client=<クライアント情報>, server=<サーバー情報>, more=<フラグメント情報>, intf_id=<インターフェイスリポジトリーID>, operation=<メソッド名>, [excep_id=<例外のリポジトリーID>], [minor=<SYSTEM例外のマイナーコード>])

リプライステータス

以下のいずれかが表示されます。

リプライステータス	意味
NO_EXCEPTION	正常復帰します。
USER_EXCEPTION	ユーザー例外が発生しました。
SYSTEM_EXCEPTION	システム例外が発生しました。
LOCATION_FORWARD	適切な要求先の情報を返却します。
LOCATION_FORWARD_PERM	好ましい要求先の情報を返却します。
NEEDS_ADDRESSING_MODE	要求方法の変更を通知します。

経過時間: サーバーが要求を受信した後、実際に要求処理を開始してからクライアントに応答を返すまでの経過時間を表示します。サーバーからクライアントに返すメッセージが、複数のフラグメントに分割される場合は、分割した最初のメッセージを返すまでの経過時間を表示します。単位はミリ秒です。

リクエストID

Replyメッセージに対応するRequestメッセージのリクエストIDです。

リクエストIDが表示できない場合は、「-」を表示します。

クライアント情報: Replyメッセージ応答先のIPアドレスおよびポート番号です。

サーバー情報: Replyメッセージ応答元のIPアドレスおよびポート番号です。

フラグメント情報

false：Replyメッセージが分割されていないことを表示します。

true：Replyメッセージが分割され、後続のFragmentメッセージが存在することを表します。

インターフェイスリポジトリーID

アプリケーションを識別する情報です。

CORBA規約で定められているインターフェイスリポジトリーIDに相当します。

インターフェイスリポジトリーIDが表示できない場合は、「-」を表示します。

メソッド名: クライアントアプリケーションが呼び出したサーバーアプリケーションのメソッド名です。

例外のリポジトリーID: リプライステータスがUSER_EXCEPTIONまたはSYSTEM_EXCEPTIONの場合に、例外のリポジトリーIDを表示します。リプライステータスがそれ以外の場合は表示されません。

SYSTEM例外のマイナーコード: リプライステータスがSYSTEM_EXCEPTIONの場合に、例外のマイナーコードを10進数で表示します。リプライステータスがそれ以外の場合は表示されません。

Fragment

(request_id=<リクエストID>, client=<クライアント情報>, server=<サーバー情報>, more=<フラグメント情報>)

リクエストID: Fragmentメッセージ要求時のリクエストIDです。

クライアント情報: Fragmentメッセージの要求元または応答先の、IPアドレスおよびポート番号です。

サーバー情報: Fragmentメッセージの要求先または応答元の、IPアドレスおよびポート番号です。

フラグメント情報

false：後続のFragmentメッセージが存在しないことを表します。

true：後続のFragmentメッセージが存在することを表します。

Other

<メッセージタイプ> ([reply_status=<リプライステータス>], [request_id=<リクエストID>], client=<クライアント情報>, server=<サーバー情報>, [more=<フラグメント情報>],  [excep_id=<例外のリポジトリーID>], [minor=<SYSTEM例外のマイナーコード>])

メッセージタイプ: 以下のいずれかが表示されます。

CancelRequest
LocateRequest
LocateReply
CloseConnection
MessageError

リプライステータス(注)

メッセージ種別がLocateReplyの場合にだけ、以下の情報が出力されます。

リプライステータス	意味
UNKNOWN_OBJECT	不正な要求です。
OBJECT_HERE	適切な要求です。
OBJECT_FORWARD	適切な要求先の情報を返却します。
OBJECT_FORWARD_PERM	好ましい要求先の情報を返却します。
LOC_SYSTEM_EXCEPTION	システム例外が発生しました。
LOC_NEEDS_ADDRESSING_MODE	要求方法の変更を通知します。

リクエストID(注)

メッセージ要求時のリクエストIDです。

リクエストIDが表示できない場合は、「-」を表示します。

クライアント情報: メッセージの要求元または応答先の、IPアドレスおよびポート番号です。

サーバー情報: メッセージの要求先または応答元の、IPアドレスおよびポート番号です。

フラグメント情報(注)

false：後続のFragmentメッセージが存在しないことを表します。

true：後続のFragmentメッセージが存在することを表します。

例外のリポジトリーID(注): メッセージタイプがLocateReplyで、リプライステータスがLOC_SYSTEM_EXCEPTIONの場合にだけ、例外のリポジトリーIDを表示します。

SYSTEM例外のマイナーコード(注): メッセージタイプがLocateReplyで、リプライステータスがLOC_SYSTEM_EXCEPTIONの場合にだけ、例外のマイナーコードを10進数で表示します。

注) 表示する情報がない場合は、アクセスログに出力されません。

事象名ごとの補足情報

connect

(client=<クライアント情報>, server=<サーバー情報>)

クライアント情報: コネクション接続元のIPアドレスおよびポート番号です。

サーバー情報: コネクション接続先のIPアドレスおよびポート番号です。

connect_close

(client=<クライアント情報>, server=<サーバー情報>)

クライアント情報: コネクション接続元のIPアドレスおよびポート番号です。

サーバー情報: コネクション接続先のIPアドレスおよびポート番号です。

close_resp_info

(request_id=<リクエストID>, client=<クライアント情報>, server=<サーバー情報>, [intf_id=<インターフェイスリポジトリーID>], [operation=<メソッド名>])

リクエストID: 破棄されたメッセージのリクエストIDです。

クライアント情報: コネクション接続元のIPアドレスおよびポート番号です。

サーバー情報: コネクション接続先のIPアドレスおよびポート番号です。

インターフェイスリポジトリーID(注)

アプリケーションを識別する情報です。

CORBA規約で定められているインターフェイスリポジトリーIDに相当します。

メソッド名(注): クライアントアプリケーションが呼び出したサーバーアプリケーションのメソッド名です。

注) 表示する情報がない場合は、アクセスログに出力されません。

app_begin

(request_id=<リクエストID>, client=<クライアント情報>, server=<サーバー情報>, intf_id=<インターフェイスリポジトリーID>, operation=<メソッド名>)

リクエストID: RequestメッセージのリクエストIDです。

クライアント情報: コネクション接続元のIPアドレスおよびポート番号です。

サーバー情報: コネクション接続先のIPアドレスおよびポート番号です。

インターフェイスリポジトリーID

アプリケーションを識別する情報です。

CORBA規約で定められているインターフェイスリポジトリーIDに相当します。

メソッド名: クライアントアプリケーションが呼び出したサーバーアプリケーションのメソッド名です。

app_end

<経過時間> (request_id=<リクエストID>, client=<クライアント情報>, server=<サーバー情報>, intf_id=<インターフェイスリポジトリーID>, operation=<メソッド名>)

経過時間: アプリケーションの処理時間です。単位はミリ秒です。

リクエストID: RequestメッセージのリクエストIDです。

クライアント情報: コネクション接続元のIPアドレスおよびポート番号です。

サーバー情報: コネクション接続先のIPアドレスおよびポート番号です。

インターフェイスリポジトリーID

アプリケーションを識別する情報です。

CORBA規約で定められているインターフェイスリポジトリーIDに相当します。

メソッド名: クライアントアプリケーションが呼び出したサーバーアプリケーションのメソッド名です。

reply_status

<メッセージ種別> <リプライステータス> (request_id=<リクエストID>, client=<クライアント情報>, server=<サーバー情報>, [operation=<メソッド名>], [excep_id=<例外のリポジトリーID>], [minor=<SYSTEM例外のマイナーコード>])

メッセージ種別: ReplyまたはLocateReplyが表示されます。

リプライステータス

メッセージ種別に従い、以下のステータスが表示されます。

メッセージ種別	ステータス
Reply	NO_EXCEPTION
	USER_EXCEPTION
	SYSTEM_EXCEPTION
	LOCATION_FORWARD
	LOCATION_FORWARD_PERM
	NEEDS_ADDRESSING_MODE
LocateReply	UNKNOWN_OBJECT
	OBJECT_HERE
	OBJECT_FORWARD
	OBJECT_FORWARD_PERM
	LOC_SYSTEM_EXCEPTION
	LOC_NEEDS_ADDRESSING_MODE

リクエストID: RequestまたはLocateRequestメッセージのリクエストIDです。

クライアント情報: メッセージ送信先のIPアドレスおよびポート番号です。

サーバー情報: メッセージ送信元のIPアドレスおよびポート番号です。

メソッド名(注): クライアントアプリケーションが呼び出したサーバーアプリケーションのメソッド名です。

例外のリポジトリーID(注): リプライステータスがUSER_EXCEPTION、SYSTEM_EXCEPTIONまたはLOC_SYSTEM_EXCEPTIONの場合に、例外のリポジトリーIDを表示します。リプライステータスがそれ以外の場合には表示されません。

SYSTEM例外のマイナーコード(注): リプライステータスがSYSTEM_EXCEPTIONまたはLOC_SYSTEM_EXCEPTIONの場合に、例外のマイナーコードを10進数で表示します。リプライステータスがそれ以外の場合には表示されません。

注) 表示する情報がない場合は、アクセスログに出力されません。

出力例

クライアントがRequestメッセージを要求した場合

"[06/Nov/2015 18:12:25.255 +0900]" "71(p: thread-pool-1; w: 5)" "OUT(CL) Request (request_id=8, client=127.0.0.1:46086, server=127.0.0.1.144:30700, more=false, intf_id=RMI:test._LogModeEJBRemote_Remote:0000000000000000, operation=func, oneway=false)"

サーバーがReplyメッセージを応答した場合

"[06/Nov/2015 18:12:25.323 +0900]" "43(p: ejbAppTarget; w: 4)" "OUT(SV) Reply NO_EXCEPTION 46 (request_id=8, client=127.0.0.1:46086, server=127.0.0.1:30700, more=false, intf_id=RMI:test._LogModeEJBRemote_Remote:0000000000000000, operation=func)"