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 サポートにお問い合わせください。

次のステップ