Message Processor の keep-alive タイムアウトを構成する

<ph type="x-smartling-placeholder"></ph> 現在、Apigee Edge のドキュメントが表示されています。
Apigee X のドキュメント。 詳細

<ph type="x-smartling-placeholder">

このドキュメントでは、Apigee Edge のキープアライブ タイムアウトを構成する方法について説明します。 Message Processor です。

Message Processor のキープアライブ タイムアウトを使用すると、単一の TCP 接続で バックエンド サーバーとの間で複数の HTTP リクエスト / レスポンスを受信できるため、 すべてのリクエスト/レスポンスペアの 接続を提供します

Message Processor のキープアライブ タイムアウト プロパティのデフォルト値は、 60 秒。このタイムアウト時間は、構成されているバックエンド サーバーに適用されます。 ターゲット エンドポイントの構成と、ServiceCallout ポリシーで API プロキシ。

Message Processor のキープアライブ タイムアウトは、デフォルト値から増減できます 60 秒に変更できます。次のように構成できます。

• API プロキシの場合 <ph type="x-smartling-placeholder">
  </ph>
  • ターゲット エンドポイント
  • ServiceCallout ポリシー内
• Message Processor

次のプロパティは、Message Processor のキープアライブ タイムアウトを制御します。

プロパティ名	場所	説明
keepalive.timeout.millis	API プロキシ: <ph type="x-smartling-placeholder"> </ph> ターゲット エンドポイント ServiceCalloutのポリシー	Message Processor で 1 つの TCP ポートが許可される最大アイドル時間 新しい HTTP リクエスト / レスポンスを開く代わりに、複数の HTTP リクエスト / レスポンスを送受信する すべてのリクエスト/レスポンスペアの 接続を提供します デフォルトでは、このプロパティは Message Processor の HTTPClient.keepalive.timeout.millis プロパティ。ここで、 デフォルト値は 60 秒です。 このプロパティが、 ターゲット エンドポイントまたは特定の API プロキシの ServiceCallout ポリシー その特定のターゲット サーバーのキープアライブ時間のみが影響を受けます。
HTTPClient.keepalive.timeout.millis	Message Processor	Message Processor で 1 つの TCP ポートが許可される最大アイドル時間 使用して複数の HTTP リクエスト/レスポンスを送受信できます。 新しい接続が必要です。 このプロパティは、この Message Processor で実行されるすべての API プロキシで使用されます。 このプロパティのデフォルト値は 60 秒です。 このプロパティは、 Message Processor のキープアライブ タイムアウトの構成 または、API プロキシレベルで keepalive.timeout.millis プロパティを設定してこの値を上書きすることもできます。

始める前に

このドキュメントの手順を使用する前に、次のトピックを理解しておいてください。

• キープアライブ タイムアウトについてよく理解していない場合は、keepalive.timeout.millis をご覧ください。 宿泊施設の説明 <ph type="x-smartling-placeholder"></ph> TargetEndpoint トランスポート プロパティの仕様。
• プライベート クラウド上の Edge のプロパティの構成についてよく理解していない場合は、 <ph type="x-smartling-placeholder"></ph> Edge の構成方法をご覧ください。

で確認できます。

API プロキシでのキープアライブ タイムアウトの構成

キープアライブ タイムアウトは、API プロキシの次の場所で構成できます。

• ターゲット エンドポイント
• ServiceCalloutのポリシー

API プロキシのターゲット エンドポイントでのキープアライブ タイムアウトの構成

このセクションでは、Cloud Storage のターゲット エンドポイントでキープアライブ タイムアウトを構成する方法について説明します。 API プロキシ。キープアライブ タイムアウトはプロパティで構成できます keepalive.timeout.millis: キープアライブ タイムアウト値を表します。 ミリ秒単位です。

で確認できます。 <ph type="x-smartling-placeholder">

1. Edge UI で、新しい API プロキシを構成する特定の API プロキシを選択します。 キープアライブ タイムアウト値。
2. 変更する特定のターゲット エンドポイントを選択します。

3. 適切な値を持つプロパティ keepalive.timeout.millis を TargetEndpoint 構成の <HTTPTargetConnection> 要素。

   たとえば、キープアライブ タイムアウトを 30 秒に変更するには、 次のコードブロックを実行します。

   <Properties>
     <Property name="keepalive.timeout.millis">30000</Property>
   </Properties>

   keepalive.timeout.millis プロパティはミリ秒単位であるため、 30 秒は 30000 です。

   次の例は、ターゲット エンドポイントでキープアライブ タイムアウトを構成する方法を示しています。 API プロキシの構成:

   バックエンド サーバーの URL を使用したターゲット エンドポイントの構成例

   <TargetEndpoint name="default">
     <HTTPTargetConnection>
       <URL>https://mocktarget.apigee.net/json</URL>
       <Properties>
         <Property name="keepalive.timeout.millis">30000</Property>
       </Properties>
     </HTTPTargetConnection>
   </TargetEndpoint>

   ターゲット サーバーを使用したターゲット エンドポイントの構成例

   <TargetEndpoint name="default">
     <HTTPTargetConnection>
       <LoadBalancer>
         <Server name="target1" />
         <Server name="target2" />
       </LoadBalancer>
       <Properties>
         <Property name="keepalive.timeout.millis">30000</Property>
       </Properties>
       <Path>/test</Path>
     </HTTPTargetConnection>
   </TargetEndpoint>

   <ph type="x-smartling-placeholder">
4. API プロキシに加えた変更を保存します。

API プロキシの ServiceCallout ポリシーでキープアライブ タイムアウトを構成する

