Nginx的TCP运行时健康检查

本章介绍如何配置TCP的运行状况检查。

• 介绍
• 先决条件
• 被动TCP运行状况检查
  • 服务器缓慢启动
• 活动TCP运行状况检查
  • 微调TCP运行状况检查
  • “匹配”配置块

介绍

NGINX和NGINX Plus可以持续测试您的TCP上游服务器，避免出现故障的服务器，并可以将恢复的服务器正常地添加到负载平衡组中。

先决条件

• 您已在stream上下文中配置了TCP服务器的上游组，例如：

  stream {
      #...
      upstream stream_backend {
      server backend1.example.com:12345;
      server backend2.example.com:12345;
      server backend3.example.com:12345;
     }
      #...
  }

• 您已经配置了将TCP连接传递到服务器组的服务器：

  stream {
      #...
      server {
          listen     12345;
          proxy_pass stream_backend;
      }
      #...
  }

被动TCP运行状况检查

如果连接上游服务器的尝试超时或导致错误，NGINX Open Source或NGINX Plus可以将服务器标记为不可用，并在指定的时间内停止向其发送请求。要定义NGINX认为上游服务器不可用的条件，请在server指令中包含以下参数

• fail_timeout –在指定的连接尝试次数内必须失败的时间，服务器才被视为不可用。另外，NGINX将服务器标记为不可用之后认为服务器不可用的时间。
• max_fails –在指定时间内NGINX认为服务器不可用的失败尝试次数。

默认值为10秒数和1尝试次数。因此，如果连接尝试超时或在10秒内至少失败一次，NGINX会将服务器标记为10秒钟不可用。该示例显示了如何在30秒内将这些参数设置为2个失败：

upstream stream_backend {
    server backend1.example.com:12345 weight=5;
    server backend2.example.com:12345 max_fails=2 fail_timeout=30s;
    server backend3.example.com:12346 max_conns=3;
}

upstream backend {
    server backend1.example.com:12345 slow_start=30s;
    server backend2.example.com;
    server 192.0.0.1 backup;
}

活动TCP运行状况检查

可以将运行状况检查配置为测试各种故障类型。例如，NGINX Plus可以连续测试上游服务器的响应能力，并避免出现故障的服务器。

NGINX Plus向每个上游服务器发送特殊的运行状况检查请求，并检查是否满足特定条件。如果无法建立与服务器的连接，则运行状况检查将失败，并且服务器将被视为运行状况不佳。NGINX Plus不会将客户端连接代理到运行状况不佳的服务器。如果为上游组配置了多个运行状况检查，则任何检查失败都会足以使相应的服务器不正常。

要启用主动健康检查：

1. 指定一个共享内存区域 – NGINX Plus工作进程在其中共享计数器和连接状态信息的特殊区域。将zone指令添加到上游服务器组，并指定区域名称（此处为stream_backend）和内存量（64 KB）：

   stream {
       #...
       upstream stream_backend {
           zone   stream_backend 64k;
           server backend1.example.com:12345;
           server backend2.example.com:12345;
           server backend3.example.com:12345;
       }
       #...
   }

2. 使用以下health_check指令为上游组启用主动运行状况检查：

   stream {
       #...
       server {
           listen        12345;
           proxy_pass    stream_backend;
           health_check;
           #...
       }
   }

3. 如有必要，使用该health_check_timeout指令减少两次连续运行状况检查之间的超时。该指令将覆盖proxy_timeout运行状况检查的值，因为对于运行状况检查，此超时需要大大缩短：

   stream {
       #...
       server {
           listen               12345;
           proxy_pass           stream_backend;
           health_check;
           health_check_timeout 5s;
       }
   }

4. 默认情况下，NGINX Plus将运行状况检查消息发送到块中server指令所指定的端口upstream。您可以指定另一个端口进行运行状况检查，这在监视同一主机上许多服务的运行状况时特别有用。要覆盖端口，请指定伪指令的port参数health_check：

   stream {
       #...
       server {
           listen               12345;
           proxy_pass           stream_backend;
           health_check         port=12346;
           health_check_timeout 5s;
       }
   }