付録B アドレス設定設定要素

以下の表は、address-setting のすべての設定要素の一覧です。一部の要素は DEPRECATED とマークされていることに注意してください。潜在的な問題を回避するには、推奨される代替手段を使用してください。

表B.1 アドレス設定要素

名前説明

address-full-policy

max-size-bytes で設定したアドレスが満杯になるとどうなるかを決定します。利用可能なポリシーは以下のとおりです。

PAGE : 完全なアドレスに送信されたメッセージは、ディスクにページングされます。

DROP : 完全なアドレスに送信されたメッセージは警告なしで破棄されます。

FAIL : 完全なアドレスに送信されたメッセージはドロップされ、メッセージプロデューサーは例外を受け取ります。

BLOCK: メッセージプロデューサーは、それ以上メッセージを送信しようとするとブロックします。

注記

BLOCK ポリシーは、AMQP、OpenWire、および Core Protocol プロトコルでのみ機能します。

auto-create-addresses

マッピング先のキューからキューの存在しないアドレスにメッセージを送信するか、消費しようとした場合にアドレスを自動作成するかどうか。デフォルト値は true です。

auto-create-dead-letter-resources

ブローカーがデッドレターアドレスおよびキューを自動的に作成し、未配信メッセージを受信するかどうかを指定します。デフォルト値は false です。

パラメーターが true に設定されている場合、ブローカーはデッドレターアドレスと関連するデッドレターキューを定義する <address> 要素を自動的に作成します。自動作成された <address> 要素の名前は、<dead-letter-address> に指定する name の値と一致します。

auto-create-jms-queues

非推奨: 代わりに auto-create-queues を使用してください。JMS プロデューサーまたはコンシューマーがこのようなキューを使用しようとするときに、このブローカーが、アドレス設定に対応する JMS キューを自動的に作成するかどうかを決定します。デフォルト値は false です。

auto-create-jms-topics

非推奨: 代わりに auto-create-queues を使用してください。JMS プロデューサーまたはコンシューマーがこのようなキューを使用しようとするときに、このブローカーが、アドレス設定に対応する JMS トピックを自動的に作成するかどうかを決定します。デフォルト値は false です。

auto-create-queues

クライアントがキューに対してメッセージを送信するとき、またはキューからメッセージを消費しようとするときにキューを自動的に作成するかどうか。デフォルト値は true です。

auto-delete-addresses

ブローカーにキューがなくなったときに自動作成されたアドレスを削除するかどうか。デフォルト値は true です。

auto-delete-jms-queues

非推奨: 代わりに auto-delete-queues を使用してください。自動作成された JMS キューにコンシューマーもメッセージもない場合は、AMQ Broker が自動的に削除するかどうかを決定します。デフォルト値は false です。

auto-delete-jms-topics

非推奨: 代わりに auto-delete-queues を使用してください。自動作成された JMS トピックにコンシューマーもメッセージもない場合は、AMQ Broker が自動的に削除するかどうかを決定します。デフォルト値は false です。

auto-delete-queues

キューにコンシューマーがなく、メッセージがない場合に自動作成されたキューを削除するかどうか。デフォルト値は true です。

config-delete-addresses

設定ファイルを再読み込みすると、この設定で、設定ファイルから削除されたアドレス (とそのキュー) を処理する方法を指定します。以下の値を指定できます。

OFF ( デフォルト )
設定ファイルを再読み込みすると、アドレスは削除されません。
FORCE
設定ファイルが再ロードされると、アドレスとそのキューが削除されます。キューにメッセージがある場合は、それらも削除されます。

config-delete-queues

設定ファイルを再読み込みすると、この設定は、設定ファイルから削除されたキューを処理する方法を指定します。以下の値を指定できます。

OFF ( デフォルト )
設定ファイルを再読み込みすると、キューは削除されません。
FORCE
キューは、設定ファイルが再ロードされると削除されます。キューにメッセージがある場合は、それらも削除されます。

dead-letter-address

ブローカーがデッドメッセージを送信するアドレス。

dead-letter-queue-prefix

ブローカーにより、自動作成されたデッドレターキューの名前に適用される接頭辞。デフォルト値は DLQ です。

dead-letter-queue-suffix

ブローカーにより、自動作成されたデッドレターキューに適用される接尾辞。デフォルト値は定義されていません (つまり、ブローカーは接尾辞を適用しません)。

