健康检查

Upstream 的健康检查

Apache APISIX 的健康检查使用 lua-resty-healthcheck 实现。

注意：

  • 只有在 upstream 被请求时才会开始健康检查，如果 upstream 被配置但没有被请求，不会触发启动健康检查。
  • 如果没有健康的节点，那么请求会继续发送给上游。
  • 如果 upstream 中只有一个节点时不会触发启动健康检查，该唯一节点无论是否健康，请求都将转发给上游。
  • 主动健康检查是必须的，这样不健康的节点才会恢复。

配置说明

配置项配置类型值类型值选项默认值描述
upstream.checks.active.type主动检查stringhttp https tcphttp主动检查的类型。
upstream.checks.active.timeout主动检查integer1主动检查的超时时间（单位：秒）。
upstream.checks.active.concurrency主动检查integer10主动检查时同时检查的目标数。
upstream.checks.active.http_path主动检查string/主动检查的 HTTP 请求路径。
upstream.checks.active.host主动检查string${upstream.node.host}主动检查的 HTTP 请求主机名。
upstream.checks.active.port主动检查integer1 至 65535${upstream.node.port}主动检查的 HTTP 请求主机端口。
upstream.checks.active.https_verify_certificate主动检查booleantrue主动检查使用 HTTPS 类型检查时，是否检查远程主机的 SSL 证书。
upstream.checks.active.req_headers主动检查array[]主动检查使用 HTTP 或 HTTPS 类型检查时，设置额外的请求头信息。
upstream.checks.active.healthy.interval主动检查（健康节点）integer>= 11主动检查（健康节点）检查的间隔时间（单位：秒）
upstream.checks.active.healthy.http_statuses主动检查（健康节点）array200 至 599[200, 302]主动检查（健康节点）HTTP 或 HTTPS 类型检查时，健康节点的 HTTP 状态码。
upstream.checks.active.healthy.successes主动检查（健康节点）integer1 至 2542主动检查（健康节点）确定节点健康的次数。
upstream.checks.active.unhealthy.interval主动检查（非健康节点）integer>= 11主动检查（非健康节点）检查的间隔时间（单位：秒）
upstream.checks.active.unhealthy.http_statuses主动检查（非健康节点）array200 至 599[429, 404, 500, 501, 502, 503, 504, 505]主动检查（非健康节点）HTTP 或 HTTPS 类型检查时，非健康节点的 HTTP 状态码。
upstream.checks.active.unhealthy.http_failures主动检查（非健康节点）integer1 至 2545主动检查（非健康节点）HTTP 或 HTTPS 类型检查时，确定节点非健康的次数。
upstream.checks.active.unhealthy.tcp_failures主动检查（非健康节点）integer1 至 2542主动检查（非健康节点）TCP 类型检查时，确定节点非健康的次数。
upstream.checks.active.unhealthy.timeouts主动检查（非健康节点）integer1 至 2543主动检查（非健康节点）确定节点非健康的超时次数。
upstream.checks.passive.healthy.http_statuses被动检查（健康节点）array200 至 599[200, 201, 202, 203, 204, 205, 206, 207, 208, 226, 300, 301, 302, 303, 304, 305, 306, 307, 308]被动检查（健康节点）HTTP 或 HTTPS 类型检查时，健康节点的 HTTP 状态码。
upstream.checks.passive.healthy.successes被动检查（健康节点）integer0 至 2545被动检查（健康节点）确定节点健康的次数。
upstream.checks.passive.unhealthy.http_statuses被动检查（非健康节点）array200 至 599[429, 500, 503]被动检查（非健康节点）HTTP 或 HTTPS 类型检查时，非健康节点的 HTTP 状态码。
upstream.checks.passive.unhealthy.tcp_failures被动检查（非健康节点）integer0 至 2542被动检查（非健康节点）TCP 类型检查时，确定节点非健康的次数。
upstream.checks.passive.unhealthy.timeouts被动检查（非健康节点）integer0 至 2547被动检查（非健康节点）确定节点非健康的超时次数。
upstream.checks.passive.unhealthy.http_failures被动检查（非健康节点）integer0 至 2545被动检查（非健康节点）HTTP 或 HTTPS 类型检查时，确定节点非健康的次数。

配置示例：

  1. curl http://127.0.0.1:9080/apisix/admin/routes/1 -H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' -X PUT -d '
  2. {
  3.     "uri": "/index.html",
  4.     "plugins": {
  5.         "limit-count": {
  6.             "count": 2,
  7.             "time_window": 60,
  8.             "rejected_code": 503,
  9.             "key": "remote_addr"
  10.         }
  11.     },
  12.     "upstream": {
  13.          "nodes": {
  14.             "127.0.0.1:1980": 1,
  15.             "127.0.0.1:1970": 1
  16.         },
  17.         "type": "roundrobin",
  18.         "retries": 2,
  19.         "checks": {
  20.             "active": {
  21.                 "timeout": 5,
  22.                 "http_path": "/status",
  23.                 "host": "foo.com",
  24.                 "healthy": {
  25.                     "interval": 2,
  26.                     "successes": 1
  27.                 },
  28.                 "unhealthy": {
  29.                     "interval": 1,
  30.                     "http_failures": 2
  31.                 },
  32.                 "req_headers": ["User-Agent: curl/7.29.0"]
  33.             },
  34.             "passive": {
  35.                 "healthy": {
  36.                     "http_statuses": [200, 201],
  37.                     "successes": 3
  38.                 },
  39.                 "unhealthy": {
  40.                     "http_statuses": [500],
  41.                     "http_failures": 3,
  42.                     "tcp_failures": 3
  43.                 }
  44.             }
  45.         }
  46.     }
  47. }'

健康检查信息可以通过 控制接口 中的 GET /v1/healthcheck 接口得到。