3.3.10 リダイレクタのログ取得の設定

リダイレクタの出力するログは,出力先やログ出力レベルなどを変更できます。リダイレクタが出力するログは,メッセージログと保守用トレースログの二つに分けて出力されます。メッセージログには,障害発生時のログなどのメッセージが出力されます。保守用トレースログには,HTTPリクエストを受信し,レスポンスを送信するまでのトレース情報が出力されます。

保守用トレースログのログサイズは,見積もりの計算式に従い,障害発生時から障害を検知しログを収集するまで保持されるサイズにカスタマイズすることをお勧めします。

ここでは,次に示す実行環境ごとに,リダイレクタのログ取得で設定できる項目について説明します。

<この項の構成>
(1) Smart Composer機能を使用する環境の場合
(2) Webリダイレクタ環境またはSmart Composer機能を使用しない環境の場合
(3) 注意事項

(1) Smart Composer機能を使用する環境の場合

Smart Composer機能(Management Server)を使用する環境では,簡易構築定義ファイルおよびmod_jk.confで,リダイレクタのログ取得の設定を変更できます。説明で使用するファイルの詳細,および各ファイルのキーの詳細については,マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「4. Smart Composer機能で使用するファイル」を参照してください。なお,UNIXの場合,設定を変更できるのは,root権限(Component Container管理者を設定していない場合),またはComponent Container管理者の権限(Component Container管理者を設定している場合)を持つユーザです。

●変更した設定を有効にする方法

変更した設定を有効にする方法について,OSごとに説明します。

Windowsの場合
変更したリダイレクタのログ取得の設定を有効にするには,Hitachi Web Serverを再起動してください。
UNIXの場合
変更したリダイレクタのログ取得の設定を有効にする方法は,ファイルサイズまたはファイル面数の変更の有無によって異なります。
ファイルサイズまたはファイル面数を変更する場合
ファイルサイズまたはファイル面数を変更する場合に,変更したリダイレクタのログ取得の設定を有効にする方法を次に示します。
  1. Hitachi Web Serverを停止します。
  2. ログファイルおよび管理ファイルを移動または削除します。
    メッセージログファイルの場合:メッセージログファイルおよびHNTRLibが使用する管理ファイル(<JkLogFilePrefixの設定値>.mm)を移動,または削除します。
    保守用トレースログファイルの場合:保守用トレースログファイルおよびHNTRLibが使用する管理ファイル(<JkTrcaeLogFilePrefixの設定値>.mm)を移動,または削除します。
  3. Hitachi Web Serverを再起動します。
なお,HNTRLibが使用する管理ファイルのデフォルトの格納場所は次のとおりです。
/opt/Cosminexus/CC/web/redirector/logs/mmap
ファイルサイズまたはファイル面数を変更しない場合
ファイルサイズまたはファイル面数を変更しない場合は,Hitachi Web Serverを再起動してください。
●変更できる設定項目

変更できる設定項目と,項目に対応する各ファイルの設定内容を次の表に示します。

表3-13 リダイレクタのログ取得の設定(簡易構築定義ファイル,mod_jk.conf)

項目設定個所設定内容
メッセージログ,保守用トレースログのログ出力レベル簡易構築定義ファイル論理Webサーバ(web-server)の<configuration>タグ内に,JkLogLevelパラメタで,リダイレクタのログの出力レベルを指定します。
メッセージログ出力先論理Webサーバ(web-server)の<configuration>タグ内に,JkLogFileDirパラメタで,リダイレクタのログ出力先ディレクトリを指定します。
メッセージログファイルサイズ論理Webサーバ(web-server)の<configuration>タグ内に,JkLogFileSizeパラメタで,リダイレクタのログを出力するログファイルの1ファイル当たりのサイズを指定します。
メッセージログファイル面数論理Webサーバ(web-server)の<configuration>タグ内に,JkLogFileNumパラメタで,リダイレクタのログを出力するログファイルの面数を指定します。
メッセージログファイル名のプリフィックスmod_jk.confmod_jk.confで,JkLogFilePrefixキーにリダイレクタのログを出力するログファイル名のプリフィックスを指定します。
保守用トレースログ出力の有無簡易構築定義ファイル論理Webサーバ(web-server)の<configuration>タグ内に,JkTraceLogパラメタで,リダイレクタの保守用トレースログを出力するかどうかを指定します。
保守用トレースログ出力先論理Webサーバ(web-server)の<configuration>タグ内に,JkTraceLogFileDirパラメタで,リダイレクタの保守用トレースログの出力先ディレクトリを指定します。
保守用トレースログファイルサイズ論理Webサーバ(web-server)の<configuration>タグ内に,JkTraceLogFileSizeパラメタで,リダイレクタの保守用トレースログを出力するログファイルの1ファイル当たりのサイズを指定します。
保守用トレースログファイル面数論理Webサーバ(web-server)の<configuration>タグ内に,JkTraceLogFileNumパラメタで,リダイレクタの保守用トレースログを出力するログファイルの面数を指定します。
保守用トレースログファイル名のプリフィックスmod_jk.confmod_jk.confで,JkTrcaeLogFilePrefixキーにリダイレクタの保守用トレースログを出力するログファイル名のプリフィックスを指定します。

