第7章 アドレスのメモリー使用量の設定

手順

1. <broker_instance_dir>/etc/broker.xml 設定ファイルを開きます。

2. core 要素内に paging-directory 要素を追加します。ファイルシステムのページングディレクトリーの場所を指定します。

   <configuration ...>
     <core ...>
       ...
       <paging-directory>/path/to/paging-directory</paging-directory>
       ...
     </core>
   </configuration>

   Copy to Clipboard Toggle word wrap

   その後ページング用に設定するアドレスごとに、ブローカーは指定したページングディレクトリーに専用のディレクトリーを追加します。

手順

1. <broker_instance_dir>/etc/broker.xml 設定ファイルを開きます。

2. 一致するアドレスまたはアドレス セット 用に設定した address-setting 要素の場合は、設定要素を追加して最大メモリー使用量を指定し、ページング動作を定義します。以下に例を示します。

   <address-settings>
       <address-setting match="my.paged.address">
           ...
           <max-size-bytes>104857600</max-size-bytes>
           <max-size-messages>20000</max-size-messages>
           <page-size-bytes>10485760</page-size-bytes>
           <address-full-policy>PAGE</address-full-policy>
           ...
       </address-setting>
   </address-settings>

   Copy to Clipboard Toggle word wrap

   max-size-bytes

   ブローカーが address-full-policy 属性に指定されたアクションを実行する前に、アドレスに許可されるメモリーの最大サイズ (バイト単位)。デフォルト値は -1 で、制限がないことを意味します。指定する値は、"K"、"MB"、および "GB" などのバイト表記もサポートします。

   max-size-messages

   ブローカーが address-full-policy 属性に指定されたアクションを実行する前に、アドレスに許可されるメッセージの最大数。デフォルト値は -1 で、メッセージ制限がないことを意味します。

   page-size-bytes

   ページングシステムで使用される各ページファイルのサイズ ( バイト単位 )。デフォルト値は 10485760 ( つまり 10 MiB ) です。指定する値は、"K"、"MB"、および "GB" などのバイト表記もサポートします。

   address-full-policy

   アドレスの最大サイズに達したときにブローカーが実行するアクション。デフォルト値は PAGE です。有効な値は以下のとおりです。

   PAGE

   ブローカーは、追加のメッセージをディスクにページングします。

   DROP

   ブローカーは追加のメッセージを通知せずに破棄します。

   FAIL

   ブローカーは、クライアントメッセージプロデューサーに対して追加のメッセージおよび例外をドロップします。

   BLOCK

   追加のメッセージを送信しようとすると、クライアントメッセージプロデューサーがブロックされます。

   max-size-bytes 属性と max-size-message 属性に制限を設定した場合、いずれかの制限に達すると、ブローカーは address-full-policy 属性に指定されたアクションを実行します。前の例の設定では、メモリー内のアドレスのメッセージの合計が 20,000 を超えるか、使用可能なメモリーを 104857600 バイト使用すると、ブローカーは my.paged.address アドレスのメッセージのページングを開始します。

   前述の例に示されて いない 追加のページング設定要素は以下のとおりです。

   page-sync-timeout

   定期的なページ同期の間隔 ( ナノ秒単位 )。非同期 IO ジャーナルを使用している場合 ( つまり、journal-type が broker.xml 設定ファイルで ASYNCIO に設定されている場合 )、デフォルト値は 3333333 です。標準の Java NIO ジャーナルを使用している場合 ( journal-type が NIO に設定されている場合 )、デフォルト値は journal-buffer-timeout パラメーターの設定済みの値です。

手順

1. ブローカーを停止します。

   1. Linux の場合:

      <broker_instance_dir>/bin/artemis stop

      Copy to Clipboard Toggle word wrap

   2. Windows の場合:

      <broker_instance_dir>\bin\artemis-service.exe stop

      Copy to Clipboard Toggle word wrap
2. <broker_instance_dir>/etc/broker.xml 設定ファイルを開きます。

