第7章 アドレスのメモリー制限の設定

手順

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

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

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

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

手順

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>

   max-size-bytes

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

   重要

   max-size-bytes の値は 100 MB 以下に設定することを強く推奨します。この制限は、ブローカーがメッセージのページングを開始する前に、メモリー内のオブジェクトの数がブローカーの通常の操作に影響を与えないようにするためのものです。

   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 パラメーターの設定済みの値です。

   上記の例では、アドレス my.paged.address に送信されたメッセージがメモリー内で 104857600 バイトを超えると、ブローカーがメッセージのページングを開始します。

   注記

   address-setting 要素で max-size-bytes を指定すると、一致する 各 アドレスに値が適用されます。この値を指定すると、一致するすべてのアドレスの 合計 サイズが max-size-bytes の値に制限されるわけでは ありません。

手順

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

   1. Linux の場合:

      <broker_instance_dir>/bin/artemis stop

   2. Windows の場合:

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

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

3. メモリー使用量に基づいてグローバルページング制限を指定する場合は、ブローカー JVM で使用可能な最大メモリーのパーセンテージまたは絶対値を指定できます。パーセンテージの値を指定すると、JVM メモリーの量が変わっても値を変更せずに済みます。

   1. JVM で使用可能な最大メモリーのパーセンテージでグローバルページング制限を指定するには、core 要素内に global-max-size-percent-of-jvm-max-memory 要素を追加し、値を指定します。次の例では、メモリー使用量が JVM で使用可能な最大メモリーの 60% に達すると、ブローカーがすべてのアドレスに対するメッセージのページングを開始します。

      <configuration>
        <core>
          ...
          <global-max-size-percent-of-jvm-max-memory>60</global-max-size-percent-of-jvm-max-memory>
          ...
        </core>
      </configuration>

   2. グローバルページング制限を絶対値で指定するには、core 要素内に global-max-size 要素を追加し、値を指定します。次の例では、メモリー使用量が 1 GB に達すると、ブローカーがすべてのアドレスに対するメッセージのページングを開始します。

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

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

4. メッセージの合計数に基づいてグローバル制限を指定する場合は、core 要素内に global-max-messages 要素を追加し、値を指定します。次の例では、メモリー内のメッセージ数が 900,000 に達すると、ブローカーがすべてのアドレスに対するメッセージのページングを開始します。

   <configuration>
     <core>
       ...
       <global-max-messages>900000</global-max-messages>
       ...
     </core>
   </configuration>

   デフォルト値は -1 です。これはメッセージの上限がないことを意味します。

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

   1. Linux の場合:

      <broker_instance_dir>/bin/artemis run

   2. Windows の場合:

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

手順

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

   1. Linux の場合:

      <broker_instance_dir>/bin/artemis stop

   2. Windows の場合:

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

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>

   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

   2. Windows の場合:

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

手順

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>

   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>

   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

   2. Windows の場合:

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

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

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

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

   max-disk-usage

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

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

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

   1. Linux の場合:

      <broker_instance_dir>/bin/artemis run

   2. Windows の場合:

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