注※ 保守用トレースログの出力先とプリフィックスには,同じ値を指定しないでください。同じ値を指定した場合は,リダイレクタが動作しません。


メッセージログ,および保守用トレースログのデフォルトの出力先
  • Windowsの場合
    <Cosminexusのインストールディレクトリ>¥CC¥web¥redirector¥logs
  • UNIXの場合
    /opt/Cosminexus/CC/web/redirector/logs
注※ 新規インストール時には,logsディレクトリは存在しません。logsディレクトリは,Hitachi Web Serverの起動時に生成されます。
ログレベルのレベル名
ログレベルのレベル名には,重要度の高い順に「emerg」,「error」,「info」,「debug」のどれかを指定できます。
  • emerg:通常運用時に指定します。常に出力する必要がある重要度の高いメッセージだけが出力されます。
  • error:通常運用時に指定します。
  • info:テスト時に指定します。
  • debug:障害調査時に指定します。
ログレベルは,単独で指定してください(コンマ区切りで複数のログレベルを指定しないでください)。あるログレベルを指定すると,指定されたログレベルおよびそれよりも重要度の高いログが出力されます。
注※ Windowsの場合に指定できます。
ログサイズの見積もりの計算式
GETリクエスト,POSTリクエストの1HTTPアクセス当たりのログサイズは,次の計算式で見積もってください。
  • GETによる1HTTPアクセス当たりのログサイズ
    = 1.75 +(平均レスポンスボディサイズ / 16)* 0.25
  • POSTによる1HTTPアクセス当たりのログサイズ
    = 2.00 +(平均POSTデータサイズ / 16)* 0.5 +(平均レスポンスボディサイズ / 16)* 0.25
なお,単位はすべてキロバイト,除算結果の小数点以下の値はすべて切り捨てです。また,計算式ではリクエストURLとクエリー文字列の平均サイズは,それぞれ100バイトとしています。リクエストURLとクエリー文字列の平均サイズが100バイトを超えた場合は,計算式の最初の値に,超える分のサイズを加えて計算してください。
●注意事項

リダイレクタのログ取得を設定する場合の注意事項を次に示します。

(2) Webリダイレクタ環境またはSmart Composer機能を使用しない環境の場合

Webリダイレクタ環境,およびSmart Composer機能を使用しない環境では,使用するWebサーバによって,リダイレクタのログ取得の設定が異なります。なお,説明で使用するファイルおよびキーの詳細については,マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(サーバ定義)」を参照してください。

(a) Hitachi Web Serverの場合

Hitachi Web Serverを使用している場合は,mod_jk.confファイルでリダイレクタのログ取得の設定を変更できます。なお,UNIXの場合,設定を変更できるのは,root権限(Component Container管理者を設定していない場合),またはComponent Container管理者の権限(Component Container管理者を設定している場合)を持つユーザです。

●変更した設定を有効にする方法

変更した設定を有効にする方法について,OSごとに説明します。