3. core 要素内に global-max-size 要素を追加し、値を指定します。以下に例を示します。

   <configuration>
     <core>
       ...
       <global-max-size>1GB</global-max-size>
       <global-max-messages>900000</global-max-messages>
       ...
     </core>
   </configuration>

   Copy to Clipboard Toggle word wrap

   global-max-size

   ブローカーがすべてのアドレスに使用できるメモリーの合計量 ( バイト単位 )。この制限に達すると、ブローカーは各受信メッセージに関連付けられたアドレスの address-full-policy 属性に指定されたアクションを実行します。global-max-size のデフォルト値は、ブローカーをホストする Java 仮想マシン (JVM) で利用可能な最大メモリーの半分です。

   global-max-size の値はバイト単位ですが、バイト表記にも対応します ( 例 : "K"、"Mb"、"GB")。

   上記の例では、ブローカーはメッセージの処理時に利用可能な最大 1 ギガバイトのメモリーを使用するように設定されています。

   global-max-messages

   すべてのアドレスに許可されるメッセージの合計数。この制限に達すると、ブローカーは各受信メッセージに関連付けられたアドレスの address-full-policy 属性に指定されたアクションを実行します。デフォルト値は -1 で、メッセージ制限がないことを意味します。

   global-max-size 属性と global-max-messages 属性に制限を設定した場合、いずれかの制限に達すると、ブローカーは address-full-policy 属性に指定されたアクションを実行します。前の例の設定では、メモリー内のメッセージ数が 900,000 を超えるか、使用可能なメモリーが 1 GB を使用すると、ブローカはすべてのアドレスに対してメッセージのページングを開始します。

   注記

   max-size-bytes 属性または max-size-message 属性を使用して個々のアドレスに設定された制限が、global-max-size 属性または global-max-messages 属性に設定された制限よりも先に達した場合、ブローカーはそのアドレスの address-full-policy 属性に指定されたアクションを実行します。

4. ブローカーを起動します。

   1. Linux の場合:

      <broker_instance_dir>/bin/artemis run

      Copy to Clipboard Toggle word wrap

   2. Windows の場合:

      <broker_instance_dir>\bin\artemis-service.exe start

      Copy to Clipboard Toggle word wrap

手順

1. ブローカーを停止します。

   1. Linux の場合:

      <broker_instance_dir>/bin/artemis stop

      Copy to Clipboard Toggle word wrap

   2. Windows の場合:

      <broker_instance_dir>\bin\artemis-service.exe stop

      Copy to Clipboard Toggle word wrap
2. <broker_instance_dir>/etc/broker.xml 設定ファイルを開きます。

3. core 要素内に属性を追加して、ディスク使用量またはメッセージ数、あるいはその両方に基づいてページング制限を指定し、いずれかの制限に達した場合に実行するアクションを指定します。以下に例を示します。

   <address-settings>
      <address-setting match="match="my.paged.address"">
       ...
       <page-limit-bytes>10G</page-limit-bytes>
       <page-limit-messages>1000000</page-limit-messages>
       <page-full-policy>FAIL</page-full-policy>
       ...
      </address-setting>
   </address-settings>

   Copy to Clipboard Toggle word wrap

   page-limit-bytes

   ブローカーが page-full-policy 属性に指定されたアクションを実行する前に、アドレスの受信メッセージをページングするために許可されるディスク領域の最大サイズ (バイト単位)。指定する値は、"K"、"MB"、および "GB" などのバイト表記をサポートしています。デフォルト値は -1 で、制限がないことを意味します。

   page-limit-messages

   ブローカーが page-full-policy 属性に指定されたアクションを実行する前に、アドレスに対してページングできる受信メッセージの最大数。デフォルト値は -1 で、メッセージ制限がないことを意味します。

   page-full-policy

   アドレスが page-limit-bytes 属性または page-limit-messages 属性で設定された制限に達したときにブローカーが実行するアクション。有効な値は以下のとおりです。

   DROP ブローカーは、それ以降のメッセージをサイレントにドロップします。

   FAIL ブローカーはそれ以上のメッセージを削除し、送信側クライアントに通知します。

   前述の例では、ページングで 10GB のディスク領域が使用されるか、合計 100 万個のメッセージがページングされるまで、ブローカーは my.paged.address アドレスのメッセージをページングします。

4. ブローカーを起動します。

   1. Linux の場合:

      <broker_instance_dir>/bin/artemis run

      Copy to Clipboard Toggle word wrap

   2. Windows の場合:

      <broker_instance_dir>\bin\artemis-service.exe start

      Copy to Clipboard Toggle word wrap

