sentinel整合控制台和动态规则
sentinel整合控制台和动态规则
控制台的下载和启动
首先可以到这个地址去下载控制台:
https://github.com/alibaba/Sentinel/releases/tag/v1.8.0
下载下来得到的是一个jar包,jar包启动命令:
java -Dserver.port=18080 -Dcsp.sentinel.dashboard.server=localhost:18080 -Dproject.name=sentinel-dashboard -jar sentinel-dashboard-1.8.0.jar
参数解析:
配置项 | 类型 | 默认值 | 最小值 | 描述 |
---|---|---|---|---|
auth.enabled | boolean | true | - | 是否开启登录鉴权,仅用于日常测试,生产上不建议关闭 |
sentinel.dashboard.auth.username | String | sentinel | - | 登录控制台的用户名,默认为 sentinel |
sentinel.dashboard.auth.password | String | sentinel | - | 登录控制台的密码,默认为 sentinel |
csp.sentinel.dashboard.server | String | 把信息上传到控制台上面。 |
注意:如果加了csp.sentinel.dashboard.server的话,才会有左面的sentine-dashboard选项的。sentine-dashboard其实就是我们指定的project-name,不过基本上控制台还是别加了这个,因为没什么意义。
sentinel整合控制台:
spring-boot层面的整合
pom.xml添加依赖:
<dependency>
<groupId>com.alibaba.csp</groupId>
<artifactId>sentinel-transport-simple-http</artifactId>
<version>${sentinel.version}</version>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
<version>${spring-boot.version}</version>
</dependency>
<dependency>
<groupId>com.alibaba.csp</groupId>
<artifactId>sentinel-web-servlet</artifactId>
<version>${sentinel.version}</version>
</dependency>
启动类:
@SpringBootApplication
public class DemoApplication implements ApplicationContextAware {
static {
System.setProperty("csp.sentinel.dashboard.server","localhost:18080"); //指定控制台的地址
System.setProperty("project.name","sentinel-boot"); //指定sentinel的名字
}
public static ApplicationContext applicationContext;
public static void main(String[] args) {
SpringApplication.run(DemoApplication.class,args);
}
}
注意:启动时加入 JVM 参数 -Dcsp.sentinel.dashboard.server=consoleIp:port
指定控制台地址和端口。若启动多个应用,则需要通过 -Dcsp.sentinel.api.port=xxxx
指定客户端监控 API 的端口(默认是 8719)。如果没有设置api端口而且8719端口被占用的话,他会往8719端口开始递增。直到找到没有占用的端口为止
配置类,需要加上这个过滤器来做监控:
@Configuration
public class FilterConfig {
@Bean
public FilterRegistrationBean sentinelFilterRegistration() {
FilterRegistrationBean<Filter> registration = new FilterRegistrationBean<>();
registration.setFilter(new CommonFilter());
registration.addUrlPatterns("/*");
registration.setName("sentinelFilter");
registration.setOrder(1);
return registration;
}
}
contorller端:
@RestController
@RequestMapping("/web")
public class WebController {
@GetMapping("/sayhello")
public String sayhello(){
return "sayhello";
}
}
效果如下:
注意:
-
需要发送一个请求到http://127.0.0.1:8888/web/sayhello才能显示出来
-
有人就会问了,规则是包含了:资源名字和一些规则的参数的。比如我定义了一个hello的资源名,规则是qps=2,失败策略是快速失败,但是我代码中都没有引用这个hello资源名啊。如果是web服务的话,比如我们上面路径是/web/sayHello,我们可以直接定义/web/sayhello为资源名。然后配置规则,他也能对/web/sayhello这个路径起到流控控制的作用
-
如果在sentinel内置的规则也能显示在控制台的页面上。
效果如下:
我们可以通过去页面上配置规则就可以达到动态的修改规则了。但是很遗憾的是:修改完的规则只能保存到sentinel(不是控制台)的内存中。当sentinel重新启动后,这些规则就会丢失掉。如果我们需要存起来的话,请看跟nacos的结合
spring-cloud层面的整合
跟spring-cloud结合就简单很多了。
引入依赖:
<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>spring-cloud-starter-alibaba-sentinel</artifactId>
</dependency>
application.yml文件配置:
spring:
cloud:
sentinel:
transport:
port: 8719 #指定客户端监控 API 的端口
dashboard: localhost:18080 #控制台的地址
application:
name: sentinel-cloud
server:
port: 8701
只需要这么一配置就可以实现和控制台整合了。如果项目是spirng-cloud的话,建议直接使用这个整合就性了。
sentinel整合nacos
nacos有配置中心的功能,只要我们sentinel这边监听nacos的配置信息的变化(配置信息就是规则信息)。就可以实现了动态调整sentinel的规则了。并且再次启动的时候,我们是直接读取nacos上的配置信息。所以能起到一个持久化的作用。
需要的依赖如下:
<dependencies>
<dependency>
<groupId>com.alibaba.csp</groupId>
<artifactId>sentinel-core</artifactId>
</dependency>
<dependency>
<groupId>com.alibaba.csp</groupId>
<artifactId>sentinel-datasource-nacos</artifactId>
</dependency>
<dependency>
<groupId>com.alibaba.csp</groupId>
<artifactId>sentinel-datasource-extension</artifactId>
</dependency>
</dependencies>
动态规则的配置
private static String serverAddr = "localhost:8848";
private static String groupId = "Sentinel:Demo";
private static String dataId = "flowRule:nacos-demo";
//读取nacos里面的规则并且使用这规则
public static void loadRule(){
ReadableDataSource dataSource = new NacosDataSource(serverAddr, groupId, dataId, new Converter<String, List<FlowRule>>() {
//把nacos读到的信息,转成List<FlowRule>
@Override
public List<FlowRule> convert(String source) {
// List<FlowRule> flowRules = JSONObject.parseObject(s, new TypeReference<List<FlowRule>>() {});
return JSONObject.parseArray(s, FlowRule.class);
}
});
FlowRuleManager.register2Property(dataSource.getProperty());
}
原理其实就是:监听groupId是Sentinel:Demo,dataId是flowRule:nacos-demo的配置信息,如果nacos上该配置信息改变的时候就会触发convert方法。入参的字符串其实就是nacos上的配置信息,只要我们把配置信息转换成相应的规则返回就能达到效果了
效果如下:
当我们启动项目或者修改nacos的配置文件,就会触发convert方法。上面就是触发传入的s是什么的效果图。
这是我发送到nacos的配置的测试类:
public class NacosConfigSender {
//设置配置的规则到nacos上。 groupId: Sentinel:Demo dataId: com.alibaba.csp.sentinel.demo.flow.rule
public static void main(String[] args) throws Exception {
final String remoteAddress = "localhost";
final String groupId = "Sentinel:Demo";
final String dataId = "flowRule:nacos-demo";
final String rule = "[\n"
+ " {\n"
+ " \"resource\": \"TestResource\",\n"
+ " \"controlBehavior\": 0,\n"
+ " \"count\": 5.0,\n"
+ " \"grade\": 1,\n"
+ " \"limitApp\": \"default\",\n"
+ " \"strategy\": 0\n"
+ " }\n"
+ "]";
ConfigService configService = NacosFactory.createConfigService(remoteAddress);
System.out.println(configService.publishConfig(dataId, groupId, rule));
}
}
sentinel整合控制台和nacos
整体的架构就像上面的图片一样。首先:
- sentinel控制台在页面上修改了规则后,然后把该规则发送到nacos的配置中心上
- 因为sentinel客户端监听了nacos上面的配置中心,所以就能等到修改后的规则,从而得到动态修改规则。
但是官方提供的sentinel的jar包不支持这个功能。需要我们去修改一下它的源吗,不过也是很简单的。不需要担心,如果不想自己写的话,可以直接要我的修改完的sentinel控制台。地址:https://gitee.com/gzgyc/sentinel-dashboard.git
下面我就说一下怎么改造把。官方提供了流量控制的例子:
1.rule目录下提供了nacos,apollo,zookeeper这些官方例子,我们先把nacos这个官方例子目录移到上面去先
2.然后在pom.xml文件里,去掉这个
3.修改FlowControllerV2文件。把publisher和provider修改成nacos的
4.sidebar.html 流控规则路由从 dashboard.flowV1 改成 dashboard.flow 即可
控制台改造完成,启动即可(这个只是修改了流量控制的规则而已,其他的规则可以看我的github)。
注意点:
-
上面控制台的改造的点有:
-
添加了FlowControllerV2,这个类地址是/v2/flow。
-
前端那里把dashboard.flowV1 改成 dashboard.flow,即是让前端请求FlowControllerV2,下面是源码的截图
-
-
要留意页面是否发送请求的是/v2/flow前缀。可以看到下图为啥有个单机页面,单机页面其实就是没有结合nacos的时候功能。所以千万要注意这个位置。注意:基于上面的这个改造,单机页面是没有回到单机页面这个按钮的。
问题:规则会保存到nacos的哪个groupId,dataId中:
答:由下图可以知道是groupId: "SENTINEL_GROUP" , dataId: appName + "-flow-rules"。
只要我们sentinel的客户端监听这个groupId和dataId就可以了。所以代码如下:
@Configuration
public class NacosConfig {
//读取nacos里面的规则并且使用这规则
@PostConstruct
public static void loadRule(){
String serverAddr = "localhost:8848";
String groupId = "SENTINEL_GROUP";
String dataId = "sentinel-nacos-dashboard-flow-rules";
ReadableDataSource dataSource = new NacosDataSource(serverAddr, groupId, dataId, new Converter<String, List<FlowRule>>() {
//把nacos读到的信息,转成List<FlowRule>
@Override
public List<FlowRule> convert(String s) {
// List<FlowRule> flowRules = JSONObject.parseObject(s, new TypeReference<List<FlowRule>>() {});
return JSONObject.parseArray(s, FlowRule.class);
}
});
FlowRuleManager.register2Property(dataSource.getProperty());
}
}
注意:这里只是改造了流量控制而已,其他的规则还没有规则。想要改造其他的规则,可以看我改造的控制台代码。
简单谈谈改造降级策略的控制台应该怎么搞
查询操作:
这个类我是参考flowRuleNacosProvider类写的。
改造前的逻辑:
- sentinelApiClient.fetchDegradeRuleOfMachine(app, ip, port): 跟sentinel客户端通讯拿到客户端上面的规则
- repository.saveAll(rules): 把拿到的规则保存到自己的内存中
改造后的逻辑:
- ruleProvider.getRules(app): 直接去nacos上面拿取。然后返回
增删改操作:
改造前:
- 对内存中的规则进行增删改操作
- 增删改操作成功后,获取该appName的所有的降级熔断规则,然后跟sentinel客户端通讯,推送最新的规则给sentinel客户端。
改造后:
- 对内存中的规则进行增删改操作
- 增删改操作成功后,获取该appName的所有的降级熔断规则,推送到nacos上。
具体的看我的gitee:
控制台的地址:https://gitee.com/gzgyc/sentinel-dashboard.git
sentinel代码地址:https://gitee.com/gzgyc/dubbo-demo.git