Message Processor のヒープメモリ サイズを構成する

ここに表示されているのは Apigee Edge のドキュメントです。
Go to the Apigee X のドキュメントに移動します
info

Apigee Edge の Message Processor は Java ベースのコンポーネントで、デフォルトのヒープメモリ サイズは 512 MB です。ただし、Apigee Edge のすべてのユースケースでデフォルトのヒープメモリサイズが十分であるとは限りません。トラフィック要件や処理要件に応じて、またはメモリ関連の問題に対処するために、Message Processor のヒープメモリ サイズを調整する必要がある場合があります。

Java アプリケーションのヒープメモリ サイズは、Java コマンドライン パラメータ -Xms(最小ヒープサイズ)と -Xmx(最大ヒープサイズ)で制御されます。Apigee Edge Message Processor では、これらのパラメータはbin_setenv_min_membin_setenv_max_mem で制御されます。これらのプロパティの詳細については、 Java メモリ設定の変更をご覧ください。

このドキュメントでは、Apigee Edge の Message Processor でヒープメモリ サイズを構成する方法について説明します。

始める前に

Message Processor のヒープメモリ サイズを変更する

このセクションでは、Message Processor のヒープメモリ サイズを変更する方法について説明します。最小ヒープメモリと 最大ヒープメモリは、Message Processor コンポーネントの bin_setenv_min_mem および bin_setenv_max_mem プロパティを使用して構成できます。

Message Processor のヒープメモリ サイズを変更する手順は次のとおりです。

  1. Message Processor マシンのエディタで /opt/apigee/customer/application/message-processor.properties ファイルを開きます。ファイルが存在しない場合は、作成します。 次に例を示します。
    vi /opt/apigee/customer/application/message-processor.properties
  2. このファイルに次の行を追加します。
    bin_setenv_min_mem=minimum_heap_in_megabytes
    bin_setenv_max_mem=maximum_heap_in_megabytes

    たとえば、Message Processor の最小ヒープと最大ヒープをそれぞれ 1 GB と 2 GB に変更する場合は、このファイルに次の行を追加します。

    bin_setenv_min_mem=1024m
    bin_setenv_max_mem=2048m
  3. 変更を保存します。
  4. このプロパティ ファイルが apigee ユーザーによって所有されていることを確認します。次に例を示します。
    chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
  5. 次のコマンドを使用して Message Processor を再起動します。
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
  6. 複数の Message Processor がある場合は、すべての Message Processor で上記の手順を繰り返します。

Message Processor のヒープメモリ サイズを確認する

このセクションでは、Message Processor でヒープメモリの変更が正常に変更されたかどうかを確認する方法について説明します。 Message Processor でヒープメモリの変更が正常に変更されたかどうかを確認する方法について説明します。

Message Processor のヒープメモリ サイズを変更するには bin_setenv_min_mem プロパティと bin_setenv_max_mem プロパティを使用しましたが、実際の Java コマンドライン パラメータ -Xms-Xmx が次のように新しい値で設定されていることを確認する必要があります。

  1. 次のコマンドを使用して、Message Processor のコマンドライン パラメータ -Xms-Xmx が新しい値で設定されているかどうかを確認します。
    ps -ef | grep message-processor | egrep -o 'Xms[0-9a-z]+|Xmx[0-9a-z]+' | tr '\r' ' '
  2. Message Processor で最小ヒープメモリと最大ヒープメモリが変更されている場合、上記のコマンドを実行すると、-Xms-Xmx に新しい値が表示されます。

    Message Processor の最小ヒープと最大ヒープを変更した後の、上記のコマンドの出力例は次のとおりです。

    Xms1024m
    Xmx2048m

    出力例では、最小ヒープと最大ヒープの新しい値が設定されていることに注意してください。

  3. -Xms-Xmx の古い値が表示される場合は、 Message Processor のヒープメモリ サイズを変更するで説明されている手順をすべて正しく実行したことを確認してください。 手順が抜けている場合は、すべての手順をもう一度正しく繰り返します。
  4. それでもヒープメモリを変更できない場合は、Apigee Edge サポートにお問い合わせください。

次のステップ