Router のタイムアウトの構成

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 プロパティを使用します。