## Kong支持两种健康检查
* 主动检查,目标中的特定HTTP端点定期被请求,目标的健康是根据其响应确定的。
* 被动检查(也称为断路器),Kong分析正在访问的流量,并根据它们响应请求确定目标的健康状况。
## 健康检查的作用
健康检查功能的目标,是动态地将目标标记为健康的或不健康的,对于给定的Kong节点。非集群范围的健康信息同步:每个Kong节点分别决定其目标的健康状况。这是可取的,因为在给定的点上,一个Kong节点可能能够成功地连接到一个目标,而另一个节点却无法到达它:第一个节点将认为它是健康的,而第二个节点将标记为不健康,并开始将流量路由到上游的其他目标。
要么是主动请求(在主动健康检查中),要么是一个被动请求(在被动健康检查中)产生的数据,用来确定一个目标是健康的还是不健康的。请求可能产生TCP错误、超时或产生HTTP状态码。
根据这些信息,健康检查更新了一系列内部计数器:
* 如果返回的状态码被配置为“健康”,它将增加目标的“成功”计数器,并清除所有其他计数器;
* 如果连接失败,它将增加目标的“TCP故障”计数器,并清除“成功”计数器;
* 如果超时,它将增加目标的“超时”计数器,并清除“成功”计数器;
* 如果返回的状态码被配置为“不健康”,它将增加目标的“HTTP故障”计数器,并清除“成功”计数器。
如果任何“TCP失败”、“HTTP故障”或“超时”计数器达到它们配置的阈值,那么目标将被标记为不健康。
如果“成功”计数器达到其配置的阈值,目标将被标记为健康。
HTTP状态码的列表是“健康的”或“不健康的”,每个计数器的单独阈值都可以在每个上游的基础上进行配置。下面,我们有一个上游实体的配置示例,展示了用于配置健康检查的各种字段的默认值。管理API参考文档中包含了对每个字段的描述。
```
{
"name": "service.v1.xyz",
"healthchecks": {
"active": {
"concurrency": 10,
"healthy": {
"http_statuses": [ 200, 302 ],
"interval": 0,
"successes": 0
},
"http_path": "/",
"timeout": 1,
"unhealthy": {
"http_failures": 0,
"http_statuses": [ 429, 404, 500, 501,
502, 503, 504, 505 ],
"interval": 0,
"tcp_failures": 0,
"timeouts": 0
}
},
"passive": {
"healthy": {
"http_statuses": [ 200, 201, 202, 203,
204, 205, 206, 207,
208, 226, 300, 301,
302, 303, 304, 305,
306, 307, 308 ],
"successes": 0
},
"unhealthy": {
"http_failures": 0,
"http_statuses": [ 429, 500, 503 ],
"tcp_failures": 0,
"timeouts": 0
}
}
},
"slots": 10
}
```
如果上游的所有目标都是不健康的,Kong将对上游的请求返回`503服务不可用`
提示:
1、健康检查只在活动目标上运行,并且不修改在Kong数据库中目标的活动状态。
2、不健康的目标不会从负载平衡器中移除,因此在使用散列算法时,不会对平衡器布局产生任何影响(它们只是被跳过)。
3、DNS警告和平衡器警告也适用于健康检查。如果为目标使用主机名,那么请确保DNS服务器总是返回一个名称的完整IP地址集,并且不会限制响应。如果不这样做,可能会导致健康检查没有被执行。
## 如何配置健康检查呢?
[1. 主动健康检查](./4.3.2健康检查.md)
[2. 被动健康检查(断路器)](./4.3.3断路器被动检查.md)
- 1. 概述
- 2. 快速安装
- 2.1 环境准备
- 2.2 开始安装
- 2.3 启动/关闭kongx
- 2.4 使用kongx
- 3. 使用指南
- 3.0 mockbin配置示例
- 3.0.1 不含upstream的配置
- 3.0.2 含upstream的配置
- 3.1 Gateway
- 3.1.1 Upstreams
- 3.1.1.1 新增/修改upstreams
- 3.1.1.2 管理targets
- 3.1.1.3 设置健康检查
- 3.1.1.4 upstream视图
- 3.1.2 Services
- 3.1.2.1 新建/修改service
- 3.1.2.2 添加服务路由
- 3.1.2.3 添加服务插件
- 3.1.2.4 同步services
- 3.1.2.5 services视图
- 3.1.3 Routes
- 3.1.3.1 路由列表
- 3.1.3.2 修改路由
- 3.1.3.3 批量修改HOSTS
- 3.1.4 Plugins
- 3.1.4.1 新增插件
- 3.1.4.2 插件列表
- 3.1.5 Consumers
- 3.1.5.1 新建/修改consumers
- 3.1.6 Kong Shell
- 3.1.6.1 shell安装
- 3.1.6.2 使用Shell
- 3.2 系统管理
- 3.2.1 用户管理
- 3.2.2 角色管理
- 3.2.3 用户组管理
- 3.2.4 菜单管理
- 3.3 参数管理
- 3.3.1 环境管理
- 3.3.2 系统参数
- 3.3.3 如何增加多个环境?
- 3.4 日志管理
- 3.4.1 操作日志
- 3.4.2 同步日志
- 3.5 工具箱
- 3.5.1 Kong Shell
- 3.5.2 切换工作台
- 3.6 网关流水线
- 3.6.1 Pipeline
- 4. 最佳实践
- 4.1 灰度插件canary使用
- 4.2 kong与consul集成
- 4.2.1 使用kong提供dns服务
- 4.2.2 使用dnsmasq提供dns服务
- 4.2.3 使用consul自主发现服务
- 4.3 kong健康检查
- 4.3.1 简介
- 4.3.2 健康检查(主动检查)
- 4.3.3 断路器(被动检查)
- 4.3.4 总结
- 4.4 认证插件之key-auth
- 4.5 认证插件之basic-auth
- 4.6 认证插件之oauth2-auth
- 4.7 认证插件之jwt
- 4.8 kong自定义access_log格式
- 4.8.1 前言
- 4.8.2 配置文本格式
- 4.8.3 配置JSON格式
- 4.9 kong的访问监控
- 4.9.1 解决方案
- 4.9.2 方案实施
- 4.9.3 接入grafana报表
- 5. 常见问题
- 5.1 默认账号及密码
- 5.2 新增用户默认密码为123456
- 5.3 如何设置超级管理员
- 5.4 密码忘记了咋办
- 6. Kong
- 6.1 Kong简介
- 6.2 kong安装指南
- 6.2.1 kong安装-RPM
- 6.2.2 kong安装-源码
- 6.2.3 kong基于yum源安装
- 6.3 Admin API
- 6.3.1 API支持两种内容类型
- 6.3.2 声明式配置(Declarative Configuration)
- 6.3.3 获取实体schema
- 6.3.4 services
- 6.3.5 Routes
- 6.3.6 Consumers
- 6.3.7 Plugins
- 6.3.8 Certficate
- 6.3.9 CA certficate(1.3.x+以上版本)
- 6.3.10 SNI
- 6.3.11 Upstreams
- 6.3.12 Targets
- 6.4 Kong使用
- 6.4.1 DB-LESS模式
- 6.4.2 DB模式