Windowsの場合
変更したリダイレクタのログ取得の設定を有効にするには,Hitachi Web Serverを再起動してください。
UNIXの場合
変更したリダイレクタのログ取得の設定を有効にする方法は,ファイルサイズまたはファイル面数の変更の有無によって異なります。
ファイルサイズまたはファイル面数を変更する場合
ファイルサイズまたはファイル面数を変更する場合に,変更したリダイレクタのログ取得の設定を有効にする方法を次に示します。
  1. Hitachi Web Serverを停止します。
  2. ログファイルおよび管理ファイルを移動または削除します。
    メッセージログファイルの場合:メッセージログファイルおよびHNTRLibが使用する管理ファイル(<JkLogFilePrefixの設定値>.mm)を移動,または削除します。
    保守用トレースログファイルの場合:保守用トレースログファイルおよびHNTRLibが使用する管理ファイル(<JkTrcaeLogFilePrefixの設定値>.mm)を移動,または削除します。
  3. Hitachi Web Serverを再起動します。
なお,HNTRLibが使用する管理ファイルのデフォルトの格納場所は次のとおりです。
/opt/Cosminexus/CC/web/redirector/logs/mmap
ファイルサイズまたはファイル面数を変更しない場合
ファイルサイズまたはファイル面数を変更しない場合は,Hitachi Web Serverを再起動してください。
●変更できる設定項目

変更できる設定項目と,項目に対応するユーザ定義ファイルとキーを次の表に示します。

表3-14 Hitachi Web Serverでのリダイレクタのログ取得の設定項目

項目mod_jk.confのキー
メッセージログ,保守用トレースログのログ出力レベルJkLogLevel
メッセージログ出力先JkLogFileDir
メッセージログファイルサイズJkLogFileSize
メッセージログファイル面数JkLogFileNum
メッセージログファイル名のプリフィックスJkLogFilePrefix
保守用トレースログ出力の有無JkTraceLog
保守用トレースログ出力先JkTraceLogFileDir
保守用トレースログファイルサイズJkTraceLogFileSize
保守用トレースログファイル面数JkTraceLogFileNum
保守用トレースログファイル名のプリフィックスJkTrcaeLogFilePrefix

注※ 保守用トレースログの出力先とプリフィックスには,同じ値を指定しないでください。同じ値を指定した場合は,リダイレクタが動作しません。


メッセージログ,および保守用トレースログのデフォルトの出力先
  • Windowsの場合
    <Cosminexusのインストールディレクトリ>¥CC¥web¥redirector¥logs
  • UNIXの場合
    /opt/Cosminexus/CC/web/redirector/logs
注※ 新規インストール時には,logsディレクトリは存在しません。logsディレクトリは,Hitachi Web Serverの起動時に生成されます。
ログレベルのレベル名
ログレベルのレベル名には,重要度の高い順に「emerg」,「error」,「info」,「debug」のどれかを指定できます。
  • emerg:通常運用時に指定します。常に出力する必要がある重要度の高いメッセージだけが出力されます。
  • error:通常運用時に指定します。
  • info:テスト時に指定します。
  • debug:障害調査時に指定します。
ログレベルは,単独で指定してください(コンマ区切りで複数のログレベルを指定しないでください)。あるログレベルを指定すると,指定されたログレベルおよびそれよりも重要度の高いログが出力されます。
注※ Windowsの場合に指定できます。
ログサイズの見積もりの計算式
GETリクエスト,POSTリクエストの1HTTPアクセス当たりのログサイズは,次の計算式で見積もってください。
  • GETによる1HTTPアクセス当たりのログサイズ
    = 1.75 +(平均レスポンスボディサイズ / 16)* 0.25
  • POSTによる1HTTPアクセス当たりのログサイズ
    = 2.00 +(平均POSTデータサイズ / 16)* 0.5 +(平均レスポンスボディサイズ / 16)* 0.25
なお,単位はすべてキロバイト,除算結果の小数点以下の値はすべて切り捨てです。また,計算式ではリクエストURLとクエリー文字列の平均サイズは,それぞれ100バイトとしています。リクエストURLとクエリー文字列の平均サイズが100バイトを超えた場合は,計算式の最初の値に,超える分のサイズを加えて計算してください。
(b) Microsoft IISの場合

Microsoft IISを使用している場合は,isapi_redirect.confファイルでリダイレクタのログ取得の設定を変更できます。

注意事項
isapi_redirect.confファイルに設定されたファイルサイズ,およびファイル面数のログファイルは,Webサーバとの連携の設定後の初回リクエスト時に作成されます。ログファイルの作成は,ログファイルサイズおよびファイル面数に比例した処理時間が必要となります。ログファイルサイズを大きく設定した場合,またはファイル面数を増やした場合などは,ログファイルの作成処理に数分掛かる場合があります。
Webサーバとの連携の設定後およびログファイルの設定変更後の初回リクエストは,運用を開始する前に実施しておくことをお勧めします。
●変更した設定を有効にする方法

