mirror of
https://gitee.com/iresty/apisix.git
synced 2024-12-15 09:21:26 +08:00
5.4 KiB
5.4 KiB
title |
---|
健康检查 |
Upstream 的健康检查
APISIX 的健康检查使用lua-resty-healthcheck实现,你可以在 upstream 中使用它。
注意:
- 只有在 upstream 被请求时才会开始健康检查。 如果一个 upstream 被配置但没有被请求,那么就不会有健康检查。
- 如果没有健康的节点,那么请求会继续发送给上游。
- 如果 upstream 中只有一个节点,就不会有健康检查。 因为该唯一节点无论是否健康,请求都会发送给上游,
- 主动健康检查是必须的,这样不健康的节点才会恢复。
下面是一个检查检查的例子:
curl http://127.0.0.1:9080/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
}
}
}
}
}'
监控检查的配置内容在checks
中,checks
包含两个类型:active
和 passive
,详情如下
-
active
: 要启动主动健康检查,需要在 upstream 配置中的checks.active
添加如下配置项。-
active.timeout
: 主动健康检查 socket 超时时间(秒为单位),支持小数点。比如1.01
代表1010
毫秒,2
代表2000
毫秒。 -
active.http_path
: 用于发现 upstream 节点健康可用的 HTTP GET 请求路径。 -
active.host
: 用于发现 upstream 节点健康可用的 HTTP 请求主机名。 -
active.port
: 用于发现 upstream 节点健康可用的自定义主机端口(可选),配置此项会覆盖upstream
节点中的端口。
healthy
的阀值字段:active.healthy.interval
: 健康的目标节点的健康检查间隔时间(以秒为单位),最小值为 1。active.healthy.successes
: 确定目标是否健康的成功次数,最小值为 1。
unhealthy
的阀值字段:active.unhealthy.interval
: 针对不健康目标节点的健康检查之间的间隔(以秒为单位),最小值为 1。active.unhealthy.http_failures
: 确定目标节点不健康的 http 请求失败次数,最小值为 1。active.req_headers
: 其他请求标头。数组格式,可以填写多个标题。
-
-
passive
: 要启用被动健康检查,需要在 upstream 配置中的checks.passive
添加如下配置项。healthy
的阀值字段:passive.healthy.http_statuses
: 如果当前 HTTP 响应状态码是其中任何一个,则将 upstream 节点设置为healthy
状态。否则,请忽略此请求。passive.healthy.successes
: 如果 upstream 节点被检测成功(由passive.healthy.http_statuses
定义)的次数超过successes
次,则将该节点设置为healthy
状态。
unhealthy
的阀值字段:passive.unhealthy.http_statuses
: 如果当前 HTTP 响应状态码是其中任何一个,则将 upstream 节点设置为unhealthy
状态。否则,请忽略此请求。passive.unhealthy.tcp_failures
: 如果 TCP 通讯失败次数超过tcp_failures
次,则将 upstream 节点设置为unhealthy
状态。passive.unhealthy.timeouts
: 如果被动健康检查超时次数超过timeouts
次,则将 upstream 节点设置为unhealthy
状态。passive.unhealthy.http_failures
: 如果被动健康检查的 HTTP 请求失败(由passive.unhealthy.http_statuses
定义)的次数超过http_failures
次,则将 upstream 节点设置为unhealthy
状态。
健康检查信息可以通过 控制接口 中的 GET /v1/healthcheck
接口得到。