15.3.14　イベント・アクション制御の通信に関する環境設定パラメーター

(1)　ClientConnectTimeoutについて

イベント・アクション制御マネージャーおよびイベント・アクション制御エージェントは，接続要求を送信すると，通信相手から応答があるまで待ちます。一定時間経過しても応答がない場合は，ほかの処理をするために，いったんタイムアウトします。接続要求に対する応答を待つ時間のことを，接続タイムアウト時間といいます。

接続タイムアウト時間は，環境設定パラメーターClientConnectTimeoutで設定します。

環境設定パラメーターClientConnectTimeoutで設定する接続タイムアウト時間を，次の図に示します。

図15‒3　環境設定パラメーターClientConnectTimeoutで設定する接続タイムアウト時間

環境設定パラメーターClientConnectTimeoutに設定する時間を長くすると，接続タイムアウト時間が長くなります。その場合，通信負荷などが原因で通信相手から応答が届くまでに時間が掛かる場合でも，接続タイムアウトが発生しにくくなります。

しかし，ネットワーク機器の故障などで長時間，通信相手から接続要求への応答がない場合，タイムアウトするまでの時間も長くなります。その場合，イベントジョブ，カスタムイベントジョブおよび起動条件付きジョブネットの実行要求や強制終了要求，イベントの成立通知が処理されない時間も長くなります。タイムアウト待ちになっている間は，通信ができる別のエージェントにイベントジョブ，カスタムイベントジョブおよび起動条件付きジョブネットを実行登録したり，強制終了したりしても，すぐに処理できないため，ジョブの状態が変わるまでに時間が掛かります。そのため，接続タイムアウトが発生した場合，デフォルトでは一定間隔でリトライを繰り返すのではなく，間隔を徐々に長くしてリトライの頻度を下げながらリトライします。詳細については，「(2) NotificationConstantRetryについて」を参照してください。

ページの先頭へ

(2)　NotificationConstantRetryについて

ページの先頭へ

(3)　NotificationRetryIntervalとNotificationRetryCountについて

接続タイムアウト以外にも，次のような原因などで，通信がエラーになることがあります。

• 実行先エージェントホスト名の名前解決ができていない

• イベント・アクション制御エージェントがビジー状態で実行要求や強制終了の要求を受け付けられない

接続タイムアウト以外のエラーになった場合の，イベント・アクション制御マネージャーとイベント・アクション制御エージェント間での通信リトライ間隔とリトライ回数は，それぞれ環境設定パラメーターNotificationRetryInterval（デフォルト30秒）と環境設定パラメーターNotificationRetryCount（デフォルト2,880回）で設定できます。

接続タイムアウト以外のエラーが発生した場合の例を次の図に示します。

図15‒6　接続タイムアウト以外のエラーが発生した場合

この環境設定パラメーターの設定を変更しても，リトライする期間を変えたくない場合は，リトライ間隔とリトライ回数の両方を調整してください。例えば，リトライ間隔をデフォルト値の半分の15秒と設定した場合，リトライ回数をデフォルト値の2倍の5,760回と設定すると，リトライする期間がデフォルトの期間と同じになります。

ページの先頭へ

(4)　NotificationAlarmCountについて

マネージャーへの通知を何度も再送しても通知できない状態になった場合に，メッセージKAVT0669-Eを出力するためのしきい値を設定することで，長時間マネージャーへの通知が滞っていることを検出できます。JP1/AJS3 13-10以降の新規インストールおよび新規セットアップ時の初期設定値は，Windowsの場合24回^※，UNIXの場合29回^※です。なお，環境設定パラメーターNotificationConstantRetryに「N」（リトライ間隔を延ばす）を指定する場合は，次の式で求まった値について，小数点以下を切り上げた値を目安に再送回数を指定してください。

注※

環境設定パラメーターNotificationConstantRetryに「Y」（一定間隔でリトライ），環境設定パラメーターNotificationRetryIntervalに10秒を指定し，接続待ちタイムアウトによる通知失敗が継続した場合，マネージャーへの通知に最初に失敗してから約10分後に出力されます（通信エラーの発生要因，システムやネットワークの負荷状況などによって変動することがあります）。

環境設定パラメーターNotificationAlarmCountの設定値の目安 = ((n - 6 * b) / (a + 6 * b)) + 2

（凡例）

n：

通知失敗を検知したい秒数（単位：秒）

a：

環境設定パラメーターClientConnectTimeoutの設定値またはOSのデフォルトの接続待ちタイムアウト時間のうち，短い方の時間^※（単位：秒）

b：

環境設定パラメーターNotificationRetryIntervalの設定値（単位：秒）

注※

再送が接続タイムアウトで失敗する場合に指定する値になります。

なお，この環境設定パラメーターに「0」を指定した場合やこの環境設定パラメーターが未指定の場合，メッセージKAVT0669-Eは出力されません。

ページの先頭へ

