ストア アンド フォワード エージェント : コンフィグレーション : しきい値と 割り当て
このページでは、このストア アンド フォワード エージェントの最大のメッセージ/ バイト割り当て、上限と下限のメッセージ/バイトしきい値、および最大許容 メッセージ サイズを定義します。
コンフィグレーション オプション
名前 説明 最大バイトしきい値 SAF エージェントに保存されているバイト数に基づいてイベントを発生させる上限しきい値。
デフォルト値の
-1
に設定すると、この SAF エージェントでのイベントは無効になります。送信機能のあるエージェントにのみ適用されます。
BytesThresholdHigh
の更新の影響を受けるのは、新規のリクエストのみです。バイト数がこのしきい値を超えた場合、発生するイベントは以下のとおりです。
ログ メッセージ : 最大しきい値条件を示すメッセージがサーバに記録されます。
フロー制御 : エージェントが防御状態になり、プロデューサに対してメッセージ フローを減らすよう指示します。
値の範囲 : <= BytesMaximum; >= BytesThresholdLow
MBean 属性:
SAFAgentMBean.BytesThresholdHigh
最小値:
-1
最小バイトしきい値 SAF エージェントに保存されているバイト数に基づいて、イベントを発生させる下限しきい値。
デフォルト値の
-1
に設定すると、この SAF エージェントでのイベントは無効になります。送信機能のあるエージェントにのみ適用されます。
BytesThresholdLow
の更新の影響を受けるのは、新規のリクエストのみです。バイト数がこのしきい値を下回った場合、発生するイベントは以下のとおりです。
ログ メッセージ : しきい値条件が解除されたことを示すメッセージがサーバに記録されます。
フロー制御 : エージェントが防御状態を解除して、プロデューサに対してメッセージ フローを増やすよう指示します。
値の範囲 : <= BytesThresholdHigh
MBean 属性:
SAFAgentMBean.BytesThresholdLow
最小値:
-1
最大メッセージしきい値 SAF エージェントに保存されているメッセージ数に基づいてイベントを発生させる上限しきい値。
デフォルト値の
-1
に設定すると、この SAF エージェントでのイベントは無効になります。送信機能のあるエージェントにのみ適用されます。
MessagesThresholdHigh
の更新の影響を受けるのは、新規のリクエストのみです。メッセージ数がこのしきい値を超えた場合、発生するイベントは以下のとおりです。
ログ メッセージ : 最大しきい値条件を示すメッセージがサーバに記録されます。
フロー制御 : エージェントが防御状態になり、プロデューサに対してメッセージ フローを減らすよう指示します。
値の範囲 : <= MessagesMaximum; >= MessagesThresholdLow
MBean 属性:
SAFAgentMBean.MessagesThresholdHigh
最小値:
-1
最小メッセージしきい値 SAF エージェントに保存されているメッセージ数に基づいてイベントを発生させる下限しきい値。
デフォルト値の
-1
に設定すると、この SAF エージェントでのイベントは無効になります。送信機能のあるエージェントにのみ適用されます。
MessagesThresholdLow
の更新の影響を受けるのは、新規のリクエストのみです。メッセージ数がこのしきい値を下回った場合、発生するイベントは以下のとおりです。
ログ メッセージ : しきい値条件が解除されたことを示すメッセージがサーバに記録されます。
フロー制御 : エージェントが防御状態を解除して、プロデューサに対してメッセージ フローを増やすよう指示します。
値の範囲 : <= MessagesThresholdHigh.
MBean 属性:
SAFAgentMBean.MessagesThresholdLow
最小値:
-1
最大バイト数 この SAF エージェントに保存可能な最大バイト数の割り当て (合計バイト数)。
デフォルト値
-1
は、保存可能なバイト数が制限されていないことを示します。ただし、あまり大きなバイト数を割り当てると、メモリが飽和状態になるおそれがあるので、残りのアプリケーションの負荷を考慮に入れ、利用可能なシステム メモリの総量に見合った値にしてください。送信機能のあるエージェントにのみ適用されます。
BytesMaximum
の更新の影響を受けるのは、新規のリクエストのみです。値の範囲 : >= BytesThresholdHigh
MBean 属性:
SAFAgentMBean.BytesMaximum
最小値:
-1
最大メッセージ数 この SAF エージェントに保存可能な最大メッセージ数の割り当て (合計メッセージ数)。
デフォルト値
-1
は、サーバ インスタンスで保存可能なメッセージ数が制限されていないことを示します。ただし、あまり大きなメッセージ数を割り当てると、メモリが飽和状態になるおそれがあるので、残りのアプリケーションの負荷を考慮に入れ、利用可能なシステム メモリの総量に見合った値にしてください。送信エージェントにのみ適用されます。
最大メッセージ数の割り当てを更新すると、メッセージ数がリセットされるため、更新後に受信されたリクエストのみが、新しい割り当てを適用されます。
値の範囲 : >= MessagesThresholdHigh
MBean 属性:
SAFAgentMBean.MessagesMaximum
最小値:
-1
最大メッセージ サイズ この SAF エージェントの個々のメッセージに許可される最大バイト数。
メッセージのサイズには、メッセージの本文、ユーザ定義のプロパティ、ユーザ定義の JMS ヘッダ フィールド (
JMSCorrelationID
およびJMSType
) が含まれます。コンフィグレーションされた最大メッセージ サイズを超えるメッセージを SAF エージェントに送信したプロデューサは、
ResourceAllocationException
を受け取ります。最大メッセージ サイズは、メッセージの最初の生成に対してのみ適用されます。エラー送り先に転送されるメッセージや、分散送り先のメンバーに転送されるメッセージは、サイズをチェックされません。たとえば、送り先の最大メッセージ サイズが 128KB、対応するエラー送り先の最大メッセージ サイズが 64KB でコンフィグレーションされている場合、96KB のメッセージは (64KB を超えても) エラー送り先にリダイレクトできますが、プロデューサが 96KB のメッセージをエラー送り先に直接送信することはできません。
送信機能のあるエージェントにのみ適用されます。
MaximumMessageSize
を更新すると影響を受けるのは、新しく配信されるメッセージのみです。保存されているメッセージは影響を受けません。MBean 属性:
SAFAgentMBean.MaximumMessageSize
最小値:
0