本頁面由 Cloud Translation API 翻譯而成。

設定訊息處理工具的 I/O 逾時

查看 Apigee Edge 說明文件。
前往 Apigee X說明文件。資訊

本文說明如何設定 Apigee Edge 訊息處理器的 I/O 逾時。

訊息處理器上的 I/O 逾時時間代表訊息處理者等待接收來自後端伺服器的回應，或等待通訊端準備寫入將要求傳送至後端伺服器

訊息處理器 I/O 逾時預設值為 55 seconds。此逾時設定經期適用指向在目標端點設定和 Service 摘要中設定的後端伺服器定義您的 API Proxy 政策

「訊息處理器」的 I/O 逾時設定可透過預設值 55 seconds。您可以在下列位置設定這項功能：

在 API Proxy 中
- 目標端點
- 服務呼叫政策
在訊息處理器中

下列屬性可控制訊息處理器的 I/O 逾時：

資源名稱位置說明

資源名稱	位置	說明
`io.timeout.millis`	API Proxy：目標端點服務呼叫政策	這是「訊息處理者」執行下列步驟的時間上限：在建立連線並傳送要求至後端伺服器，或等待通訊端準備就緒，訊息處理器將要求傳送至後端伺服器如果後端伺服器在這個逾時期間內沒有回應，則訊息處理器逾時。根據預設，這個屬性會採用訊息處理器的 `HTTPTransport.io.timeout.millis` 屬性。預設值為 `55 seconds`。如果此屬性已經過特定 API Proxy 的新逾時值修改，那麼只有該 API Proxy 會受到影響
`HTTPTransport.io.timeout.millis`	訊息處理器	這是「訊息處理者」執行下列步驟的時間上限：建立連線後，等待接收來自後端伺服器的回應並將要求傳送至後端伺服器，或等待通訊端準備就緒，訊息處理器將要求傳送至後端伺服器如果後端伺服器在這個逾時期間內沒有回應，則訊息處理器逾時。這個屬性用於這個訊息處理器上執行的所有 API Proxy。此屬性的預設值為 `55 seconds`。您可以修改這項屬性，方法如下：設定訊息處理器的 I/O 逾時，或在 API 中設定 `io.timeout.millis` 屬性來覆寫這個值 Proxy 級別

io.timeout.millis

API Proxy：

目標端點
服務呼叫政策

這是「訊息處理者」執行下列步驟的時間上限：

在建立連線並傳送要求至後端伺服器，或
等待通訊端準備就緒，訊息處理器將要求傳送至後端伺服器

如果後端伺服器在這個逾時期間內沒有回應，則訊息處理器逾時。

根據預設，這個屬性會採用訊息處理器的 HTTPTransport.io.timeout.millis 屬性。預設值為 55 seconds。

如果此屬性已經過特定 API Proxy 的新逾時值修改，那麼只有該 API Proxy 會受到影響

HTTPTransport.io.timeout.millis

訊息處理器

這是「訊息處理者」執行下列步驟的時間上限：

建立連線後，等待接收來自後端伺服器的回應並將要求傳送至後端伺服器，或
等待通訊端準備就緒，訊息處理器將要求傳送至後端伺服器

如果後端伺服器在這個逾時期間內沒有回應，則訊息處理器逾時。

這個屬性用於這個訊息處理器上執行的所有 API Proxy。

此屬性的預設值為 55 seconds。

您可以修改這項屬性，方法如下：設定訊息處理器的 I/O 逾時，或在 API 中設定 io.timeout.millis 屬性來覆寫這個值 Proxy 級別

事前準備

使用本文件中的步驟前，請務必先瞭解下列主題：

如果您不熟悉 I/O 逾時，請參閱 io.timeout.millis 屬性中的說明 TargetEndpoint 傳輸屬性規格。
如果您不熟悉為 Private Cloud 設定屬性的方式，請參閱如何設定 Edge。
請務必遵循設定 I/O 逾時的最佳做法。

，瞭解如何調查及移除這項存取權。

注意：

增加 API Proxy 的 I/O 逾時：

