7.3.1 ログファイルとトレースファイルの出力方式と注意事項
障害情報のうちログファイルやトレースファイルは,ローテーション方式やファイル切り替え方式に基づいて出力されます。サービスプラットフォームが出力するログやトレースでは,利用できる方式は次のように異なります。
ログの種類 |
ローテーション方式 |
出力先ファイルの切り替え方式 |
|||
---|---|---|---|---|---|
ラップアラウンドモード |
シフトモード |
ファイルサイズで切り替え |
ファイルサイズまたは時刻で切り替え |
||
メッセージログ |
HCSC-Managerのログ |
◎ |
× |
◎ |
× |
統合メッセージログ |
◎ |
○ |
◎ |
○ |
|
J2EEサーバの稼働ログ |
◎ |
○ |
◎ |
○ |
|
リクエストトレース |
◎ |
○ |
◎ |
○ |
|
性能解析トレース |
− |
− |
− |
− |
|
ユーザ電文トレース |
◎ |
○ |
◎ |
○ |
|
保守用ログ(例外ログなど) |
◎ |
○ |
◎ |
○ |
|
ユーザ認証情報管理コマンドのメッセージログ |
◎ |
× |
◎ |
× |
|
アカウント情報管理コマンドのメッセージログ |
◎ |
× |
◎ |
× |
次に,ローテーション方式と出力先ファイルの切り替えの概要について説明します。詳細については,マニュアル「アプリケーションサーバ 機能解説 保守/移行編」の「3.2.1 設定できる内容」を参照してください。
- 〈この項の構成〉
(1) 出力ファイルのローテーション方式
ローテーション方式の種類を次に示します。
説明 |
|
---|---|
ファイル名にファイルの面数が付加されます。
|
|
ファイル名は固定で,バックアップファイル名にファイルの面数が付加されます。
|
(2) 出力先ファイルの切り替え方式
ログファイルやトレースファイルは,出力するファイルを一定の基準で切り替えられます。切り替え方式には次の2種類があります。
-
ファイルサイズで切り替える方法
ファイルサイズが規定値に達したら,出力先ファイルを切り替えます。
-
ファイルサイズまたは時刻で切り替える方法
次のどちらかを満たしたら,出力先ファイルを切り替えます。
-
指定時刻に達した
-
指定したファイルサイズに達した
-
トレースファイルは適切なファイルサイズになるよう見積もる必要があります。トレースファイルの総ファイルサイズは,次に示す情報を基に算出してください。
-
1日当たりに受信する電文の件数(単位:件)
-
トレース情報を保存する期間(単位:日)
算出した総ファイルサイズを基に,1ファイル当たりのトレースファイルサイズやトレース面数を見積もってください。
トレースファイルサイズやトレース面数はHCSCサーバランタイム定義ファイルで設定します。HCSCサーバランタイム定義ファイルの詳細については,マニュアル「サービスプラットフォーム リファレンス」の「6.5.6 HCSCサーバランタイム定義ファイル」を参照してください。
(3) ログおよびトレース取得時の注意事項(全般的な注意事項)
性能解析トレース以外のすべてのログやトレースでは,次に示す注意事項があります。
-
ファイルの編集はできません。
-
テキストビューワやエディタに,ロックするオプションがある場合は,使用できません。ファイルをロックした場合,トレースが出力されなくなる可能性があります。
-
ファイルのアクセス権限は変更できません。
手動でアクセス権限を設定する必要がある場合には,適切なアクセス権限を設定してください。適切なアクセス権限が与えられていない場合,トレースを出力できなくなります。
-
ファイルの更新時刻は変更できません。
ファイルの更新時刻を変更した場合,出力先ファイルが変わる可能性があります。
-
トレース出力中に,ファイルを名称変更したり,削除したりしないでください。
管理ファイルの情報を基に出力先ファイルを決められますが,管理ファイルがない場合,および管理ファイルが破壊されている場合には,ファイルの更新時刻を基に判定されます。ファイルの名称変更,または削除は,すべてのトレース出力プロセスを停止してから実行してください。
(4) ログおよびトレース取得時の注意事項(HCSC-Managerのログに関する注意事項)
-
メッセージ末尾の改行コードは,プラットフォームに関係なく「CR+LF」になります。
-
例外ログ,およびメンテナンスログの場合は,さらに次に示す注意事項があります。
-
ファイルサイズ/面数の変更を有効にするためには,ファイルの削除が必要です。ファイルを削除する場合には,トレース出力プロセスを停止してください。対象のファイルは,HCSC-Manager定義ファイルのプロパティcscmng.log.dirに指定したディレクトリ以下のファイルです。
-
出力したトレースファイルは,最初のEOF文字(0x1A)が現れるまでが有効なデータです。EOF文字以降のデータについては,一切保証されません。最初のEOF文字以降にもEOF文字が現れる可能性があるため,注意が必要です。
-
トレースを出力してもファイルの更新時刻の更新は保証されません。ファイルの更新時刻を基に,トレースが出力されたかどうかを判定できません。トレース出力終了時にはファイルの更新時刻が更新されます。
-