配置路由器上的 I/O 超时

您正在查看 Apigee Edge 文档。
前往 Apigee X 文档。 信息

本文档介绍了如何在 Apigee Edge 的路由器上配置 I/O 超时。

路由器上的 I/O 超时是指路由器在建立连接并将请求发送到消息处理器后，等待接收消息处理器响应的时间。路由器上的 I/O 超时默认值为 57 秒。

您可以根据需要，将路由器的 I/O 超时时间从默认值 57 秒增加或减少。可以通过以下方式进行配置：

• 在虚拟主机中
• 在路由器上

以下属性用于控制路由器的 I/O 超时：

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)

准备工作

在执行本文档中的步骤之前，请务必了解以下主题：

• 如果您不熟悉虚拟主机属性，请参阅 虚拟主机属性参考。
• 如果您不熟悉如何为 Edge Private Cloud 配置属性，请参阅如何配置 Edge。
• 确保您遵循 配置 I/O 超时的最佳实践建议。

在虚拟主机中配置 I/O 超时

本部分介绍了如何配置与组织和环境关联的虚拟主机中的 I/O 超时。您可以通过属性 proxy_read_timeout 在虚拟主机中配置 I/O 超时，该属性表示以秒为单位的 I/O 超时值。

您可以使用以下方法之一配置虚拟主机：

• Edge 界面
• Edge API

验证虚拟主机上的 I/O 超时

本部分介绍了如何使用 Edge API 验证虚拟主机上的 I/O 超时是否已成功修改。

1. 执行 Get virtual host API 以获取 virtualhost 配置，如下所示：

   公有云用户

   curl -v -X GET https://api.enterprise.apigee.com/v1/organizations/{organization-name}/environments/{environment-name}/virtualhosts/{virtualhost-name} -u <username>
                 

   Private Cloud 用户

   curl -v -X GET http://<management server-host>:<port #>/v1/organizations/{organization-name}/environments/{environment-name}/virtualhosts/{virtualhost-name} -u <username>
                 

   其中：

   {organization-name} 是组织的名称

   {environment-name} 是环境的名称

   {virtualhost-name} 是虚拟主机的名称

2. 验证属性 proxy_read_timeout 是否已设置为新值。

   更新后的虚拟主机配置示例

   {
     "hostAliases": [
       "api.myCompany,com",
     ],
     "interfaces": [],
     "listenOptions": [],
     "name": "secure",
     "port": "443",
     "retryOptions": [],
     "properties": {
       "property": [
         {
           "name": "proxy_read_timeout",
           "value": "120"
         }
       ]
     },
     "sSLInfo": {
       "ciphers": [],
       "clientAuthEnabled": "false",
       "enabled": "true",
       "ignoreValidationErrors": false,
       "keyAlias": "myCompanyKeyAlias",
       "keyStore": "ref://myCompanyKeystoreref",
       "protocols": []
     },
     "useBuiltInFreeTrialCert": false
   }

   在上述示例中，请注意 proxy_read_timeout 已设置为新值 120 秒。

3. 如果您仍然看到 proxy_read_timeout, 的旧值，请验证您是否已正确按照在虚拟主机中配置 I/O 超时中所述的所有步骤操作。 如果您遗漏了任何步骤，请再次正确重复所有步骤。
4. 如果您仍然无法修改 I/O 超时，请与 Apigee Edge 支持团队联系。

在路由器上配置 I/O 超时

本部分介绍了如何在路由器上配置 I/O 超时。可以通过路由器属性 conf_load_balancing_load.balancing.driver.proxy.read.timeout 配置 I/O 超时，该属性表示以秒为单位的 I/O 超时值。

如需在路由器上配置 I/O 超时，请执行以下操作：

1. 在路由器机器上，通过编辑器打开以下文件。如果该目录尚不存在，则创建该目录。

   /opt/apigee/customer/application/router.properties

   例如，如需使用 vi 打开文件，请输入以下命令：

   vi /opt/apigee/customer/application/router.properties

2. 在 properties 文件中添加一行，格式如下，并用值替换 time_in_seconds：

conf_load_balancing_load.balancing.driver.proxy.read.timeout=time_in_seconds

例如，如需将路由器的 I/O 超时时间更改为 120 秒，请添加以下行：

conf_load_balancing_load.balancing.driver.proxy.read.timeout=120

您还可以修改以分钟为单位的 I/O 超时时间。例如，如需将超时时间更改为两分钟，请添加以下行：

conf_load_balancing_load.balancing.driver.proxy.read.timeout=2m

3. 保存更改。
4. 确保此属性文件归 apigee 用户所有，如下所示：

   chown apigee:apigee /opt/apigee/customer/application/router.properties

5. 重启路由器，如下所示：

   /opt/apigee/apigee-service/bin/apigee-service edge-router restart

6. 如果您有多个路由器，请在所有路由器上重复执行上述步骤。

验证路由器上的 I/O 超时

本部分介绍了如何验证是否已在路由器上成功修改 I/O 超时。

即使您使用令牌 conf_load_balancing_load.balancing.driver.proxy.read.timeout 在路由器上设置了 I/O 超时，您也需要验证实际属性 proxy_read_timeout 是否已设置为新值。

1. 在 /opt/nginx/conf.d 目录中搜索属性 proxy_read_timeout，并检查该属性是否已设置为新值，如下所示：

   grep -ri "proxy_read_timeout" /opt/nginx/conf.d

2. 如果成功在路由器上设置了新的 I/O 超时值，则上述命令会在所有虚拟主机配置文件中显示新值。

   以下是当 I/O 超时为 120 秒时，上述 grep 命令的示例结果：

   /opt/nginx/conf.d/0-default.conf:proxy_read_timeout 120;
   /opt/nginx/conf.d/0-edge-health.conf:proxy_read_timeout 1s;

   在上面的示例输出中，请注意，属性 proxy_read_timeout 已在 0-default.conf 中设置为新值 120，而 是默认虚拟主机的配置文件。这表示已成功将路由器上的 I/O 超时时间配置为 120 秒。

3. 如果您仍然看到属性 proxy_read_timeout 的旧值，请验证您是否已正确按照在路由器上配置 I/O 超时中所述的所有步骤操作。如果您错过了任何步骤，请再次正确重复所有步骤。
4. 如果您仍然无法修改 I/O 超时，请与 Apigee Edge 支持团队联系。

后续步骤

了解如何在消息处理器中配置 I/O 超时