手順

1. <broker_instance_dir>/etc/broker.xml 設定ファイルを開きます。

2. 一致するアドレスまたはアドレスのセットに対して設定した address-settings 要素については、ページングされたメッセージのメモリーへの転送に対する制限を指定します。以下に例を示します。

   address-settings>
       <address-setting match="my.paged.address">
           ...
           <max-read-page-messages>104857600</max-read-page-messages>
           <max-read-page-bytes>20MB</max-read-page-bytes>
           ...
       </address-setting>
   </address-settings>

   Copy to Clipboard Toggle word wrap

   Max-read-page-messages ブローカーがアドレスごとにディスクからメモリーに読み取ることができるページングメッセージの最大数。デフォルト値は -1 で、制限が適用されないことを意味します。

   Max-read-page-bytes ブローカーがアドレスごとにディスクからメモリーに読み取ることができるページングメッセージの最大サイズ (バイト単位)。デフォルト値は 20 MB です。

   これらの制限を適用すると、ブローカーは、コンシューマーに配信する準備ができているメモリー内のメッセージと、現在配信中のメッセージの両方をカウントします。コンシューマーがメッセージを確認するのが遅い場合、メッセージを配信すると、メモリーまたはメッセージの制限に達し、ブローカーが新しいメッセージをメモリーに読み込めなくなる可能性があります。その結果、ブローカーでメッセージが不足する可能性があります。

3. コンシューマーがメッセージを確認するのが遅く、現在配信中のメッセージが設定済みの max-read-page-messages または max-read-page-bytes 制限に達する場合は、現在配信中のメッセージのページングされたメッセージをメモリーに転送する際に適用される別の制限を指定します。以下に例を示します。

   address-settings>
       <address-setting match="my.paged.address">
           ...
           <prefetch-page-bytes>20MB</prefetch-page-bytes>
           <prefetch-page-messages>104857600</prefetch-page-messages>
           ...
       </address-setting>
   </address-settings>

   Copy to Clipboard Toggle word wrap

   prefetch-page-bytes ページングされたメッセージをキューごとにメモリーに読み込むために使用できるメモリー (バイト単位)。デフォルト値は 20 MB です。

   prefetch-page-messages ブローカーがキューごとにディスクからメモリーに読み込むことができるページングされたメッセージの数。デフォルト値は -1 で、制限が適用されないことを意味します。

   prefetch-page-bytes または prefetch-page-messages パラメーターの制限を指定して、現在配信中のメッセージで使用されるメモリーの量またはメッセージ数を制限する場合は、max-read-page-bytes または max-read-page-message パラメーターの制限を高く設定して、新しいメッセージをメモリーに読み込むための容量を確保してください。

   注記

   prefetch-page-bytes パラメーターの値よりも前に max-read-page-bytes パラメーターの値に達すると、ブローカーはページングされたメッセージをそれ以上メモリーに読み込まなくなります。

手順

1. ブローカーを停止します。

   1. Linux の場合:

      <broker_instance_dir>/bin/artemis stop

      Copy to Clipboard Toggle word wrap

   2. Windows の場合:

      <broker_instance_dir>\bin\artemis-service.exe stop

      Copy to Clipboard Toggle word wrap
2. <broker_instance_dir>/etc/broker.xml 設定ファイルを開きます。

3. core 要素内に max-disk-usage 設定要素を追加し、値を指定します。以下に例を示します。

   <configuration>
     <core>
       ...
       <max-disk-usage>80</max-disk-usage>
       ...
     </core>
   </configuration>

   Copy to Clipboard Toggle word wrap

   max-disk-usage

   ブローカーが使用できる利用可能なディスク領域の最大パーセンテージ。この制限に達すると、ブローカーは受信メッセージをブロックします。デフォルト値は 90 です。

   前述の例では、ブローカーは利用可能なディスク領域の 80 パーセントの使用に制限されています。

4. ブローカーを起動します。

   1. Linux の場合:

      <broker_instance_dir>/bin/artemis run

      Copy to Clipboard Toggle word wrap

   2. Windows の場合:

      <broker_instance_dir>\bin\artemis-service.exe start

      Copy to Clipboard Toggle word wrap