ファイルサイズまたはファイル面数を変更する場合に,変更したリダイレクタのログ取得の設定を有効にするための手順を次に示します。

  1. Microsoft IISを停止します。
  2. ログファイルおよび管理ファイルを移動または削除します。
    メッセージログファイルの場合:メッセージログファイルおよびHNTRLibが使用する管理ファイル(<log_file_prefixの設定値>.mm)を移動,または削除します。
    保守用トレースログファイルの場合:保守用トレースログファイルおよびHNTRLibが使用する管理ファイル(< trace_log_file_prefixの設定値>.mm)を移動,または削除します。
    なお,HNTRLibが使用する管理ファイルのデフォルトの格納場所は次のとおりです。
    <Cosminexusのインストールディレクトリ>¥CC¥web¥redirector¥logs¥mmap
  3. Microsoft IISを起動します。

ファイルサイズおよびファイル面数を変更しない場合に,変更したリダイレクタのログ取得の設定を有効にするための手順を次に示します。

  1. Microsoft IISを再起動するか,またはワーカプロセスのリサイクルを行います。
    Microsoft IISの「インフォメーション サービス マネージャ」を使用して,ワーカプロセスのリサイクルができます。
●変更できる設定項目

変更できる設定項目と,項目に対応するユーザ定義ファイルとキーを次の表に示します。isapi_redirect.confについては,マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「9.2 isapi_redirect.conf(Microsoft IIS用リダイレクタ動作定義ファイル)」を参照してください。

表3-15 Microsoft IISでのリダイレクタのログ取得の設定項目

項目isapi_redirect.confのキー
メッセージログ,保守用トレースログのログ出力レベルlog_level
メッセージログ出力先log_file_dir
メッセージログファイルサイズlog_file_size
メッセージログファイル面数log_file_num
メッセージログファイル名のプリフィックスlog_file_prefix
保守用トレースログ出力の有無trace_log
保守用トレースログ出力先trace_log_file_dir
保守用トレースログファイルサイズtrace_log_file_size
保守用トレースログファイル面数trace_log_file_num
保守用トレースログファイル名のプリフィックスtrace_log_file_prefix

注※ 保守用トレースログの出力先とプリフィックスには,同じ値を指定しないでください。同じ値を指定した場合は,リダイレクタが動作しません。


メッセージログ,および保守用トレースログのデフォルトの出力先
<Cosminexusのインストールディレクトリ>¥CC¥web¥redirector¥logs
注※ 新規インストール時には,logsディレクトリは存在しません。logsディレクトリは,初回リクエスト時に生成されます。
ログレベルのレベル名
ログレベルのレベル名には,重要度の高い順に「emerg」,「error」,「info」,「debug」のどれかを指定できます。
  • emerg:通常運用時に指定します。常に出力する必要がある重要度の高いメッセージだけが出力されます。
  • error:通常運用時に指定します。
  • info:テスト時に指定します。
  • debug:障害調査時に指定します。
ログレベルは,単独で指定してください(コンマ区切りで複数のログレベルを指定しないでください)。あるログレベルを指定すると,指定されたログレベルおよびそれよりも重要度の高いログが出力されます。
ログサイズの見積もりの計算式
GETリクエスト,POSTリクエストの1HTTPアクセス当たりのログサイズは,次の計算式で見積もってください。
  • GETによる1HTTPアクセス当たりのログサイズ
    = 2.25 +(平均レスポンスボディサイズ / 16)* 0.25
  • POSTによる1HTTPアクセス当たりのログサイズ
    = 2.50 +(平均POSTデータサイズ / 16)* 0.5 +(平均レスポンスボディサイズ / 16)* 0.25
なお,単位はすべてキロバイト,除算結果の小数点以下の値はすべて切り捨てです。また,計算式ではリクエストURLとクエリー文字列の平均サイズは,それぞれ100バイトとしています。リクエストURLとクエリー文字列の平均サイズが100バイトを超えた場合は,計算式の最初の値に,超える分のサイズを加えて計算してください。

(3) 注意事項

リダイレクタのログ取得を設定する場合の注意事項を次に示します。