default-address-routing-type

自動作成されたアドレスで使用されるルーティングタイプ。デフォルト値は MULTICAST です。

default-max-consumers

このキューで一度に許可されるコンシューマーの最大数。デフォルト値は 200 です。

default-purge-on-no-consumers

コンシューマーがない場合にキューの内容をパージするかどうか。デフォルト値は false です。

default-queue-routing-type

自動作成されたキューで使用されるルーティングタイプ。デフォルト値は MULTICAST です。

enable-metrics

Prometheus プラグインなどの設定されたメトリクスプラグインが一致するアドレスまたはアドレスのセットのメトリクスを収集するかどうかを指定します。デフォルト値は true です。

expiry-address

期限切れのメッセージを受信するアドレス。

expiry-delay

デフォルトの有効期限を使用してメッセージに使用される有効期限 (ミリ秒単位) を定義します。デフォルト値は -1 で、有効期限がないことを意味します。

last-value-queue

キューが最後の値のみを使用するかどうかを指定します。デフォルト値は false です。

management-browse-page-size

管理リソースが参照できるメッセージの数を指定します。デフォルト値は 200 です。

max-delivery-attempts

デッドレターアドレスに送信する前にメッセージの配信を試行する回数。デフォルトは 10 です。

max-redelivery-delay

再配信遅延の最大値 (ミリ秒単位)。

max-size-bytes

このアドレスの最大メモリーサイズ ( バイト単位 )。address-full-policyPAGINGBLOCK、または FAIL の場合、この値は "K"、"Mb"、および "GB" などのバイト表記で指定されます。デフォルト値は -1 で、無限のバイトを示します。このパラメーターは、特定のアドレス領域によって消費されるメモリー量を制限してブローカーメモリーを保護するために使用されます。この設定は、現在ブローカーアドレス空間に保存されているクライアントによって送信されるバイトの合計量を表しません。これは、ブローカーのメモリー使用率の推定値です。この値は、ランタイムの状態と特定のワークロードによって異なります。アドレス空間ごとに使用できる最大メモリー容量を割り当てることが推奨されます。通常のワークロードでは、ブローカーはメモリーの未処理のメッセージのペイロードサイズの約 150% から 200% が必要になります。

max-size-bytes-reject-threshold

address-full-policyBLOCK の場合に使用されます。ブローカーがメッセージを拒否する前にアドレスが到達できる最大サイズ (バイト単位)。AMQP プロトコルの場合のみ max-size-bytes と組み合わせて動作します。デフォルト値は -1 で、制限なしを意味します。

message-counter-history-day-limit

このアドレスのメッセージカウンター履歴を保持する日数。デフォルト値は 0 です。

page-max-cache-size

ページングナビゲーション中に I/O を最適化するためにメモリー内に保持するページファイルの数。デフォルト値は 5 です。

page-size-bytes

ページングサイズ (バイト単位)。KMbGB などのバイト表記にも対応します。デフォルト値は 10485760 バイト ( 約 10.5 MB) です。

redelivery-delay

キャンセルされたメッセージを再配信するまでの待機時間 ( ミリ秒単位 )。デフォルト値は 0 です。

redelivery-delay-multiplier

redelivery-delay パラメーターに適用する乗数。デフォルト値は 1.0 です。

redistribution-delay

キューの最後のコンシューマーが閉じられてから残りのメッセージを再分配するまでブローカーが待機する時間 (ミリ秒単位) を定義します。デフォルト値は -1 です。

send-to-dla-on-no-route

true に設定すると、キューにルーティングされないメッセージは、設定済みのデッドレターアドレスアドレスに送信されます。デフォルト値は false です。

slow-consumer-check-period

低速なコンシューマーについてチェックする頻度 (秒単位)。デフォルト値は 5 です。

slow-consumer-policy

低速なコンシューマーが特定されたときにどうするのかを決定します。有効なオプションは KILL または NOTIFY です。KILL はコンシューマーの接続を強制終了します。これは、同じ接続を使用するすべてのクライアントスレッドに影響を与えます。NOTIFYCONSUMER_SLOW 管理通知をクライアントに送信します。デフォルト値は NOTIFY です。

slow-consumer-threshold

最小限許可されるメッセージ消費率。この値を下回るとコンシューマーは遅いと見なされます。1 秒あたりのメッセージで測定されます。デフォルト値は -1 で、バインドされません。