Skip to main content
Version: 3.3

健康检查

描述#

本文主要介绍了 Apache APISIX 的健康检查功能。健康检查功能可以在上游节点发生故障或者迁移时，将请求代理到健康的节点上，最大程度避免服务不可用的问题。APISIX 的健康检查功能使用 lua-resty-healthcheck 实现，并分为主动检查和被动检查。

主动健康检查#

主动健康检查主要是指 APISIX 通过预设的探针类型，主动探测上游节点的存活性。目前 APISIX 支持 HTTP、HTTPS、TCP 三种探针类型。

当发向健康节点 A 的 N 个连续探针都失败时（取决于如何配置），则该节点将被标记为不健康，不健康的节点将会被 APISIX 的负载均衡器忽略，无法收到请求；若某个不健康的节点，连续 M 个探针都成功，则该节点将被重新标记为健康，进而可以被代理。

被动健康检查#

被动健康检查是指，通过判断从 APISIX 转发到上游节点的请求响应状态，来判断对应的上游节点是否健康。相对于主动健康检查，被动健康检查的方式无需发起额外的探针，但是也无法提前感知节点状态，可能会有一定量的失败请求。

若发向健康节点 A 的 N 个连续请求都被判定为失败（取决于如何配置），则该节点将被标记为不健康。

注意

由于不健康的节点无法收到请求，仅使用被动健康检查策略无法重新将节点标记为健康，因此通常需要结合主动健康检查策略。

提示
  • 只有在 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.type被动检查stringhttp https tcphttp被动检查的类型。
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 类型检查时，确定节点非健康的次数。

配置示例#

你可以通过 Admin API 在路由中启用健康检查功能：

curl http://127.0.0.1:9180/apisix/admin/routes/1 -H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' -X PUT -d '
{
    "uri": "/index.html",
    "plugins": {
        "limit-count": {
            "count": 2,
            "time_window": 60,
            "rejected_code": 503,
            "key": "remote_addr"
        }
    },
    "upstream": {
         "nodes": {
            "127.0.0.1:1980": 1,
            "127.0.0.1:1970": 1
        },
        "type": "roundrobin",
        "retries": 2,
        "checks": {
            "active": {
                "timeout": 5,
                "http_path": "/status",
                "host": "foo.com",
                "healthy": {
                    "interval": 2,
                    "successes": 1
                },
                "unhealthy": {
                    "interval": 1,
                    "http_failures": 2
                },
                "req_headers": ["User-Agent: curl/7.29.0"]
            },
            "passive": {
                "healthy": {
                    "http_statuses": [200, 201],
                    "successes": 3
                },
                "unhealthy": {
                    "http_statuses": [500],
                    "http_failures": 3,
                    "tcp_failures": 3
                }
            }
        }
    }
}'

启用成功后，如果 APISIX 探测到不健康的节点，将会在错误日志中输出如下日志：

enabled healthcheck passive while logging request
failed to receive status line from 'nil (127.0.0.1:1980)': closed
unhealthy TCP increment (1/2) for '(127.0.0.1:1980)'
failed to receive status line from 'nil (127.0.0.1:1980)': closed
unhealthy TCP increment (2/2) for '(127.0.0.1:1980'
提示

需要将错误日志的级别调整为 info 才可以观测到上述日志信息

你可以通过控制接口 中的 GET /v1/healthcheck 接口获取健康检查信息。如下所示：


curl http://127.0.0.1:9090/v1/healthcheck/upstreams/healthycheck -s | jq .