このセクションでは、Google Cloud コンソールでキープアライブ タイムアウトを構成する方法について説明します。 API プロキシの ServiceCallout ポリシー。キープアライブ タイムアウトは、 the keepalive.timeout.millis プロパティを使用して構成します。 キープアライブ タイムアウト値（ミリ秒単位）。

<ph type="x-smartling-placeholder">で確認できます。 <ph type="x-smartling-placeholder">

ServiceCallout ポリシーでキープアライブ タイムアウトを構成するには、 keepalive.timeout.millis プロパティ:

1. Edge UI で、新しい API プロキシを構成する特定の API プロキシを選択します。 ServiceCallout ポリシーのキープアライブ タイムアウト値。
2. 変更する ServiceCallout ポリシーを選択します。
3. 適切な値を持つプロパティ keepalive.timeout.millis を TargetEndpoint 構成の <HTTPTargetConnection> 要素。

   たとえば、キープアライブ タイムアウトを 30 秒に変更するには、 次のコードブロックを実行します。

   <Properties>
     <Property name="keepalive.timeout.millis">30000</Property>
   </Properties>

   keepalive.timeout.millis プロパティはミリ秒単位であるため、 30 秒は 30000 です。

   次の例は、Google Cloud コンソールでキープアライブ タイムアウトを構成する方法を示しています。 API プロキシの ServiceCallout ポリシー:

   バックエンド サーバーの URL を使用した ServiceCallout ポリシー構成の例

   <ServiceCallout name="Service-Callout-1">
     <DisplayName>Service Callout-1</DisplayName>
     <HTTPTargetConnection>
       <Properties>
         <Property name="keepalive.timeout.millis">30000</Property>
       </Properties>
       <URL>https://mocktarget.apigee.net/json</URL>
     </HTTPTargetConnection>
   </ServiceCallout>

   ターゲット サーバーを使用した ServiceCallout ポリシー構成の例

   <ServiceCallout enabled="true" name="Service-Callout-1">
     <DisplayName>Service Callout-1</DisplayName>
     <Response>calloutResponse</Response>
     <HTTPTargetConnection>
       <LoadBalancer>
         <Server name="target1" />
         <Server name="target2" />
       </LoadBalancer>
       <Properties>
         <Property name="keepalive.timeout.millis">30000</Property>
       </Properties>
       <Path>/test</Path>
     </HTTPTargetConnection>
   </ServiceCallout>

   <ph type="x-smartling-placeholder">
4. API プロキシに加えた変更を保存します。

Message Processor でキープアライブ タイムアウトを構成する

このセクションでは、Message Processor でキープアライブ タイムアウトを構成する方法について説明します。「 キープアライブ タイムアウトは HTTPClient.keepalive.timeout.millis: キープアライブ タイムアウトを表します。 Message Processor コンポーネントでのミリ秒単位の値です。このプロパティはコメントであるため 使用する必要がある場合は、特別な構文を使用する必要があります。 conf/http.properties+HTTPClient.keepalive.timeout.millis（セクションを参照） <ph type="x-smartling-placeholder"></ph> 現在コメントアウトされているトークンを設定する Edge の構成方法

<ph type="x-smartling-placeholder">

Message Processor でキープアライブ タイムアウトを構成するには、次の操作を行います。

1. Message Processor マシンで、次のファイルをエディタで開きます。まだ存在しない場合は作成します。

   /opt/apigee/customer/application/message-processor.properties

   たとえば、ファイルを開くには、 vi の場合は、次のように入力します。

   vi /opt/apigee/customer/application/message-processor.properties
   

2. プロパティ ファイルに次の形式の行を追加します。 TIME_IN_MILLISECONDS:

   conf/http.properties+HTTPClient.keepalive.timeout.millis=TIME_IN_MILLISECONDS

   たとえば、Message Processor のキープアライブ タイムアウトを 30 秒後に、次の行を追加します。

   conf/http.properties+HTTPClient.keepalive.timeout.millis=30000

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 のキープアライブ タイムアウトの確認

このセクションでは、キープアライブ タイムアウトが正常に変更されたことを確認する方法について説明します。 について学びました

特殊な構文を キープアライブを設定する conf/http.properties+HTTPClient.keepalive.timeout.millis タイムアウトが発生している場合は、実際のプロパティが HTTPClient.keepalive.timeout.millis に新しい値が設定されました。

1. Message Processor マシンで、次のプロパティを検索します。 HTTPClient.keepalive.timeout.millis（ /opt/apigee/edge-message-processor/conf ディレクトリに移動して、 次のように新しい値が設定されます。

   grep -ri "HTTPClient.keepalive.timeout.millis" /opt/apigee/edge-message-processor/conf
   

2. Message Processor で新しいキープアライブ タイムアウト値が正常に設定されると、 上記のコマンドは、http.properties ファイルの新しい値を表示します。

   キープアライブ タイムアウトを構成した後の上記のコマンドの結果の例 から 30 秒に変更すると、次のようになります。

   /opt/apigee/edge-message-processor/conf/http.properties:HTTPClient.keepalive.timeout.millis=30000

   上記の出力例では、プロパティの値が HTTPClient.keepalive.timeout.millis に新しい値が設定されました 30000（http.properties）。これはキープアライブが Message Processor でタイムアウトが 30 秒に正常に構成されました。

3. プロパティの古い値が引き続き表示される場合 HTTPClient.keepalive.timeout.millis] を選択して、すべてのフォローしていることを このモジュールの手順を Message Processor のキープアライブ タイムアウトの構成 確認します。途中を抜けた場合は、すべての手順を正しく繰り返します。
4. それでもキープアライブ タイムアウトを変更できない場合は、 Google Cloud Apigee Edge サポート。