如果您想要增加特定 API Proxy 的 I/O 逾時值高於預設值，您必須在 API Proxy 中將其增加 ( 設定 API Proxy 的 I/O 逾時)。此外，您需要增加路由器、用戶端和後端伺服器的 I/O 逾時值與中的文件一致設定 I/O 逾時的最佳做法。
僅增加訊息處理器上的 I/O 逾時值，或設定不適當的 Edge 元件上的 I/O 逾時值可能導致 504 閘道逾時錯誤。

降低 API Proxy 的 I/O 逾時時間：

如要降低特定 API Proxy 的 I/O 逾時值，您必須減少寫入 API Proxy (如設定 API Proxy 的 I/O 逾時。如果其他元件的逾時情形 (路由器、用戶端和後端) 以及您在區域中的設定 I/O 逾時的最佳做法，這樣就不必進行任何變更其他元件中否則，請進行適當的變更。

設定 API Proxy 的 I/O 逾時

下列 API Proxy 位置可設定 I/O 逾時：

目標端點
服務呼叫政策

設定 API Proxy 目標端點的 I/O 逾時

本節說明如何在 API Proxy 目標端點中設定 I/O 逾時。您可以透過屬性 io.timeout.millis 設定 I/O 逾時，代表 I/O 逾時值 (以毫秒為單位)。

注意：在 API Proxy 目標端點中設定 I/O 逾時設定會覆寫預設值為新值 (55 seconds)，且只會影響其設定所在的 API Proxy。API Proxy 的其餘部分會繼續使用預設值 I/O 逾時值為 55 seconds。

，瞭解如何調查及移除這項存取權。

在 Edge UI 中，選取要設定新 Pod 的特定 API Proxy I/O 逾時值。
選取您要修改的特定目標端點。
在io.timeout.millis TargetEndpoint 設定中的 <HTTPTargetConnection> 元素。

舉例來說，如要將 I/O 逾時變更為 120 秒，請新增以下程式碼區塊：

    <Properties>
      <Property name="io.timeout.millis">120000</Property>
    </Properties>

由於 io.timeout.millis 屬性是以毫秒為單位，因此 120 秒為 120000。

以下範例說明如何設定目標端點中的 I/O 逾時設定：

使用後端伺服器的網址的目標端點設定範例

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

使用目標伺服器的目標端點設定範例

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

儲存對 API Proxy 所做的變更。

設定 API Proxy 服務呼叫政策中的 I/O 逾時設定

本節說明如何在應用程式的 ServiceNotify 政策中設定 I/O 逾時並存取 API Proxy您可以透過 <Timeout> 元素設定 I/O 逾時或 io.timeout.millis 屬性。<Timeout> 元素和 io.timeout.millis 屬性代表 I/O 逾時值 (以毫秒為單位)。

注意：設定 API Proxy 覆寫的 ServiceSummary 政策中的 I/O 逾時設定預設值為新值 (55 seconds)，且只會影響政策摘要。Service 摘要的其餘部分政策和 API Proxy 將繼續使用預設的 I/O 逾時值 55 seconds。

，瞭解如何調查及移除這項存取權。

您可以使用下列其中一個方法，在 ServiceSummary 政策中設定 I/O 逾時：

<Timeout> 元素。
io.timeout.millis 屬性。

逾時元素

使用 <Timeout> 設定 Service callout 政策中的 I/O 逾時時間元素時，請執行以下操作：

在 Edge UI 中，選取要設定哪個特定 API Proxy 服務呼叫政策的新 I/O 逾時值。
選取要修改的服務摘要政策。
在<Timeout> <ServiceCallout> 設定。
舉例來說，如要將 I/O 逾時改為 120 秒，請加入以下這行程式碼：
```
    <Timeout>120000</Timeout>
```
由於 <Timeout> 元素是以毫秒為單位，因此 120 秒為 120000。

以下範例說明如何在 Service callout 中設定 I/O 逾時使用 <Timeout> 元素處理政策：

使用後端伺服器網址的服務摘要政策設定示例
```
<ServiceCallout name="Service-Callout-1">
    <DisplayName>ServiceCallout-1</DisplayName>
    <Timeout>120000</Timeout>
    <HTTPTargetConnection>
        <Properties/>
        <URL>https://mocktarget.apigee.net/json</URL>
    </HTTPTargetConnection>
</ServiceCallout>
```
儲存對 API Proxy 所做的變更。

io.timeout.millis 屬性

如要在服務呼叫政策中設定 I/O 逾時，請使用 io.timeout.millis 屬性，請執行以下操作：

在 Edge UI 中，選取要設定的特定 API Proxy ServiceCALL 政策的新 I/O 逾時值。
選取要修改的服務摘要政策。

在io.timeout.millis <HTTPTargetConnection> 元素。

舉例來說，如要將 I/O 逾時變更為 120 秒，請新增下列區塊程式碼：

    <Properties>
      <Property name="io.timeout.millis">120000</Property>
    </Properties>

由於 io.timeout.millis 屬性是以毫秒為單位，因此 120 秒為 120000。

以下範例說明如何設定目標端點中的 I/O 逾時設定：

使用後端伺服器網址的服務摘要政策設定示例

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

使用目標伺服器的服務摘要政策設定示例

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

敬上

儲存對 API Proxy 所做的變更。

設定訊息處理器的 I/O 逾時

本節說明如何設定「訊息處理器」上的 I/O 逾時。您可以透過屬性 HTTPTransport.io.timeout.millis 設定 I/O 逾時。代表訊息處理器元件上的 I/O 逾時值 (以毫秒為單位) 使用符記如何設定 Edge：

，瞭解如何調查及移除這項存取權。

如要設定訊息處理器的 I/O 逾時，請按照下列步驟操作：

在訊息處理器電腦上，以編輯器開啟下列檔案。否則並加以建立
```
/opt/apigee/customer/application/message-processor.properties
```
舉例來說，如果要使用 vi，請輸入下列指令：
```
vi /opt/apigee/customer/application/message-processor.properties
```
在屬性檔案中加入下列格式的 1 行，並將 TIME_IN_MILLISECONDS:
```
conf_http_HTTPTransport.io.timeout.millis=TIME_IN_MILLISECONDS
```
舉例來說，如要將訊息處理器的 I/O 逾時變更為 120 秒，新增下列程式碼：
```
conf_http_HTTPTransport.io.timeout.millis=120000
```
儲存變更。

確認屬性檔案由 apigee 使用者擁有，如下所示：

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

重新啟動訊息處理器，如下所示：

/opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart

如果您有多部訊息處理器，請針對所有「訊息」重複上述步驟。處理器：

驗證訊息處理器的 I/O 逾時

本節將說明如何驗證 I/O 逾時是否已成功修改訊息處理器。

雖然使用 conf_http_HTTPTransport.io.timeout.millis 符記來設定訊息處理器的 I/O 逾時，您必須驗證實際的屬性已將 HTTPTransport.io.timeout.millis 設為新值。

在訊息處理器電腦上搜尋屬性 HTTPTransport.io.timeout.millis 前往 /opt/apigee/edge-message-processor/conf 目錄，並查看已經設定新的值，如下所示：
```
grep -ri "HTTPTransport.io.timeout.millis" /opt/apigee/edge-message-processor/conf
```
如果成功在訊息處理器上設定新的 I/O 逾時值，則指令會顯示 http.properties 檔案中的新值。

您在將 I/O 逾時設定為 120 秒如下：

/opt/apigee/edge-message-processor/conf/http.properties:HTTPTransport.io.timeout.millis=120000

在上方輸出範例中，請注意已在以下位置將「HTTPTransport.io.timeout.millis」設為新值 120000： http.properties。這表示 I/O 逾時設定已成功設定時間到 120 秒

如果仍看到 HTTPTransport.io.timeout.millis 屬性的舊值，請確認您已遵循正確設定訊息處理器的 I/O 逾時。如果錯過任何步驟，請再次正確重複所有步驟。
如果還是無法修改 I/O 逾時，請與 Apigee Edge 支援。

接下來呢？

瞭解設定路由器的 I/O 逾時