Cosminexus システム構築ガイド

[目次][用語][索引][前へ][次へ]

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

この節では,リダイレクタのログ取得で設定できる項目について説明します。

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

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

注意事項
  • ログファイル初期化処理の開始時および終了時には,メッセージログにそれぞれKDJE41029-I,KDJE41030-Iのメッセージが出力されます。Webサーバの起動時には,ログファイル初期化処理が正常に終了したことを確認するため,メッセージログにKDJE41029-I,KDJE41030-Iのメッセージが出力されていることを確認してください。
  • UNIXの場合,簡易構築定義ファイルに設定されたファイルサイズ,およびファイル面数のログファイルは,Webサーバとの連携の設定後の初回起動時に作成されます。ログファイルの作成は,ログファイルサイズおよびファイル面数に比例した処理時間が必要となります。ログファイルサイズを大きく設定した場合,またはファイル面数を増やした場合などは,ログファイルの作成処理に数分掛かる場合があります。
<この節の構成>
(1) ログ取得の設定の変更

(1) ログ取得の設定の変更

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

(a) 変更した設定を有効にする方法

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

Windowsの場合
変更したリダイレクタのログ取得の設定を有効にするには,Hitachi Web Serverを再起動してください。

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

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

表5-10 リダイレクタのログ取得の設定(簡易構築定義ファイル,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.conf mod_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.conf mod_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バイトを超えた場合は,計算式の最初の値に,超える分のサイズを加えて計算してください。