共通分散キュー : コンフィグレーション : しきい値と 割り当て
このページでは、共通分散キューのバイト/メッセージしきい値の上限と 下限を定義します。これらのしきい値を超えると、ログ メッセージの 生成やメッセージ フロー制御の開始などのイベントがトリガされます。 また、キューで許容される最大メッセージ サイズを指定したり、あら かじめコンフィグレーションされた割り当てを選択することもできます。 この割り当てにより、メモリ使用量を節約するために分散キューに格納 できる最大メッセージ数または最大バイト数が決定されます。
JMS サーバでは、JMS サーバに割り当てられた JMS モジュール内のすべての 送り先のしきい値と特定の割り当ての設定を管理することもできます。
コンフィグレーション オプション
名前 説明 最大バイトしきい値 ロギングやフロー制御イベントを発生させる上限しきい値 (この送り先内の合計バイト数)。java.lang.Long.MAX_VALUE の値は、送り先のロギングおよびフロー制御イベントを無効化します。
バイト数がこのしきい値を超えた場合、発生するイベントは以下のとおりです。
ログ メッセージ
- 最大しきい値条件を示すメッセージがサーバのログに記録されます。
フロー制御
- フロー制御が有効化されている場合、送り先が防御状態になり、プロデューサに対してメッセージ フローを減らすよう指示します。
値の範囲 : <= BytesMaximum; >= BytesThresholdLow
このしきい値に対する変更は、着信メッセージにのみ影響します。格納されているメッセージには影響しません。
MBean 属性 (アプリケーション モジュールには適用しない) :
ThresholdParamsBean.BytesHigh
最小値:
0
最大値:
9223372036854775807
最小バイトしきい値 ロギングやフロー制御イベントを発生させる下限しきい値 (この送り先内の合計バイト数)。java.lang.Long.MAX_VALUE の値は、送り先のロギングおよびフロー制御イベントを無効化します。
バイト数がこのしきい値を下回った場合、発生するイベントは以下のとおりです。
ログ メッセージ
最小しきい値条件を示すメッセージがサーバのログに記録されます。
フロー制御
- フロー制御が有効化されている場合、送り先が防御状態を解除して、プロデューサに対してメッセージ フローを増やすよう指示します。
値の範囲 : < BytesThresholdHigh
このしきい値に対する変更は、着信メッセージにのみ影響します。格納されているメッセージには影響しません。
MBean 属性 (アプリケーション モジュールには適用しない) :
ThresholdParamsBean.BytesLow
最小値:
0
最大値:
9223372036854775807
最大メッセージしきい値 ロギングやフロー制御イベントを発生させる上限しきい値 (この送り先内の合計メッセージ数)。java.lang.Long.MAX_VALUE の値は、送り先のロギングおよびフロー制御イベントを無効化します。
メッセージ数がこのしきい値を超えた場合、発生するイベントは以下のとおりです。
ログ メッセージ
- 最大しきい値条件を示すメッセージがサーバのログに記録されます。
フロー制御
- フロー制御が有効化されている場合、送り先が防御状態になり、プロデューサに対してメッセージ フローを減らすよう指示します。
値の範囲 : <= MessagesMaximum; >= MessagesThresholdLow
このしきい値に対する変更は、着信メッセージにのみ影響します。格納されているメッセージには影響しません。
MBean 属性 (アプリケーション モジュールには適用しない) :
ThresholdParamsBean.MessagesHigh
最小値:
0
最大値:
9223372036854775807
最小メッセージしきい値 ロギングやフロー制御イベントを発生させる下限しきい値 (この送り先内の合計メッセージ数)。java.lang.Long.MAX_VALUE の値は、送り先のロギングおよびフロー制御イベントを無効化します。
メッセージ数がこのしきい値を下回った場合、発生するイベントは以下のとおりです。
ログ メッセージ
最小しきい値条件を示すメッセージがサーバのログに記録されます。
フロー制御
- フロー制御が有効化されている場合、送り先が防御状態を解除して、プロデューサに対してメッセージ フローを増やすよう指示します。
値の範囲 : < MessagesThresholdHigh
このしきい値に対する変更は、着信メッセージにのみ影響します。格納されているメッセージには影響しません。
MBean 属性 (アプリケーション モジュールには適用しない) :
ThresholdParamsBean.MessagesLow
最小値:
0
最大値:
9223372036854775807
割り当て Quota は、送り先で使用できるシステム リソースの割り当てを制御します。たとえば、送り先で格納できるバイト数を Quota を使ってコンフィグレーションできます。
MBean 属性 (アプリケーション モジュールには適用しない) :
DestinationBean.Quota
最大メッセージ サイズ この送り先でプロデューサから受信するメッセージの最大サイズ。
メッセージのサイズには、メッセージの本文、ユーザ定義のプロパティ、ユーザ定義の JMS ヘッダ フィールド (JMSCorrelationID および JMSType) が含まれます。送り先でコンフィグレーションされた最大メッセージ サイズを超えるメッセージを送信したプロデューサは、ResourceAllocationException を受け取ります。
最大メッセージ サイズは、メッセージの最初の生成に対してのみ適用されます。エラー送り先に転送されるメッセージや、分散送り先のメンバーに転送されるメッセージは、サイズをチェックされません。たとえば、送り先の最大メッセージ サイズが 128KB、対応するエラー送り先の最大メッセージ サイズが 64KB でコンフィグレーションされている場合、96KB のメッセージは (64KB を超えても) エラー送り先にリダイレクトできますが、プロデューサが 96KB のメッセージをエラー送り先に直接送信することはできません。
この属性は動的にコンフィグレーションできますが、新しく配信されるメッセージにのみ適用され、すでに保存されているメッセージには影響しません。
MBean 属性 (アプリケーション モジュールには適用しない) :
DestinationBean.MaximumMessageSize
最小値:
0
最大値:
2147483647