Rainbond文档中心
组件健康检测 编辑此页面

健康检测是为了真实的反应组件业务的运行状态。在不配置健康检测的情况下,组件的运行状态由容器(进程)状态决定,即容器启动成功则认为组件已经进入 Ready 状态。Ready 状态的组件实例将立即加入到流量处理中去。然而我们都清楚大部分程序业务都是需要启动时间的,从开始启动到准备好处理业务是一段时间的,一般越复杂的组件时间越长。还没有准备好的组件去接受了业务请求将导致部分请求失败。特别是在组件进行滚动升级过程中,对于无状态组件,平台进行了先启动新实例接受流量,再关闭旧实例的机制,如果组件健康状态未精确体现。滚动升级的效果将大打折扣。启动因此我们需要通过一种机制来尽可能的验证组件的真实状态,这就是组件健康检测。

目前组件健康检测支持以下两种机制:

  • TCP 端口检测 这种检测的方式是尝试与组件配置的端口建立 TCP 连接,若正常建立认为其处于健康状态。
  • HTTP 业务检测 端口建立监听也不能完全代表业务正常,因此对于 HTTP 类的服务,能够请求到指定的路由来根据状态码进行组件健康状态判断。这种模式更加精确。

组件启动后必须经过健康检测来表示组件状态,当组件处于不健康时,有两种处理方式:

  • 设置组件为不健康

当组件实例被设置成不健康,其将从应用网关和 ServiceMesh 网络下线。等待其工作正常后重新自动上线。但如果组件只有一个实例,Rainbond 不会将其下线。

  • 重启组件实例

有些组件可能由于代码阻塞等原因形成死锁进程,无法提供组件但进程依然运行。处理这类组件的不健康状态只能通过重启实例的方式。

因此用户可以根据业务状态来判断选择合适的处理方式。

操作流程

组件健康检测的配置在 组件控制面板/其他设置 页面中。

1.点击健康检测的编辑按钮,弹窗显示健康检测的配置项目。

  • 端口:选择组件进行健康检测的端口,若选项中不存在组件实际的检测端口,请到端口管理页面中进行添加。
  • 探针协议: 根据上文所述,协议选择支持 TCP 和 HTTP,选择不同的协议后续的设置项目有些不同。
  • 不健康处理方式: 默认为“下线”,可以选择“重启”。
  • HTTP 协议对应的设置项: 选择 HTTP 协议后可设置检测的路径和请求头(比如需要 Token 请求),注意该路由请求必须返回状态码小于 400 则认为为健康。
  • 初始化等候时间:是指开始检测前等待组件实例启动的时间,默认为 4 秒。
  • 检测间隔时间:是指连续两次检测任务的时间间隔。
  • 检测超时时间:如果检测请求时遇到问题请求被阻塞,超时时间将生效。
  • 连续成功次数:是指标记组件实例为健康状态时的连续检测成功的次数。

上述信息根据实际情况填写,保存后需要更新组件健康检测机制将生效。

2.启用/禁用健康检测

特殊情况下开发者可能需要临时禁用健康检测使组件一直处于健康状态。可以使用启用/禁用健康检测功能。修改后需要更新组件即可生效。

常见问题

  • 组件滚动更新过程中出现请求故障

出现此问题强烈建议设置更加精确的健康检测规则,比如选用 HTTP 模式。

  • 其他协议的组件如何设置健康检测

Mysql,Redis 等更多的应用层协议目前不支持精确检测,请选用 TCP 模式。后续我们将增加使用cmd的方式进行检测,可以对不同类型的组件进行较好的支持。