モジュールトレースのトレース対象を次に示します。

表4-3　モジュールトレースのトレース対象

HWSRequestLogディレクティブを指定していない場合は，ErrorLogディレクティブに指定したファイルに対して，LogLevelディレクティブの指定に従って採取します。

HWSRequestLogディレクティブを指定している場合は，HWSRequestLogディレクティブに指定したファイルに対して，HWSRequestLogTypeディレクティブの指定に従って採取します。

注意事項

ErrorLogディレクティブに指定したファイルに対してログを採取する場合は，バーチャルホスト単位にファイルを分けることができます。HWSRequestLogディレクティブに指定したファイルに対してログを採取する場合は，バーチャルホスト単位にファイルを分けることができません。

LogLevelディレクティブ又はHWSRequestLogTypeディレクティブの指定によって，採取するモジュールトレースのレベルを変更できます。各レベルで採取するトレースの内容を次に示します。

(a)　infoレベル

障害発生の原因となるおそれのある外部モジュール及びCGIプログラムについて採取します。

LogLevelディレクティブにinfoを指定，又はHWSRequestLogTypeディレクティブにmodule-infoを指定した場合に採取します。

(b)　debugレベル

infoレベルのほかに，リクエストごとに動作する内部モジュールについてのトレースも採取します。

LogLevelディレクティブにdebugを指定，又はHWSRequestLogTypeディレクティブにmodule-debugを指定した場合に採取します。

モジュールトレースの出力項目は次のとおりです。

なお，以降の記述で「サーバプロセスID」はWindows版の場合「サーバスレッドID」です。

(a)　モジュール

• infoレベルで出力される場合
  

  コール時

  [時刻]△[info]△hws△:△module△-->△(モジュールファイル名称[関数オフセット])(サーバプロセスID)

  リターン時

  [時刻]△[info]△hws△:△module△<--△(モジュールファイル名称[関数オフセット])(サーバプロセスID)(結果コード)

（凡例）

△：空白

関数オフセットと関数の対応を次に示します。

表4-4　関数オフセットと関数の対応

（出力例）

[Fri Jul 15 17:29:43 2005] [info] hws : module --> (mod_example.c[1])(1864) [Fri Jul 15 17:29:43 2005] [info] hws : module <-- (mod_example.c[1])(1864)(-1)

• debugレベルで出力される場合
  

  コール時

  [時刻]△[debug]△ファイル名称(行番号):△hws△:△module△-->△(モジュールファイル名称[関数オフセット])(サーバプロセスID)

  リターン時

  [時刻]△[debug]△ファイル名称(行番号):△hws△:△module△<--△(モジュールファイル名称[関数オフセット])(サーバプロセスID)(結果コード)

（凡例）

△：空白

（出力例）

[Fri Jul 15 17:29:43 2005] [debug] request.c(69): hws : module --> (mod_alias.c[3])(1864) [Fri Jul 15 17:29:43 2005] [debug] request.c(69): hws : module <-- (mod_alias.c[3])(1864)(-1)

(b)　CGIプログラム

• infoレベルで出力

コール時

[時刻]△[info]△hws△:△cgi△-->△(exec=cgiファイル名称)(argv0=実行プログラム名称)(args=引数 ※)(サーバプロセスID)(CGIプロセスID)

注※　argsによる引数は，GET /cgi-bin/isindex?aaa+bbb+ccc HTTP/1.0のように，=ではなく，+で連結されたクエリーが指定された場合にだけ表示します。

リターン時

[時刻]△[info]△hws△:△cgi△<--△(exec=cgiファイル名称)(argv0=実行プログラム名称)(サーバプロセスID)(CGIプロセスID)

（凡例）

△：空白

（出力例）

[Fri Jul 15 19:48:08 2005] [info] hws : cgi --> (exec=C:/Program Files/Hitachi/httpsd/cgi-bin/isindex)(argv0=isindex)(args=aaa+bbb+ccc)(1784)(1144) [Fri Jul 15 19:48:08 2005] [info] hws : cgi <-- (exec=C:/Program Files/Hitachi/httpsd/cgi-bin/isindex)(argv0=isindex)(1784)(1144)

(a)　使用例

リクエストログに，infoレベルのモジュールトレース，及びリクエストトレースを出力する例を示します。

 
HWSRequestLogType module-info request
HWSRequestLog logs/hwsrequest.log
 

(b)　異常時のトレース例

• 外部モジュールで異常が発生した場合
  

  [Fri Jul 15 10:29:29 2005] [info] hws : module --> (mod_example.c[1])(1800) [Fri Jul 15 10:29:30 2005] [notice] Parent: child process exited with status 3221225477 -- Restarting.

  mod_example.c[1]，つまり，post_read_requestに該当する関数内で異常が発生しました。
  mod_example.c[1]に該当する関数を調査してください。
  
• CGIプログラムからレスポンスがない場合
  

  [Fri Jul 15 19:48:39 2005] [info] hws : cgi --> (exec=C:/Program Files/Hitachi/httpsd/cgi-bin/test-sleep)(argv0=test-sleep)(1800)(2276) [Fri Jul 15 19:48:49 2005] [info] [client 192.168.1.1] Premature end of script headers: test-sleep [Fri Jul 15 19:48:49 2005] [info] hws : cgi <-- (exec=C:/Program Files/Hitachi/httpsd/cgi-bin/test-sleep)(argv0=test-sleep)(1800)(2276)

  CGIプログラム　test-sleepの処理でタイムアウトが発生しているので，この関数を調査してください。