翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
Amazon MQ 子要素属性
以下は、子要素属性の詳しい説明です。詳細については、Apache ActiveMQ ドキュメントXMLの設定
authorizationEntry
authorizationEntry
は authorizationEntries
子コレクション要素の子です。
属性
管理|読み取り|書き込み
ユーザーのグループに付与されているアクセス許可。詳細については、「認可マップを常に設定する」を参照してください。
activemq-webconsole
グループが含まれない認可マップを指定する場合、Amazon MQ ブローカーにメッセージを送信する権限、またはブローカーからメッセージを受信する権限がグループにないことから、ActiveMQ ウェブコンソールは使用できません。
デフォルト: null
サンプル設定
<authorizationPlugin> <map> <authorizationMap> <authorizationEntries> <authorizationEntry admin="admins,activemq-webconsole" read="admins,users,activemq-webconsole" write="admins,activemq-webconsole" queue=">"/> <authorizationEntry admin="admins,activemq-webconsole" read="admins,users,activemq-webconsole" write="admins,activemq-webconsole" topic=">"/> </authorizationEntries> </authorizationMap> </map> </authorizationPlugin>
注記
Amazon MQ の ActiveMQ のactivemq-webconsole
グループには、すべてのキューとトピックに対する管理者アクセス許可があります。このグループのすべてのユーザーは管理者アクセス権を持ちます。
networkConnector
networkConnector
は networkConnectors
子コレクション要素の子です。
属性
conduitSubscriptions
ブローカーのネットワークのネットワーク接続が、同じ送信先にサブスクライブしている複数のコンシューマーを 1 つのコンシューマーとして扱うかどうかを指定します。たとえば、conduitSubscriptions
が true
に設定されていて、2 つのコンシューマーがブローカー B に接続して送信先から消費する場合、ブローカー B は、ブローカー A へのネットワーク接続を介してサブスクリプションを単一の論理サブスクリプションに結合するので、メッセージの単一コピーのみがブローカー A からブローカー B に転送されます。
注記
conduitSubscriptions
を true
に設定すると、冗長なネットワークトラフィックを減らすことができます。ただし、この属性を使用すると、コンシューマー間のメッセージのロードバランシングに影響し、特定のシナリオ (JMSメッセージセレクタや耐久性のあるトピックなど) で誤った動作が発生する可能性があります。
デフォルト: true
二重
ブローカーのネットワーク内の接続を使用し、またメッセージを生成するかどうかを指定します。ブ たとえば、ブローカー A が非二重モードでブローカー B への接続を作成した場合、メッセージはブローカー A からブローカー B にのみ転送できます。ただし、ブローカー A がブローカー B への二重接続を作成した場合、ブローカー B は <networkConnector>
を設定しなくてもメッセージをブローカー A に転送できます。
デフォルト: false
name
ブローカーのネットワークのブリッジの名前。
デフォルト: bridge
uri
ブローカーのネットワークの 2 つのブローカーのうちの 1 つ (または複数のブローカー) のワイヤレベルプロトコルエンドポイント。
デフォルト: null
username
ブローカーのネットワークのブローカーに共通のユーザー名。
デフォルト: null
設定例
注記
networkConnector
を使用してブローカーのネットワークを定義するときは、ブローカーに共通のユーザーのパスワードを含めないでください。
2 つのブローカーとブローカーのネットワーク
この設定では、2 つのブローカーがブローカーのネットワークで接続されています。ネットワークコネクタの名前は connector_1_to_2
で、ブローカーに共通するユーザー名は myCommonUser
で、接続は duplex
で、 OpenWire エンドポイントURIには のプレフィックスが付けられstatic:
、ブローカー間の one-to-one 接続を示します。
<networkConnectors> <networkConnector name="connector_1_to_2" userName="myCommonUser" duplex="true" uri="static:(ssl://b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9-1.mq.us-east-2.amazonaws.com:61617)"/> </networkConnectors>
詳細については、「Configure Network Connectors for Your Broker」を参照してください。
複数のブローカーのあるブローカーのネットワーク
この設定では、複数のブローカーがブローカーのネットワークで接続されています。ネットワークコネクタの名前は connector_1_to_2
、ブローカーに共通するユーザー名は myCommonUser
、接続は duplex
、エンドポイントの OpenWireカンマ区切りリストURIsには のプレフィックスが付けられmasterslave:
、ブローカー間のフェイルオーバー接続を示します。ブローカーからブローカーへのフェイルオーバーはランダム化されず、再接続の試行は無期限に続きます。
<networkConnectors> <networkConnector name="connector_1_to_2" userName="myCommonUser" duplex="true" uri="masterslave:(ssl://b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9-1.mq.us-east-2.amazonaws.com:61617, ssl://b-9876l5k4-32ji-109h-8gfe-7d65c4b132a1-2.mq.us-east-2.amazonaws.com:61617)"/> </networkConnectors>
注記
ブローカーのネットワークの masterslave:
プレフィックスを使用することをお勧めします。プレフィックスはより明示的な static:failover:()?randomize=false&maxReconnectAttempts=0
構文と完全に一致します。
注記
XML この設定ではスペースを許可しません。
kahaDB
kahaDB
は persistenceAdapter
子コレクション要素の子です。
属性
concurrentStoreAndDispatchQueues
キューの同時保存とディスパッチを使用するかどうかを指定します。詳細については、「低速コンシューマーのキューに対して同時保存とディスパッチを無効にする」を参照してください。
デフォルト: true
cleanupOnStop
以下でサポート
Apache ActiveMQ 15.16.x 以上
無効にされていると、ブローカーが停止されたときにガベージコレクションおよびクリーンアップが実行されず、シャットダウンプロセスの速度が上がります。高速化は、大規模なデータベースやスケジューラデータベースの場合に有用です。
デフォルト: true
journalDiskSync間隔
journalDiskSyncStrategy=periodic
の場合にディスク同期を実行する間隔 (ミリ秒)。詳細については、Apache ActiveMQ kahaDB のドキュメント
デフォルト: 1000
journalDiskSync戦略
以下でサポート
Apache ActiveMQ 15.14.x 以上
ディスク同期ポリシーを設定します。詳細については、Apache ActiveMQ kahaDB のドキュメント
デフォルト: always
注記
ActiveMQ のドキュメントjournalDiskSyncInterval
の長さに制限されており、デフォルトは 1 秒です。厳密には言えませんが、データ損失はこの間隔よりも長くなる可能性があります。注意してください。
preallocationStrategy
新しいジャーナルファイルが必要になったときにブローカーがジャーナルファイルの事前割り当てを試みる方法を設定します。詳細については、Apache ActiveMQ kahaDB のドキュメント
デフォルト: sparse_file
サンプル設定
<broker xmlns="http://activemq.apache.org/schema/core"> <persistenceAdapter> <kahaDB preallocationStrategy="zeros" concurrentStoreAndDispatchQueues="false" journalDiskSyncInterval="10000" journalDiskSyncStrategy="periodic"/> </persistenceAdapter> </broker>
systemUsage
systemUsage
は systemUsage
子コレクション要素の子です。プロデューサーの速度を遅くするまでにブローカーが使用する領域の最大量を制御します。詳細については、Apache ActiveMQ のドキュメントの Producer Flow Control
子要素
memoryUsage
memoryUsage
は systemUsage
子要素の子です。メモリ使用量を管理します。本番稼働での作業セットの使用を制御できるように、memoryUsage
を使用してメモリ使用量を追跡します。詳細については、Apache ActiveMQ のドキュメントの schema
子要素
memoryUsage
は memoryUsage
子要素の子です。
属性
percentOfJvmヒープ
0 ~ 70 の整数。
デフォルト: 70
属性
sendFailIfNoSpace
空き領域がない場合に send()
メソッドが失敗するかどうかを設定します。デフォルト値は false で、領域が空くまで send()
メソッドをブロックします。詳細については、Apache Active MQ のドキュメントの schema
デフォルト: false
sendFailIfNoSpaceAfterTimeout
デフォルト: null
サンプル設定
<broker xmlns="http://activemq.apache.org/schema/core"> <systemUsage> <systemUsage sendFailIfNoSpace="true" sendFailIfNoSpaceAfterTimeout="2000"> <memoryUsage> <memoryUsage percentOfJvmHeap="60" /> </memoryUsage>> </systemUsage> </systemUsage> </broker> </persistenceAdapter>