Interstage Application Server/Interstage Web Server チューニングガイド |
目次 索引 |
付録D イベントサービスの環境定義 |
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
目次 索引 |