官方文档:https://github.com/alibaba/spring-cloud-alibaba/blob/master/spring-cloud-alibaba-examples/sentinel-example/sentinel-core-example/readme-zh.md
什么是流量控制?
流量控制在网络传输中是一个常用的概念,它用于调整网络包的发送数据。然而,从系统稳定性角度考虑,在处理请求的速度上,也有非常多的讲究。任意时间到来的请求往往是随机不可控的,而系统的处理能力是有限的。我们需要根据系统的处理能力对流量进行控制。Sentinel 作为一个调配器,可以根据需要把随机的请求调整成合适的形状,如下图所示:
流量控制设计理念
流量控制有以下几个角度:
资源的调用关系,例如资源的调用链路,资源和资源之间的关系;
运行指标,例如 QPS( Query Per Second)、线程池、系统负载等;
控制的效果,例如直接限流、冷启动、排队等。
Sentinel 的设计理念是让您自由选择控制的角度,并进行灵活组合,从而达到想要的效果。
Sentinel starter 完成 Spring Cloud 应用的限流管理步骤:
- 接入 Sentinel
(1)引入 Sentinel starter
<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>spring-cloud-starter-alibaba-sentinel</artifactId>
</dependency>
(2)接入限流埋点
<1>HTTP 埋点
Sentinel starter 默认为所有的 HTTP 服务提供了限流埋点,如果只想对 HTTP 服务进行限流,那么只需要引入依赖,无需修改代码。
<2>自定义埋点
如果需要对某个特定的方法进行限流或降级,可以通过 @SentinelResource 注解来完成限流的埋点,示例代码如下:
@SentinelResource("resource")
public String hello() {
return "Hello";
}
当然也可以通过原始的 SphU.entry(xxx) 方法进行埋点,可以参见 Sentinel 文档( 如何使用 · alibaba/Sentinel Wiki · GitHub#%E5%AE%9A%E4%B9%89%E8%B5%84%E6%BA%90)。
(3)配置限流规则
Sentinel 提供了两种配置限流规则的方式:代码配置 和 控制台配置。
-
通过代码来实现限流规则的配置。一个简单的限流规则配置示例代码如下,更多限流规则配置详情请参考 Sentinel 文档。(如何使用 · alibaba/Sentinel Wiki · GitHub#%E5%AE%9A%E4%B9%89%E8%A7%84%E5%88%99)
List<FlowRule> rules = new ArrayList<FlowRule>();
FlowRule rule = new FlowRule();
rule.setResource(str);
// set limit qps to 10
rule.setCount(10);
rule.setGrade(RuleConstant.FLOW_GRADE_QPS);
rule.setLimitApp("default");
rules.add(rule);
FlowRuleManager.loadRules(rules);
- 启动 Sentinel 控制台
(1) 首先需要获取 Sentinel 控制台,支持直接下载和源码构建两种方式。
I 直接下载: http://edas-public.oss-cn-hangzhou.aliyuncs.com/install_package/demo/sentinel-dashboard.jar
II 源码构建: 进入 Sentinel Github 项目页面,将代码 git clone 到本地自行编译打包,参考此文档。
(2)启动控制台,执行 Java 命令 java -jar sentinel-dashboard.jar 完成 Sentinel 控制台的启动。 控制台默认的监听端口为 8080。
配置控制台启动的虚拟机参数:
java -Dserver.port=8087 -Dcsp.sentinel.dashboard.server=localhost:8087 -Dproject.name=sentinel-dashboard -jar sentinel-dashboard.jar
- 启动应用并配置
增加配置,在应用的 /src/main/resources/application.properties 中添加基本配置信息,并启动springboot 应用
spring.application.name=sentinel-example
server.port=18083
spring.cloud.sentinel.transport.dashboard=localhost:8087
添加依赖:
<!--Transport 模块来与 Sentinel 控制台进行通信-->
<dependency>
<groupId>com.alibaba.csp</groupId>
<artifactId>sentinel-transport-simple-http</artifactId>
</dependency>
- 控制台配置限流规则并验证
(1)访问 http://localhost:8087 页面。
注意:如果在控制台没有找到应用,请调用一下进行了 Sentinel 埋点的 URL 或方法,因为Sentinel 使用了 lazy load 策略。
(2)任意发送请求,可以在簇点链路里面看到刚才的请求,可以对请求进行流控;
(3)测试流控效果