■概要
traceconfigファイルは、イベントサービスのトレース動作環境に関する定義が格納されたファイルです。
■ファイル名
C:\Interstage\eswin\etc\traceconfig (インストールパスはデフォルト)
/etc/opt/FJSVes/traceconfig (インストールパスはデフォルト)
/etc/opt/FJSVes/traceconfig
■ファイル内情報
traceconfigファイルは、以下の形式で値を設定します。
◆形式:
パラメタ名 = 設定値
◆パラメタ:
以下の動作環境について、パラメタ設定値を変更することができます。
パラメタ値を変更した場合、次回のイベントサービス起動時より有効となります。
パラメタ名 | 初期値 | 意味 |
|---|---|---|
省略値 | ||
指定範囲 | ||
trace_size | 1024 | トレース情報の採取に使用するバッファのサイズをキロバイト単位で指定します。 (注1) |
512 | ||
512～102400 | ||
trace_file_number |
| 採取するトレース情報ファイルの最大数を指定します。トレース情報ファイルの数が指定値を超えた場合は、古いトレース情報ファイルに上書きします。 |
| ||
| ||
trace_auto | yes | トレース情報の自動採取を有効にするかを指定します。
|
yes | ||
yes, no | ||
| process | 内部トレースを採取する単位を指定します。
|
process | ||
process, system |
注1)
トレース情報の出力サイズはチャネル数、コンシューマ数、サプライヤ数、および通信頻度によって異なります。起動処理系、通信処理系、および停止処理系で使用するトレース情報のバッファサイズを以下に記載します。
プロセス単位で内部トレースを採取する(trace_buffer = process)場合、トレース情報の出力サイズはチャネル数、コンシューマ数、サプライヤ数、および通信頻度によって異なります。起動処理系、通信処理系、および停止処理系で使用するトレース情報のバッファサイズを以下に記載します。
なお、イベントサービス単位で内部トレースを採取する(trace_buffer = system)場合は、起動処理系、通信処理系、および停止処理系で使用するトレース情報を1つのバッファに格納されるため、それぞれを加算してください。
起動処理系
イベントチャネル起動: 3.2KB
サプライヤ起動処理(pushメソッドを出すまで): 1.0KB
コンシューマ起動処理(pullメソッドを出すまで): 1.0KB
通信処理系
pushメソッド: 0.8KB
pullメソッド(受信成功): 1.2KB
pullメソッド(COMM_FAILURE[minor=0x464a09c1]): 1.0KB
停止処理系
イベントチャネル停止: 3.4KB
サプライヤdisconnect処理: 0.5KB
コンシューマdisconnect処理: 0.8KB
トレース情報バッファサイズを初期設定で運用した場合の計算例を以下に示します。
【1チャネルで、コンシューマ数:サプライヤ数が1:1の場合】
1回の通信(push/pull)で2.0KB(0.8KB＋1.2KB)のバッファサイズが必要となります。
トレース情報バッファは、バッファを半分ずつサイクリックに使用するため、トレース情報バッファ(サイズ:1024KB)に格納できる通信のトレース情報数は256回となります。
(トレース情報バッファサイズ ÷ 2) ÷ 1回の通信に必要なバッファサイズ ＝
(1024KB ÷ 2) ÷ 2.0KB ＝ 256回
40秒に1回の通信を行うと仮定した場合、約2.8時間の通信をロギングできることになります。
256 × 40秒 ＝ 10240秒 ＝ 約2.8時間
上記の例では、トレース情報を自動採取する事象が発生するまでの約2.8時間分のトレース情報を採取することができます。
トレース情報バッファサイズは、少なくとも5分以上のトレース情報が採取可能なサイズを指定してください。
トレース情報バッファサイズを初期値から変更した場合、その増分だけ共用メモリ使用量が増加します(キロバイト単位)。
注2)
トレース情報の自動採取を有効とする(trace_auto = yes)場合、トレースファイルは以下のファイル名で出力されます。(XXX:3桁の10進数の数値)
C:\Interstage\eswin\var\ESLOGXXX
/var/opt/FJSVes/ESLOGXXX
プロセス単位で内部トレースを採取する(trace_buffer = process)場合
イベントサービスのデーモンプロセスのログ情報
/var/opt/FJSVes/ESLOGDUMPDAEMONXXX
イベントファクトリプロセスのログ情報
/var/opt/FJSVes/ESLOGDUMPFACTORYXXX
静的イベントチャネルプロセスのログ情報
/var/opt/FJSVes/ESLOGDUMPグループ名XXX
動的イベントチャネルプロセスのログ情報
/var/opt/FJSVes/ESLOGDUMPインプリメンテーション名XXX
イベントサービス単位で内部トレースを採取する(trace_buffer = system)場合
/var/opt/FJSVes/ESLOGXXX
