Router のタイムアウトの構成

Edge for Private Cloud v4.18.01

API プロキシ リクエストの一部として Message Processor にアクセスする際の Router のタイムアウトを構成できます。

Edge Router は、API プロキシを介してリクエストを処理する一環として Message Processor にアクセスしようとするときに、デフォルトで 57 秒のタイムアウトを設定します。このタイムアウトが経過すると、ルーターは別の Message Processor への接続を試みます(利用可能な場合)。それ以外の場合は、エラーを返します。

次の 2 つのプロパティで、Router のタイムアウトを制御します。

プロパティ 説明
conf_load_balancing_load.balancing.driver.proxy.read.timeout
  1 つのルーターの待機時間を指定します。デフォルト値は 57 秒です。

次の表記を使用して、時間間隔を秒以外の単位で設定できます。

ms: milliseconds
s:  seconds (default)
m:  minutes
h:  hours
d:  days
w:  weeks
M:  months (length of 30 days)
y:  years (length of 365 days)

たとえば、待機時間を 2 時間に設定するには、次のいずれかの値を使用します。

conf_load_balancing_load.balancing.driver.proxy.read.timeout=2h  # 2 hours
  OR
conf_load_balancing_load.balancing.driver.proxy.read.timeout=120m  # 120 minutes
conf_load_balancing_load.balancing.driver.nginx.upstream_next_timeout
  Edge のインストール環境に複数の Message Processor がある場合に、すべての Message Processor の合計待機時間を指定します。デフォルト値は、conf_load_balancing_load.balancing.driver.proxy.read.timeout の現在の値(57 秒)です。

conf_load_balancing_load.balancing.driver.proxy.read.timeout プロパティと同様に、デフォルト(秒)以外の時間間隔を指定できます。

Router のタイムアウトを構成するには:

  1. /opt/apigee/customer/application/router.properties ファイルを編集します。ファイルが存在しない場合は作成します。
  2. 次の例に示すように、構成ファイルでプロパティを設定します。
    conf_load_balancing_load.balancing.driver.proxy.read.timeout=1800000ms  # 1800000 milliseconds
    conf_load_balancing_load.balancing.driver.nginx.upstream_next_timeout=1d  # 1 day
  3. プロパティ ファイルが「apigee」ユーザーによって所有されていることを確認します。
    chown apigee:apigee /opt/apigee/customer/application/router.properties
  4. Router を再起動します。
    /opt/apigee/apigee-service/bin/apigee-service edge-router restart

再試行オプションを設定するには、仮想ホストの構成プロパティで説明されているように、RetryOption プロパティを使用します。