TokenService初始化的初始化由client/server两部分构成。
1.DefaultClusterTokenClient初始化
@1
注册server变更观察者,在server变更时回调changeServer方法,此处可以借鉴如何使用观察者模式。
调用时机
下面以示例中给出的例子为入口切入,观察server变更时的回调流程。
示例中使用动态数据源,在配置变更后执行getProperty().updateValue(newValue)让规则生效。
ClusterClientConfigManager通过静态方法clientAssignProperty注册ClientAssignPropertyListener,监听ClusterClientAssignConfig的变更,
主要是server地址和端口的变更
。
ClusterClientAssignConfig配置
serverHost:server地址serverPort:server端口
clientConfigProperty注册ClientConfigPropertyListener监听ClusterClientConfig的变更,
主要是超时时间
的变更。
ClusterClientConfig配置
requestTimeout:请求超时时间
重新连接server
小结
:client初始化时注册观察者,在server配置(server地址与端口)变更时通过netty重新连接到新的server地址。
@2
初始化新连接,此处并未真正与server建立连接
说明
:通过ClusterStatePropertyListener进行状态变更时触发与server的连接;ClusterStatePropertyListener在ClusterStateManager初始化时被添加到stateProperty,主要负责client、server角色的切换。
下面示例demo中,通过监听动态配置,来动态切换client与server,判断逻辑见下图备注。
小结
:监听client/server的动态配置,ClusterStatePropertyListener负责client/server的状态切换,即:如果本节点是server被变更为client,则先关闭server在启动client;反之同理。0表示client,1表示server,-1表示未启动。
2.DefaultEmbeddedTokenServer初始化
DefaultEmbeddedTokenServer启动时使用SentinelDefaultTokenServer。
@1注册观察者,通过动态数据源(zk、nacus等)监听serve端通信配置ServerTransportConfig配置的变更,有变更时重新启动server。
ServerTransportConfig配置信息
port:端口号idleSeconds:连接空闲时间,默认为600秒,超过会关闭连接
更新ServerTransportConfig生效由ClusterServerConfigManager#ServerGlobalTransportPropertyListener负责,用法见示例:
@2初始化集群流控server,使用netty通信
三、client/server交互
1.client发送令牌请求
@1构造请求参数FlowRequestData
flowId:流控规则ID全局唯一标识count:需要的令牌数量,例如:QPS请求数priority:优先级,如果当前时间窗口令牌不够,是否预占用下个时间窗口的令牌,默认false。
@2通信通过netty向server端请求,返回结果TokenResult参数
status:返回状态,见TokenResultStatus枚举类。remaining:集群流控剩余令牌的数量waitInMs:当prioritized设置为true时,下个时间窗口分配令牌,需要等待的时间,单位毫秒attachments:保留扩展字段,未使用
@3记录错误日志,日志文件为sentinel-cluster-client.log
2.server处理令牌请求
处理请求入口
处理请求过程
@1请求允许通过尝试,GlobalRequestLimiter负责执行。当监听到namespace有新增时,ServerNamespaceSetPropertyListener#configUpdate更新生效。
通过namespace获取全局RequestLimiter,默认10个采样窗口,统计区间为1秒。
ServerNamespaceSetPropertyListener更新过程
@1 集群流控为嵌入模式,默认将appName加入namespace@2 将过期失效的namespace流控规则移除@3 构建namespace、flowId、FlowRule、flowIdSet在缓存中的关系以及为每个flowId准备集群流控统计ClusterMetric,详见:FlowRulePropertyListener#applyClusterFlowRule@4 构建namespace、flowId、ParamFlowRule、flowIdSet在缓存中的关系以及为每个flowId准备集群热点参数流控统计ClusterParamMetric,详见:ParamRulePropertyListener#applyClusterParamRules@5 RequestLimiter初始化,GlobalRequestLimiter负责集群全局统计限速判断
@2根据flowId获取对应的集群流量统计信息ClusterMetric@3计算剩余的允许通过的令牌数 = 允许通过的令牌数阈值 * 限制倍数 - 已经使用的令牌 - 本次需要的令牌
允许通过的令牌数阈值
exceedCount:限制倍数,默认1.0,可由ServerFlowConfig#exceedCount设置latestQps:已经使用的令牌acquireCount:本次需要的令牌
@4剩余令牌大于等于0,允许通过返回OK
@5如果设置了优先级prioritized,会占用下个时间窗口的令牌
@6无令牌可用,统计被阻塞请求并记录日志
@7返回阻塞结果BLOCKED
四、返回结果处理
说明
OK:值为0,正产放行。允许通过
SHOULD_WAIT:值为2,当设置prioritized=true时预占下个时间窗口令牌需要等待的时间。允许通过
NO_RULE_EXISTS:值为3,缓存中根据flowId找不到FlowRule。不允许通过抛出FlowException
BAD_REQUEST:值为-4,flowId为null或者小于0,通过的请求count小于0,即入参问题。不允许通过抛出FlowException
FAIl:值为-1,内部发生异常了。不允许通过抛出FlowException
TOO_MANY_REQUEST:值为-2,本次请求直接超过设置允许的阈值,被拦回。不允许通过抛出FlowException
BLOCKED:值为1,请求被阻塞。不允许通过抛出FlowException
作者丨梁勇来源丨瓜农老梁欢迎关注公众号「瓜农老梁」
「瓜农老梁 学习同行」