JMSトピック: 構成: しきい値と割当
このページでは、トピックのバイト/メッセージしきい値の上限と下限を定義します。これらのしきい値を超過すると、ログ・メッセージの生成およびメッセージ・フロー制御の開始などのイベントがトリガーされます。また、トピックで許容される最大メッセージ・サイズを指定したり、あらかじめ構成された割当てを選択することもできます。この割当てにより、メモリー使用量を節約するためにトピックに格納できる最大メッセージ数または最大バイト数が決定されます。
このトピックにJMSテンプレートが指定されている場合、デフォルト値は実際の値がテンプレートに基づくことを意味します。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
トピック・サブスクリプション・メッセージの制限 トピック・サブスクリプションに格納できるメッセージの最大数。
指定した制限に到達したサブスクリプションに新しいメッセージが到着すると、新しいメッセージ用のスペースを設けるため、それらのサブスクリプションで最初に使用可能なメッセージが削除されます。サブスクリプション・メッセージがこの削除から免除されるのは、それらが保留中のトランザクションに参加しており、すでにコンシューマに渡されていて確認応答を待機している場合、またはそれらがそのすべてのメッセージの蓄積を待機している作業単位の一部である場合です。すべてのメッセージが削除から免除される場合、新しいメッセージによってサブスクリプション・サイズがその制限を超える可能性があります。
-1の値に設定されている場合、制限はオーバーライドされません。
MBean属性(アプリケーション・モジュールには適用しない):
TopicSubscriptionParamsBean.MessagesLimitOverride
最小値:
-1
最大値:
9223372036854775807