8.2.1 CSCIWの出力情報の取得
CSCIWを運用しているマシン上で,障害情報を取得してください。
- 〈この項の構成〉
(1) 出力する情報およびファイル名
CSCIWが出力する情報,および出力ファイル名を次に示します。
(2) 出力ファイルのローテーションの設定
CSCIWが出力するメッセージ・トレースのローテーション種別は,次の2種類のモードがあります。メッセージ・トレースのローテーション種別は,セットアッププロパティファイルのLogRotationModeキーで設定します。セットアッププロパティファイルの設定内容については,「付録A.2 セットアッププロパティファイル」を参照してください。
(a) ラップアラウンドモード
-
ローテーション条件
指定ファイル容量を超えた場合
-
ローテーション時のファイル名
ファイル名がxxx_TRCの場合,xxx_TRC_1.log,xxx_TRC_2.log…のように通番が付与されたファイルが作成されます。通番の範囲は,1〜(設定したファイル面数)です。ファイル面数分のファイルが作成されたあとでローテーションが発生すると,出力先が通番1のファイルにローテーションします。
ラップアラウンドモードのファイル名の付与例を次に示します。
xxx_TRC_1.log xxx_TRC_2.log xxx_TRC_3.log
(b) シフトモード
-
ローテーション条件
指定ファイル容量を超えた場合,または指定時刻になった時
-
ローテーション時のファイル名
ファイル名がxxx_TRCの場合,トレースを出力するファイルは常に通番無しのxxx_TRC.log(現用系ファイル)になります。設定したローテーション条件を満たし,ローテーションが発生すると,バックアップファイルに対して,xxx_TRC1.log,xxx_TRC2.log…のように通番が付与されたファイル名に変更(リネーム)されます。このとき,通番が小さいファイルから順に,新しいファイルとなります。通番の範囲は,1〜(設定したバックアップ面数)です。また,シフトモードの場合には,トレースファイル以外に条件やローテーション状態を管理するためのコントロールファイルが生成されます。このため,ファイルの合計数は,指定したバックアップ面数+2(現用系ファイル,コントロールファイル)となります。
シフトモードのファイル名の付与例を次に示します。
xxx_TRC.conf ← コントロールファイル xxx_TRC.log ← 現用系ファイル xxx_TRC1.log ← バックアップファイル xxx_TRC2.log ← バックアップファイル xxx_TRC3.log ← バックアップファイル
(3) 出力情報の設定
(a) 設定方法
エラートレース以外のトレースファイルとメッセージファイルに関してはセットアッププロパティファイルで設定します。セットアッププロパティファイルについては,「付録A.2 セットアッププロパティファイル」を参照してください。
エラートレースの出力先ディレクトリは環境変数で設定します。
エラートレースの設定値を次の表に示します。
設定項目 |
出力する情報 |
---|---|
出力先ディレクトリ |
環境変数で設定(${CSCIW_HOME}/log)※ |
トレースレベル |
固定(20) |
面数 |
固定(16) |
サイズ |
固定(2MB) |
削除までの日数 |
固定(2日) |
ローテーション種別 |
固定(ラップアラウンド) |
(b) 出力レベルの設定
エラートレース以外の出力ファイルは,運用および障害発生時の対応時間を考慮し,出力レベルを設定できます。
設定できる出力レベル,および各レベルで出力される内容を次の表に示します。
(4) 各種トレースファイルの切り替えの流れ
各種トレースファイルが切り替わるのは,各種トレースの初期化処理が完了した時点です。各種トレースファイルの切り替えの流れを次の図に示します。
- 説明
-
上の図に示すように,終了処理が行われた時点で,通常トレースファイルと通常メッセージファイルはクローズするため,トレースおよびメッセージの出力は停止します。トレースおよびメッセージの再出力が開始されるのは初期化トレースの初期化完了後になります。ただし,例外発生などのエラーが発生した場合には,エラートレースファイルを作成します。また,初期化メッセージおよび通常メッセージの作成に失敗した場合もエラートレースを作成します。
(5) トレースファイル取得時の注意事項
(a) トレースファイルの自動削除機能について
CSCIWが出力するトレースファイルは,最終更新日より設定した日数を経過すると最初の出力処理時に,対象トレースファイルを自動で削除します。
自動で削除されるまでの日数は,エラートレースについては固定(2日),エラートレース以外のトレースファイルについては,セットアッププロパティファイルで指定できます。
なお,削除されるエラートレースは,環境変数CSCIW_HOME下のlogファイル(${CSCIW_HOME}/log)が対象です。環境変数CSCIW_HOMEが未設定時の場合は,エラートレースファイルは削除されません。また,カレントディレクトリに出力されたエラートレースは,不要になった時点で削除してください。
- 重要
-
Windowsの場合,1970年1月1日より以前のファイルを削除するような日数を指定した場合,すべてのトレースファイルが削除されます。
- メモ
-
UNIXの場合,1970年1月1日より以前のファイルを削除するような日数を指定した場合,すべてのトレースファイルが削除されるようなことはありません。指定に従ってファイルが自動的に削除されます。
(b) 改行文字の扱いについて
各種トレースファイル(Cosminexus性能解析トレースを除く)に出力されるメッセージ本文(ファイル中のmessageの列)に改行文字が含まれている場合は,改行文字の個所でメッセージを区切り,改行文字以降のメッセージを次の行へ出力します。複数行にわたるメッセージについては,メッセージIDおよびメッセージタイプを1行目に出力し,2行目以降にはメッセージIDおよびメッセージタイプを出力しません。
Cosminexus性能解析トレースについては,メッセージ本文に改行文字が含まれていると,OPTの列に「0a」,ASCIIの列に「.」が出力されます。
(c) 1行に出力されるメッセージのバイト数について
各種トレースファイル(Cosminexus性能解析トレースを除く)のメッセージ本文(ファイル中のmessageの列)に出力される出力バイト数は,メッセージ1行につき最大4,095バイトです。4,095バイトを超えるメッセージ本文については4,096バイト目以降が削除され,4,095バイト目までを出力します。
(d) Unicodeの補助文字について
Unicodeの補助文字とは,基本多言語面(BMP)以外の文字,UnicodeのコードポイントU+10000〜U+10FFFFの範囲の文字,UTF-16エンコーディングでのサロゲート・ペアで表される文字のことです。このUnicodeの補助文字は,Windows VistaでサポートされたJIS X0213:2004の第三水準および第四水準の文字の一部に含まれます。メッセージ本文(ファイル中のmessageの列)にUnicodeの補助文字がある場合は,各種トレースファイルには該当する補助文字の部分が正しく出力されませんが,同一行および同一ファイル内のそのほかの文字出力には影響ありません。