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

Apigee Edge のドキュメントを表示しています。
Apigee X のドキュメントをご確認ください
情報

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

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

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

始める前に

  • Edge for Private Cloud でのプロパティの構成に慣れていない場合は、Edge の構成方法をご覧ください。
  • デフォルトと推奨の Java メモリ設定については、 Java メモリ設定の変更をご覧ください。

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

このセクションでは、Message Processor のヒープメモリ サイズを変更する方法について説明します。ヒープメモリの最小と最大は、Message Processor コンポーネントのプロパティ bin_setenv_min_membin_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 で正常に変更されているかどうかを確認する方法について説明します。

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

  1. 次のコマンドを使用して、コマンドライン パラメータ -Xms-Xmx に Message Processor の新しい値が設定されているかどうかを確認します。
    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 サポートにお問い合わせください。

次のステップ