(5)　環境設定パラメーター設定の目安

通信の際に重視したい点に合わせた，各環境設定パラメーターの設定値の目安を，次の表に示します。

表15‒63　通信の際に重視したい点と環境設定パラメーターの設定値の目安（マネージャー）

		調整が必要な環境設定パラメーター				注意事項
		ClientConnectTimeoutの値 （単位：ミリ秒）	NotificationConstantRetryの値	NotificationRetryIntervalの値 （単位：秒）	NotificationRetryCountの値
デフォルト値		Windowsの場合：30,000 UNIXの場合：1,000※1	N	30	2,880/27※2	−
重視する点	一部のエージェントに対する通信でタイムアウトが発生する場合に，ほかのエージェント向けの処理遅延を抑止したいときの目安	3,000〜10,000	N	−	−	リトライ間隔が300秒，600秒，900秒，1,800秒，3,600秒と段階的に伸びるため，エージェントへの通信がタイムアウトしない状況になっても，次の再送までに時間が掛かります。
	エージェントに対する通信でタイムアウトが発生しにくくなるようにしたいときの目安	10,000〜60,000	N	−	−	一部のエージェントに対する通信でタイムアウトが発生する場合に，ほかのエージェント向けの処理が待たされて遅延し，イベントを検知できなくなることがあります。
	通信環境が安定している環境で，一時的な通信障害が発生した場合に，通信環境の回復に即応して処理遅延を抑えたいときの目安	3,000〜10,000	Y	3〜10	2,880※2	一部のエージェントに対する通信でタイムアウトが頻発・継続すると，ほかのエージェント向けの処理が待たされて遅延し，イベントを検知できなくなることがあります。
	通信環境が不安定なため，通信が遅延してでも通信したいときの目安	10,000〜60,000	Y	3〜10	8,640〜28,800	一部のエージェントに対する通信でタイムアウトが頻発・継続すると，ほかのエージェント向けの処理が待たされて遅延し，イベントを検知できなくなることがあります。
	早めに異常を検出したいときの目安	3,000〜10,000	Y	3〜10	30〜100	イベントジョブおよびカスタムイベントジョブが異常検出終了することがあります。この場合，統合トレースログにメッセージKAVT0103-Eが出力されるため，このメッセージを監視することで通信環境の異常を検出できます。

（凡例）

−：該当しない。

注※1

WindowsとUNIXの場合でデフォルト値に大きな差がある理由は，UNIXの場合のデフォルト値がバージョン8のJP1/AJS2の設定と下位互換を保持しているためです。

バージョン8の場合，環境設定パラメーターClientConnectTimeoutは存在しませんが，この環境設定パラメーターに1,000を設定した場合と同様に動作します。UNIXの場合のデフォルト値は，この値を基にしています。

注※2

2,880回はタイムアウト以外のエラー，27回はタイムアウトエラーが続いた場合の値です。

表15‒64　通信の際に重視したい点と環境設定パラメーターの設定値の目安（エージェント）

		調整が必要な環境設定パラメーター				注意事項
		ClientConnectTimeoutの値 （単位：ミリ秒）	NotificationConstantRetryの値	NotificationRetryIntervalの値 （単位：秒）	NotificationRetryCountの値
デフォルト値		Windowsの場合：30,000 UNIXの場合：1,000	Y	10	8,640	−
重視する点	マネージャーに対する通信でタイムアウトが発生しにくくなるようにしたいときの目安	10,000〜60,000	N	−	−	一部のマネージャーに対する通信でタイムアウトが発生する場合に，ほかのマネージャー向けの処理が待たされてジョブの開始やイベントの検知が遅延することがあります。

（凡例）

−：該当しない。

各環境設定パラメーターの定義内容の詳細については，次の個所を参照してください。

• 「20.6.2(8) NotificationConstantRetry（マネージャーホストからエージェントホストへの通信の場合）」

• 「20.6.2(26) NotificationConstantRetry（エージェントホストからマネージャーホストへの通信の場合）」

• 「20.8.2(1) ClientConnectTimeout（通信制御）」

イベント・アクション制御マネージャーからイベント・アクション制御エージェントへの通信に関する環境設定パラメーターの定義内容の詳細については，次の個所を参照してください。

• 「20.6.2(9) NotificationRetryInterval（マネージャーホストからエージェントホストへ送信する場合）」

• 「20.6.2(10) NotificationRetryCount（マネージャーホストからエージェントホストへ送信する場合）」

イベント・アクション制御エージェントからイベント・アクション制御マネージャーへの通信に関する環境設定パラメーターの定義内容の詳細については，次の個所を参照してください。

• 「20.6.2(27) NotificationAlarmCount」

• 「20.6.2(28) NotificationRetryInterval（エージェントホストからマネージャーホストへ送信する場合）」

• 「20.6.2(29) NotificationRetryCount（エージェントホストからマネージャーホストへ送信する場合）」

ページの先頭へ