Client side health check¶
概述¶
客户端健康检查(Health Check)是指客户端对服务端实例缓存进行健康性的判断。
在网络分区或延时较大的环境下,客户端可能会出现上报心跳到服务中心失败的情况。导致结果是客户端会收到实例下线事件,并移除本地实例缓存,最终影响业务调用。
为防止上述情况发生,go-chassis提供这样的健康检查机制:当客户端监听到某个(或latest)版本的服务端可用实例下降到0个时, 客户端会在同步移除实例缓存前进行一次健康检查,调用服务端暴露的健康检查接口(RESTful)并校验其返回值来确认是否要移除实例缓存。
配置¶
服务端注册¶
go-chassis默认不会主动注册服务端的健康检查接口,需要用户主动import到项目中。
// 注册健康检查接口
import _ "github.com/go-chassis/go-chassis/v2/healthz/provider"
加入上述代码片段后,go-chassis会按照暴露的服务协议类型对应注册健康检查接口,接口描述如下
RESTful:
Method: GET
Path: /healthz
Response:
{ "appId": "string", "serviceName": "string", "version": "string" }
客户端配置¶
客户端健康检查配置在chassis.yaml。
healthCheck
(optional, bool) 允许对服务端的实例做健康检查,默认值为false。
示例¶
servicecomb:
registry:
healthCheck: true