Router のタイムアウトの構成

Edge for Private Cloud v4.19.01

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

Edge Router が API プロキシからのリクエストを処理する一環として Message Processor へのアクセスを試行する際のタイムアウトは、デフォルトで 57 秒に設定されています。このタイムアウト期間が満了すると、Router は別の Message Processor が使用できる場合は、その 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 プロパティを使用します。