ここに表示されているのは Apigee Edge のドキュメントです。
Go to the
Apigee X のドキュメントに移動します。 info
このドキュメントでは、Apigee Edge の Message Processor で Garbage First Garbage Collector（G1GC）を有効にする方法について説明します。
Apigee Edge の Message Processor は Java 仮想マシン（JVM）で実行され、ハードウェアとオペレーティング システムの構成に応じて、デフォルトのガベージ コレクタ（シリアルまたは並列）を使用します。 状況によっては、ニーズに応じて Message Processor で使用するガベージ コレクタ のタイプを変更することが必要になる場合があります。
G1GC は、Java HotSpot VM 用の低一時停止のサーバー スタイルの世代別ガベージ コレクタで、 Message Processor の全体的なパフォーマンスを向上させます。通常、全体的なスループットよりもレスポンス時間が重要な中規模から大規模のデータセットを使用するアプリケーション向けに設計されています。たとえば、ヒープサイズが大きい （3 GB 超）場合は、G1GC の使用を検討できます。
通常は、G1GC とともに別の JVM パラメータ UseStringDeduplicationalong
を設定することをおすすめします。このパラメータは、重複する文字列値または同一の文字列値が同じ文字配列を共有するようにすることで、Java ヒープメモリの使用量を最適化します。
始める前に
- Java のガベージ コレクションとさまざまなタイプのガベージ コレクタについて理解を深めるには、Java ガベージ コレクションの基本をご覧ください。
- G1GC に慣れていない場合は、 G1 ガベージ コレクタのスタートガイドをご覧ください。
- Private Cloud 上の Edge のプロパティの構成に慣れていない場合は、 Edge を構成する方法をご覧ください。
Message Processor で G1GC を有効にする
このセクションでは、Edge Message Processor で G1GC を有効にする方法について説明します。G1GC は、Message Processor コンポーネントのプロパティ useG1GC を使用して有効にできます
。デフォルトでは、この
プロパティは Message Processor で false に設定されています。Message Processor のプロパティを構成するには、Edge を構成する方法で説明されている構文に従ってトークンを使用します。
Message Processor で G1GC を有効にするには、次の操作を行います。
useG1GC プロパティのトークンを見つける
次の手順では、useG1GC プロパティのトークンを見つける方法について説明します。
- 次のコマンドを使用して、Message Processor のソース ディレクトリ
/opt/apigee/edge-message-processor/sourceでuseG1GCプロパティを検索します:grep -ri "useG1GC" /opt/apigee/edge-message-processor/source
-
このコマンドの出力には、Message Processor のプロパティ
useG1GCのトークンが次のように表示されます:/opt/apigee/edge-message-processor/source/conf/system.properties:useG1GC={T}conf_system_useG1GC{/T}{T}{/T}タグの間の文字列は、Message Processor の.propertiesファイルで設定できるトークンの名前です。したがって、プロパティuseG1GCのトークンは次のようになります。conf_system_useG1GC
Message Processor で G1GC を有効にする
次の手順では、Apigee Message Processor で G1GC を有効にする方法について説明します。
-
Message Processor マシンの
/opt/apigee/customer/application/message-processor.propertiesファイル をエディタで開きます。ファイルが存在しない場合は 作成します。次に例を示します。vi /opt/apigee/customer/application/message-processor.properties
-
このファイルに次の行を追加します。
conf_system_useG1GC=true
- 変更内容を保存します。
-
このプロパティ ファイルが
apigeeユーザーによって所有されていることを確認します。次に例を示します。chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
-
次のコマンドを使用して Message Processor を再起動します。
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
- 複数の Message Processor がある場合は、すべての Message Processor でこれらの手順を繰り返します。
Message Processor で G1GC の構成を確認する
このセクションでは、Message Processor で G1GC の構成が正常に変更されたことを確認する方法について説明します。 Message Processor で。
Message
Processor で G1GC を有効にするにはトークン conf_system_useG1GC を使用しますが、実際のプロパティ useG1GC が次の新しい値に設定されていることを確認する必要があります。
-
/opt/apigee/edge-message-processor/confディレクトリでプロパティuseG1GCを検索し、新しい値が設定されていることを確認します。次に例を示します。grep -ri "useG1GC" /opt/apigee/edge-message-processor/conf
-
Message Processor で G1GC が正常に有効になっている場合、前のコマンドを実行すると、
system.propertiesファイルに新しい値が表示されます。Message Processor で G1GC を有効にした後の、前のコマンドの出力例は次のとおりです。
/opt/apigee/edge-message-processor/conf/system.properties:useG1GC=true
出力例では、プロパティ
useG1GCがsystem.propertiesで新しい値trueに設定されています。これは、Message Processor で G1GC が正常に有効になっていることを示します。 -
プロパティ
useG1GCの古い値が表示される場合は、 Message Processor で G1GC を有効にするで説明されているすべての手順を正しく実行していることを確認してください。手順が抜けている場合は、 すべての手順をもう一度正しく繰り返します。 - G1GC を有効にできない場合は、Apigee Edge サポートにお問い合わせください。