現在、Apigee Edge のドキュメントを表示しています。
Apigee X のドキュメントをご確認ください。 情報
このドキュメントでは、Apigee Edge の Message Processor で文字列の重複除去を有効にする方法について説明します。
文字列の重複除去は、Java アプリケーションで重複する String オブジェクトが占有するメモリを節約できる Java 機能です。重複または同一の String 値が同じ文字配列を共有することにより、Java ヒープメモリ内の String オブジェクトのメモリ使用量を削減できます。
Apigee Edge Message Processor は Java ベースのコンポーネントです。Message Processor で文字列の重複除去を使用すると、特に API プロキシが文字列を大量に使用する場合に、メモリ使用量を減らして API プロキシのパフォーマンスを向上させることができます。
文字列重複除去機能は、Java アプリケーションの G1 ガベージ コレクタ（G1GC）でのみ使用できます。Message Processor でこの機能を有効にするには、G1GC を有効にしているか、Message Processor で G1GC と文字列の重複除去の両方を有効にする必要があります。
始める前に
- G1GC についてよく知らない場合は、 G1 ガベージ コレクタのスタートガイドをご覧ください。
- 文字列の重複除去について詳しくは、 G1 ガベージ コレクタの文字列重複除去をご覧ください。
- Edge Message Processor で G1GC を有効にする方法については、 Message Processor で G1GC を有効にするをご覧ください。
- Private Cloud での Edge の構成方法に詳しくない場合は、Edge の構成方法をご覧ください。
Message Processor で文字列の重複除去を有効にする
このセクションでは、Edge Message Processor で文字列の重複除去機能を有効にする方法について説明します。文字列の重複除去を有効にするには、Message Processor コンポーネントのプロパティ useStringDeduplication を使用します。Message Processor ではデフォルトで、このプロパティが false に設定されています。Message Processor のプロパティを構成するには、Edge の構成方法で説明されている構文に従ってトークンを使用します。
Message Processor で文字列の重複除去を有効にするには、次の操作を行います。
useStringDeduplicate プロパティのトークンを見つける
useStringDeduplicate のトークンを見つける手順は次のとおりです。
-
次のコマンドを使用して、Message Processor のソース ディレクトリ
/opt/apigee/edge-message-processor/sourceでuseStringDeduplicationプロパティを検索します。grep -ri "useStringDeduplication" /opt/apigee/edge-message-processor/source
-
このコマンドの出力には、Message Processor のプロパティ
useStringDeduplicationのトークンが次のように表示されます。/opt/apigee/edge-message-processor/source/conf/system.properties:useStringDeduplication={T}conf_system_useStringDeduplication{/T}{T}{/T}タグ内の文字列は、Message Processor の.propertiesファイルで設定できるトークンの名前です。したがって、プロパティuseStringDeduplicationのトークンは次のようになります。conf_system_useStringDeduplication
Message Processor で文字列の重複除去を有効にする
Apigee Message Processor で文字列の重複除去を有効にする手順は次のとおりです。
-
Message Processor マシンの
/opt/apigee/customer/application/message-processor.propertiesファイルをエディタで開きます。ファイルがまだ存在しない場合は作成します。次に例を示します。vi /opt/apigee/customer/application/message-processor.properties
-
このファイルに次の行を追加します。
conf_system_useStringDeduplication=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 で文字列の重複除去を確認する
このセクションでは、Message Processor で文字列の重複除去が有効になっていることを確認する方法について説明します。
conf_system_useStringDeduplication トークンを使用して Message Processor で文字列の重複除去を有効にした場合でも、実際のプロパティ useStringDeduplication が次のように新しい値に設定されていることを確認する必要があります。
-
/opt/apigee/edge-message-processor/confディレクトリでプロパティuseStringDeduplicationを検索し、新しい値が設定されていることを確認します。次に例を示します。grep -ri "useStringDeduplication" /opt/apigee/edge-message-processor/conf
-
Message Processor で文字列の重複除去が有効になっていると、上記のコマンドにより
system.propertiesファイルに新しい値が表示されます。Message Processor で文字列の重複除去を有効にした後のコマンドのサンプル結果は次のとおりです。
/opt/apigee/edge-message-processor/conf/system.properties:useStringDeduplication=true
この出力例では、プロパティ
useStringDeduplicationにsystem.propertiesの新しい値trueが設定されています。これは、Message Processor で文字列の重複除去が有効になっていることを示します。 -
プロパティ
useStringDeduplicationに古い値が引き続き表示される場合は、Message Processor で文字列の重複除去を有効にするで説明されているすべての手順が正しく行われていることを確認します。ステップを見逃した場合は、すべてのステップをもう一度正しくやり直します。 - それでも文字列重複除去を有効にできない場合は、Apigee サポートにお問い合わせください。