Router のタイムアウトの構成

Edge for Private Cloud v4.18.01

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

Edge Router では、API プロキシ経由のリクエスト処理の一環として Message Processor にアクセスを試みる際のタイムアウトが、デフォルトで 57 秒に設定されています。このタイムアウト期間が満了すると Router は、別の Message Processor が使用可能な場合、それに接続しようとします。そうでなければ、エラーを返します。

Router のタイムアウトは、次の 2 つのプロパティによって制御されます。

プロパティ 説明
conf_load_balancing_load.balancing.driver.proxy.read.timeout
  単一の Router の待機時間を指定します。デフォルト値は 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 プロパティを使用します。