3.Sentinel实现熔断与限流

Spring Cloud Alibaba 致力于提供微服务开发的一站式解决方案&＃xff0c;Sentinel 作为其核心组件之一&＃xff0c;具有熔断与限流等一系列服务保护功能&＃xff0c;本文将对其用法进行详细介绍。

https://github.com/alibaba/Sentinel/wiki/%E4%B8%BB%E9%A1%B5

https://github.com/alibaba/spring-cloud-alibaba/wiki/Sentinel

1. Sentinel简介

随着微服务的流行&＃xff0c;服务和服务之间的稳定性变得越来越重要。 Sentinel 以流量为切入点&＃xff0c;从流量控制、熔断降级、系统负载保护等多个维度保护服务的稳定性。

Sentinel具有如下特性:

• 丰富的应用场景&＃xff1a;承接了阿里巴巴近 10 年的双十一大促流量的核心场景&＃xff0c;例如秒杀&＃xff0c;可以实时熔断下游不可用应用&＃xff1b;
• 完备的实时监控&＃xff1a;同时提供实时的监控功能。可以在控制台中看到接入应用的单台机器秒级数据&＃xff0c;甚至 500 台以下规模的集群的汇总运行情况&＃xff1b;
• 广泛的开源生态&＃xff1a;提供开箱即用的与其它开源框架/库的整合模块&＃xff0c;例如与 Spring Cloud、Dubbo、gRPC 的整合&＃xff1b;
• 完善的 SPI 扩展点&＃xff1a;提供简单易用、完善的 SPI 扩展点。您可以通过实现扩展点&＃xff0c;快速的定制逻辑。

2. 安装Sentinel控制台

Sentinel控制台是一个轻量级的控制台应用&＃xff0c;它可用于实时查看单机资源监控及集群资源汇总&＃xff0c;并提供了一系列的规则管理功能&＃xff0c;如流控规则、降级规则、热点规则等。

2.1 下载jar

• 我们先从官网下载Sentinel&＃xff0c;这里下载的是sentinel-dashboard-1.6.3.jar文件&＃xff0c;下载地址&＃xff1a;Releases · alibaba/Sentinel · GitHub

• 下载完成后在命令行输入如下命令运行Sentinel控制台&＃xff1a;

java -Dserver.port&＃61;8080 -Dcsp.sentinel.dashboard.server&＃61;localhost:8080 -Dproject.name&＃61;sentinel-dashboard -jar sentinel-dashboard.jar


其中 -Dserver.port&＃61;8080 用于指定 Sentinel 控制台端口为 8080。

2.2 打包为jar

https://github.com/alibaba/Sentinel/tree/master/sentinel-dashboard

使用如下命令将代码打包成一个 fat jar:

mvn clean package

使用如下命令启动编译后的控制台&＃xff1a;

java -Dserver.port&＃61;8080 -Dcsp.sentinel.dashboard.server&＃61;localhost:8080 -Dproject.name&＃61;sentinel-dashboard \
-jar target/sentinel-dashboard.jar

• 上述命令中我们指定几个 JVM 参数&＃xff0c;其中 -Dserver.port&＃61;8080 是 Spring Boot 的参数&＃xff0c; 用于指定 Spring Boot 服务端启动端口为 8080。其余几个是 Sentinel 客户端的参数。

2.3 登陆

• Sentinel控制台默认运行在8080端口上&＃xff0c;登录账号密码均为sentinel&＃xff0c;通过如下地址可以进行访问&＃xff1a;http://localhost:8080 

 注意&＃xff1a;配置了后需要先访问一次&＃xff0c;才能被检测到

3. 创建sentinel-service模块

这里我们创建一个sentinel-service模块&＃xff0c;用于演示Sentinel的熔断与限流功能。

• 在pom.xml中添加相关依赖&＃xff0c;这里我们使用Nacos作为注册中心&＃xff0c;所以需要同时添加Nacos的依赖&＃xff1a;

com.alibaba.cloudspring-cloud-starter-alibaba-nacos-discovery

com.alibaba.cloudspring-cloud-starter-alibaba-sentinel
com.alibaba.cloudspring-cloud-alibaba-dependencies2.2.1.RELEASEpomimport


• 在application.yml中添加相关配置&＃xff0c;主要是配置了Nacos和Sentinel控制台的地址&＃xff1a;

server:port: 8401
spring:application:name: sentinel-servicecloud:nacos:discovery:server-addr: localhost:8848 #配置Nacos地址sentinel:transport:dashboard: localhost:8080 #配置sentinel dashboard地址port: 8719
service-url:user-service: http://nacos-user-service
management:endpoints:web:exposure:include: &＃39;*&＃39;


4. 限流功能

Sentinel Starter 默认为所有的 HTTP 服务提供了限流埋点&＃xff0c;我们也可以通过使用&＃64;SentinelResource来自定义一些限流行为。

4.1 创建RateLimitController类

用于测试熔断和限流功能。

&＃64;RestController
&＃64;RequestMapping("/rateLimit")
public class RateLimitController {/*** 按资源名称限流&＃xff0c;需要指定限流处理逻辑*/&＃64;GetMapping("/byResource")&＃64;SentinelResource(value &＃61; "byResource",blockHandler &＃61; "handleException")public CommonResult byResource() {return new CommonResult("按资源名称限流", 200);}/*** 按URL限流&＃xff0c;有默认的限流处理逻辑*/&＃64;GetMapping("/byUrl")&＃64;SentinelResource(value &＃61; "byUrl",blockHandler &＃61; "handleException")public CommonResult byUrl() {return new CommonResult("按url限流", 200);}public CommonResult handleException(BlockException exception){return new CommonResult(exception.getClass().getCanonicalName(),200);}}


 4.2 根据资源名称限流

我们可以根据&＃64;SentinelResource注解中定义的value&＃xff08;资源名称&＃xff09;来进行限流操作&＃xff0c;但是需要指定限流处理逻辑。

https://github.com/alibaba/Sentinel/wiki/%E6%B3%A8%E8%A7%A3%E6%94%AF%E6%8C%81

&＃64;SentinelResource 注解

注意&＃xff1a;注解方式埋点不支持 private 方法。

&＃64;SentinelResource 用于定义资源&＃xff0c;并提供可选的异常处理和 fallback 配置项。 &＃64;SentinelResource 注解包含以下属性&＃xff1a;

• value&＃xff1a;资源名称&＃xff0c;必需项&＃xff08;不能为空&＃xff09;
• entryType&＃xff1a;entry 类型&＃xff0c;可选项&＃xff08;默认为 EntryType.OUT&＃xff09;
• blockHandler / blockHandlerClass: blockHandler 对应处理 BlockException 的函数名称&＃xff0c;可选项。blockHandler 函数访问范围需要是 public&＃xff0c;返回类型需要与原方法相匹配&＃xff0c;参数类型需要和原方法相匹配并且最后加一个额外的参数&＃xff0c;类型为 BlockException。blockHandler 函数默认需要和原方法在同一个类中。若希望使用其他类的函数&＃xff0c;则可以指定 blockHandlerClass 为对应的类的 Class 对象&＃xff0c;注意对应的函数必需为 static 函数&＃xff0c;否则无法解析。
• fallback / fallbackClass&＃xff1a;fallback 函数名称&＃xff0c;可选项&＃xff0c;用于在抛出异常的时候提供 fallback 处理逻辑。fallback 函数可以针对所有类型的异常&＃xff08;除了 exceptionsToIgnore 里面排除掉的异常类型&＃xff09;进行处理。fallback 函数签名和位置要求&＃xff1a;
  • 返回值类型必须与原函数返回值类型一致&＃xff1b;
  • 方法参数列表需要和原函数一致&＃xff0c;或者可以额外多一个 Throwable 类型的参数用于接收对应的异常。
  • fallback 函数默认需要和原方法在同一个类中。若希望使用其他类的函数&＃xff0c;则可以指定 fallbackClass 为对应的类的 Class 对象&＃xff0c;注意对应的函数必需为 static 函数&＃xff0c;否则无法解析。
• defaultFallback&＃xff08;since 1.6.0&＃xff09;&＃xff1a;默认的 fallback 函数名称&＃xff0c;可选项&＃xff0c;通常用于通用的 fallback 逻辑&＃xff08;即可以用于很多服务或方法&＃xff09;。默认 fallback 函数可以针对所有类型的异常&＃xff08;除了 exceptionsToIgnore 里面排除掉的异常类型&＃xff09;进行处理。若同时配置了 fallback 和 defaultFallback&＃xff0c;则只有 fallback 会生效。defaultFallback 函数签名要求&＃xff1a;
  • 返回值类型必须与原函数返回值类型一致&＃xff1b;
  • 方法参数列表需要为空&＃xff0c;或者可以额外多一个 Throwable 类型的参数用于接收对应的异常。
  • defaultFallback 函数默认需要和原方法在同一个类中。若希望使用其他类的函数&＃xff0c;则可以指定 fallbackClass 为对应的类的 Class 对象&＃xff0c;注意对应的函数必需为 static 函数&＃xff0c;否则无法解析。
• exceptionsToIgnore&＃xff08;since 1.6.0&＃xff09;&＃xff1a;用于指定哪些异常被排除掉&＃xff0c;不会计入异常统计中&＃xff0c;也不会进入 fallback 逻辑中&＃xff0c;而是会原样抛出。

注&＃xff1a;1.6.0 之前的版本 fallback 函数只针对降级异常&＃xff08;DegradeException&＃xff09;进行处理&＃xff0c;不能针对业务异常进行处理。

特别地&＃xff0c;若 blockHandler 和 fallback 都进行了配置&＃xff0c;则被限流降级而抛出 BlockException 时只会进入 blockHandler 处理逻辑。若未配置 blockHandler、fallback 和 defaultFallback&＃xff0c;则被限流降级时会将 BlockException 直接抛出&＃xff08;若方法本身未定义 throws BlockException 则会被 JVM 包装一层 UndeclaredThrowableException&＃xff09;。

• 流控规则可以在Sentinel控制台进行配置&＃xff0c;由于我们使用了Nacos注册中心&＃xff0c;我们先启动Nacos和sentinel-service&＃xff1b;

• 由于Sentinel采用的懒加载规则&＃xff0c;需要我们先访问下接口&＃xff0c;Sentinel控制台中才会有对应服务信息&＃xff0c;我们先访问下该接口&＃xff1a;http://localhost:8401/rateLimit/byResource

• 在Sentinel控制台配置流控规则&＃xff0c;根据&＃64;SentinelResource注解的value值&＃xff1a;

• 快速访问上面的接口&＃xff0c;可以发现返回了自己定义的限流处理信息&＃xff1a;

 4.3 根据URL限流

我们还可以通过访问的URL来限流&＃xff0c;会返回默认的限流处理信息。

• 在Sentinel控制台配置流控规则&＃xff0c;使用访问的URL&＃xff1a;
• 配置 URL 限流规则&＃xff1a;点击新增流控规则&＃xff0c;资源名填写需要限流的 URL 相对路径&＃xff0c;单机阈值选择需要限流的阈值&＃xff0c;点击新增进行确认。(为了便于演示效果&＃xff0c;这里将值设置成了 1)。

• 多次访问该接口&＃xff0c;会返回默认的限流处理结果&＃xff1a;http://localhost:8401/rateLimit/byUrl
• 

 4.4 自定义限流处理逻辑

我们可以自定义通用的限流处理逻辑&＃xff0c;然后在&＃64;SentinelResource中指定。

• 创建CustomBlockHandler类用于自定义限流处理逻辑&＃xff1a;

public class CustomBlockHandler {public CommonResult handleException(BlockException exception){return new CommonResult("自定义限流信息",200);}
}


• 在RateLimitController中使用自定义限流处理逻辑&＃xff1a;


&＃64;RestController
&＃64;RequestMapping("/rateLimit")
public class RateLimitController {/*** 自定义通用的限流处理逻辑*/&＃64;GetMapping("/customBlockHandler")&＃64;SentinelResource(value &＃61; "customBlockHandler", blockHandler &＃61; "handleException",blockHandlerClass &＃61; CustomBlockHandler.class)public CommonResult blockHandler() {return new CommonResult("限流成功", 200);}}


4.5 流量控制规则 (FlowRule)

5. 熔断功能

5.1 功能演示

Sentinel 支持对服务间调用进行保护&＃xff0c;对故障应用进行熔断操作&＃xff0c;这里我们使用RestTemplate来调用nacos-user-service服务所提供的接口来演示下该功能。

• 首先我们需要使用&＃64;SentinelRestTemplate来包装下RestTemplate实例&＃xff1a;
• Spring Cloud Alibaba Sentinel 支持对 RestTemplate 的服务调用使用 Sentinel 进行保护&＃xff0c;在构造 RestTemplate bean的时候需要加上 &＃64;SentinelRestTemplate 注解。
• 先看一下官网示例&＃xff1a;

&＃64;Bean
&＃64;SentinelRestTemplate(blockHandler &＃61; "handleException", blockHandlerClass &＃61; ExceptionUtil.class)
public RestTemplate restTemplate() {return new RestTemplate();
}&＃64;SentinelRestTemplate 注解的属性支持限流(blockHandler, blockHandlerClass)和降级(fallback, fallbackClass)的处理。其中 blockHandler 或 fallback 属性对应的方法必须是对应 blockHandlerClass 或 fallbackClass 属性中的静态方法。该方法的参数跟返回值跟 org.springframework.http.client.ClientHttpRequestInterceptor#interceptor 方法一致&＃xff0c;其中参数多出了一个 BlockException 参数用于获取 Sentinel 捕获的异常。比如上述 &＃64;SentinelRestTemplate 注解中 ExceptionUtil 的 handleException 属性对应的方法声明如下&＃xff1a;public class ExceptionUtil {public static ClientHttpResponse handleException(HttpRequest request, byte[] body, ClientHttpRequestExecution execution, BlockException exception) {...}
}
--------------------------
Note
应用启动的时候会检查 &＃64;SentinelRestTemplate 注解对应的限流或降级方法是否存在&＃xff0c;如不存在会抛出异常
&＃64;SentinelRestTemplate 注解的限流(blockHandler, blockHandlerClass)和降级(fallback, fallbackClass)属性不强制填写。当使用 RestTemplate 调用被 Sentinel 熔断后&＃xff0c;会返回 RestTemplate request block by sentinel 信息&＃xff0c;或者也可以编写对应的方法自行处理返回信息。这里提供了 SentinelClientHttpResponse 用于构造返回信息。Sentinel RestTemplate 限流的资源规则提供两种粒度&＃xff1a;httpmethod:schema://host:port/path&＃xff1a;协议、主机、端口和路径httpmethod:schema://host:port&＃xff1a;协议、主机和端口Note
以 https://www.taobao.com/test 这个 url 并使用 GET 方法为例。对应的资源名有两种粒度&＃xff0c;分别是 GET:https://www.taobao.com 以及 GET:https://www.taobao.com/test

• 开始自己示例


&＃64;Configuration
public class RibbonConfig {&＃64;Bean&＃64;SentinelRestTemplatepublic RestTemplate restTemplate(){return new RestTemplate();}
}


• 添加CircleBreakerController类&＃xff0c;定义对nacos-user-service提供接口的调用&＃xff1a;

/*** 熔断功能* Created by macro on 2019/11/7.*/
&＃64;RestController
&＃64;RequestMapping("/breaker")
public class CircleBreakerController {private Logger LOGGER &＃61; LoggerFactory.getLogger(CircleBreakerController.class);&＃64;Autowiredprivate RestTemplate restTemplate;&＃64;Value("${service-url.user-service}")private String userServiceUrl;&＃64;RequestMapping("/fallback/{id}")&＃64;SentinelResource(value &＃61; "fallback",fallback &＃61; "handleFallback")public CommonResult fallback(&＃64;PathVariable Long id) {return restTemplate.getForObject(userServiceUrl &＃43; "/user/{1}", CommonResult.class, id);}&＃64;RequestMapping("/fallbackException/{id}")&＃64;SentinelResource(value &＃61; "fallbackException",fallback &＃61; "handleFallback2", exceptionsToIgnore &＃61; {NullPointerException.class})public CommonResult fallbackException(&＃64;PathVariable Long id) {if (id &＃61;&＃61; 1) {throw new IndexOutOfBoundsException();} else if (id &＃61;&＃61; 2) {throw new NullPointerException();}return restTemplate.getForObject(userServiceUrl &＃43; "/user/{1}", CommonResult.class, id);}public CommonResult handleFallback(Long id) {User defaultUser &＃61; new User(-1L, "defaultUser", "123456");return new CommonResult<>(defaultUser,"服务降级返回",200);}public CommonResult handleFallback2(&＃64;PathVariable Long id, Throwable e) {LOGGER.error("handleFallback2 id:{},throwable class:{}", id, e.getClass());User defaultUser &＃61; new User(-2L, "defaultUser2", "123456");return new CommonResult<>(defaultUser,"服务降级返回",200);}
}


• 启动nacos-user-service和sentinel-service服务&＃xff1a;

• 由于我们并没有在nacos-user-service中定义id为4的用户&＃xff0c;所有访问如下接口会返回服务降级结果&＃xff1a;http://localhost:8401/breaker/fallback/4

• 

• 由于我们使用了exceptionsToIgnore参数忽略了NullPointerException&＃xff0c;所以我们访问接口报空指针时不会发生服务降级&＃xff1a;http://localhost:8401/breaker/fallbackException/2
• 

5.2 熔断降级规则 (DegradeRule)

6. 与Feign结合使用

推荐阅读&＃xff1a;Feign整合Sentinel实现容错_陈家宝的博客-CSDN博客https://blog.csdn.net/qq_31155349/article/details/108543571

方案一&＃xff1a;直接继承被容错的接口&＃xff0c;并为每个方法实现容错方案
package cn.jack.fallback;import cn.jack.domain.Product;
import cn.jack.service.ProductService;
import lombok.extern.slf4j.Slf4j;
import org.springframework.stereotype.Component;&＃64;Component
&＃64;Slf4j
public class ProductServiceFallback implements ProductService {&＃64;Overridepublic Product findByPid(Long pid) {Product product &＃61; new Product();product.setPid(-100);product.setPname("远程服务调用出现问题了。");return product;}
}
-------------------------------------
方案二&＃xff1a;实现FallbackFactory接口(***) import cn.jack.domain.Product;
import cn.jack.service.ProductService;
import feign.hystrix.FallbackFactory;
import lombok.extern.slf4j.Slf4j;
import org.springframework.stereotype.Component;&＃64;Component
&＃64;Slf4j
public class ProductServiceFallbackFactory implements FallbackFactory {&＃64;Overridepublic ProductService create(Throwable throwable) {// lambda表达式可以用于简化创建匿名内部类对象&＃xff08;前提是该接口为函数式接口&＃xff0c;即只有一个抽象方法&＃xff09;return (Long pid) -> {log.error("{}", throwable);Product product &＃61; new Product();product.setPid(-100);product.setPname("远程服务调用出现问题了。 --byFactory");return product;};}
}

Sentinel也适配了Feign组件&＃xff0c;我们使用Feign来进行服务间调用时&＃xff0c;也可以使用它来进行熔断。

• 首先我们需要在pom.xml中添加Feign相关依赖&＃xff1a;

org.springframework.cloudspring-cloud-starter-openfeign


• 在application.yml中打开Sentinel对Feign的支持&＃xff1a;

feign:sentinel:enabled: true #打开sentinel对feign的支持

• 在应用启动类上添加&＃64;EnableFeignClients启动Feign的功能&＃xff1b;

• 创建一个UserService接口&＃xff0c;用于定义对nacos-user-service服务的调用&＃xff1a;

/*** Created by macro on 2019/9/5.*/
&＃64;FeignClient(value &＃61; "nacos-user-service",fallback &＃61; UserFallbackService.class)
public interface UserService {&＃64;PostMapping("/user/create")CommonResult create(&＃64;RequestBody User user);&＃64;GetMapping("/user/{id}")CommonResult getUser(&＃64;PathVariable Long id);&＃64;GetMapping("/user/getByUsername")CommonResult getByUsername(&＃64;RequestParam String username);&＃64;PostMapping("/user/update")CommonResult update(&＃64;RequestBody User user);&＃64;PostMapping("/user/delete/{id}")CommonResult delete(&＃64;PathVariable Long id);
}


• 创建UserFallbackService类实现UserService接口&＃xff0c;用于处理服务降级逻辑&＃xff1a;

/*** Created by macro on 2019/9/5.*/
&＃64;Component
public class UserFallbackService implements UserService {&＃64;Overridepublic CommonResult create(User user) {User defaultUser &＃61; new User(-1L, "defaultUser", "123456");return new CommonResult<>(defaultUser,"服务降级返回",200);}&＃64;Overridepublic CommonResult getUser(Long id) {User defaultUser &＃61; new User(-1L, "defaultUser", "123456");return new CommonResult<>(defaultUser,"服务降级返回",200);}&＃64;Overridepublic CommonResult getByUsername(String username) {User defaultUser &＃61; new User(-1L, "defaultUser", "123456");return new CommonResult<>(defaultUser,"服务降级返回",200);}&＃64;Overridepublic CommonResult update(User user) {return new CommonResult("调用失败&＃xff0c;服务被降级",500);}&＃64;Overridepublic CommonResult delete(Long id) {return new CommonResult("调用失败&＃xff0c;服务被降级",500);}
}


• 在UserFeignController中使用UserService通过Feign调用nacos-user-service服务中的接口&＃xff1a;

/*** Created by macro on 2019/8/29.*/
&＃64;RestController
&＃64;RequestMapping("/user")
public class UserFeignController {&＃64;Autowiredprivate UserService userService;&＃64;GetMapping("/{id}")public CommonResult getUser(&＃64;PathVariable Long id) {return userService.getUser(id);}&＃64;GetMapping("/getByUsername")public CommonResult getByUsername(&＃64;RequestParam String username) {return userService.getByUsername(username);}&＃64;PostMapping("/create")public CommonResult create(&＃64;RequestBody User user) {return userService.create(user);}&＃64;PostMapping("/update")public CommonResult update(&＃64;RequestBody User user) {return userService.update(user);}&＃64;PostMapping("/delete/{id}")public CommonResult delete(&＃64;PathVariable Long id) {return userService.delete(id);}
}


• 调用如下接口会发生服务降级&＃xff0c;返回服务降级处理信息&＃xff1a;http://localhost:8401/user/4

{"data": {"id": -1,"username": "defaultUser","password": "123456"},"message": "服务降级返回","code": 200
}


7. 使用Nacos存储规则

7.1 案例

默认情况下&＃xff0c;当我们在Sentinel控制台中配置规则时&＃xff0c;控制台推送规则方式是通过API将规则推送至客户端并直接更新到内存中。一旦我们重启应用&＃xff0c;规则将消失。下面我们介绍下如何将配置规则进行持久化&＃xff0c;以存储到Nacos为例。

• 首先我们直接在配置中心创建规则&＃xff0c;配置中心将规则推送到客户端&＃xff1b;

• Sentinel控制台也从配置中心去获取配置信息。

• 先在pom.xml中添加相关依赖&＃xff1a;

com.alibaba.cspsentinel-datasource-nacos



•  修改application.yml配置文件&＃xff0c;添加Nacos数据源配置&＃xff1a;

spring:cloud:sentinel:datasource:ds1:nacos:server-addr: localhost:8848dataId: ${spring.application.name}-sentinelgroupId: DEFAULT_GROUPdata-type: jsonrule-type: flow


• 在Nacos中添加配置&＃xff1a;

• 添加配置信息如下&＃xff1a;

[{"resource": "/rateLimit/byUrl","limitApp": "default","grade": 1,"count": 1,"strategy": 0,"controlBehavior": 0,"clusterMode": false}
]相关参数解释&＃xff1a;resource&＃xff1a;资源名称&＃xff1b;
limitApp&＃xff1a;来源应用&＃xff1b;
grade&＃xff1a;阈值类型&＃xff0c;0表示线程数&＃xff0c;1表示QPS&＃xff1b;
count&＃xff1a;单机阈值&＃xff1b;
strategy&＃xff1a;流控模式&＃xff0c;0表示直接&＃xff0c;1表示关联&＃xff0c;2表示链路&＃xff1b;
controlBehavior&＃xff1a;流控效果&＃xff0c;0表示快速失败&＃xff0c;1表示Warm Up&＃xff0c;2表示排队等待&＃xff1b;
clusterMode&＃xff1a;是否集群。


•  发现Sentinel控制台已经有了如下限流规则&＃xff1a;

7.2 官方释义

动态数据源支持

SentinelProperties 内部提供了 TreeMap 类型的 datasource 属性用于配置数据源信息。

比如配置 4 个数据源&＃xff1a;

spring.cloud.sentinel.datasource.ds1.file.file&＃61;classpath: degraderule.json
spring.cloud.sentinel.datasource.ds1.file.rule-type&＃61;flow#spring.cloud.sentinel.datasource.ds1.file.file&＃61;classpath: flowrule.json
#spring.cloud.sentinel.datasource.ds1.file.data-type&＃61;custom
#spring.cloud.sentinel.datasource.ds1.file.converter-class&＃61;com.alibaba.cloud.examples.JsonFlowRuleListConverter
#spring.cloud.sentinel.datasource.ds1.file.rule-type&＃61;flowspring.cloud.sentinel.datasource.ds2.nacos.server-addr&＃61;localhost:8848
spring.cloud.sentinel.datasource.ds2.nacos.data-id&＃61;sentinel
spring.cloud.sentinel.datasource.ds2.nacos.group-id&＃61;DEFAULT_GROUP
spring.cloud.sentinel.datasource.ds2.nacos.data-type&＃61;json
spring.cloud.sentinel.datasource.ds2.nacos.rule-type&＃61;degradespring.cloud.sentinel.datasource.ds3.zk.path &＃61; /Sentinel-Demo/SYSTEM-CODE-DEMO-FLOW
spring.cloud.sentinel.datasource.ds3.zk.server-addr &＃61; localhost:2181
spring.cloud.sentinel.datasource.ds3.zk.rule-type&＃61;authorityspring.cloud.sentinel.datasource.ds4.apollo.namespace-name &＃61; application
spring.cloud.sentinel.datasource.ds4.apollo.flow-rules-key &＃61; sentinel
spring.cloud.sentinel.datasource.ds4.apollo.default-flow-rule-value &＃61; test
spring.cloud.sentinel.datasource.ds4.apollo.rule-type&＃61;param-flow

d1, ds2, ds3, ds4 是 ReadableDataSource 的名字&＃xff0c;可随意编写。后面的 file &＃xff0c;zk &＃xff0c;nacos , apollo 就是对应具体的数据源&＃xff0c;它们后面的配置就是这些具体数据源各自的配置。注意数据源的依赖要单独引入&＃xff08;比如 sentinel-datasource-nacos)。

每种数据源都有两个共同的配置项&＃xff1a; data-type、 converter-class 以及 rule-type。

data-type 配置项表示 Converter 类型&＃xff0c;Spring Cloud Alibaba Sentinel 默认提供两种内置的值&＃xff0c;分别是 json 和 xml (不填默认是json)。 如果不想使用内置的 json 或 xml 这两种 Converter&＃xff0c;可以填写 custom 表示自定义 Converter&＃xff0c;然后再配置 converter-class 配置项&＃xff0c;该配置项需要写类的全路径名(比如 spring.cloud.sentinel.datasource.ds1.file.converter-class&＃61;com.alibaba.cloud.examples.JsonFlowRuleListConverter)。

rule-type 配置表示该数据源中的规则属于哪种类型的规则(flow&＃xff0c;degrade&＃xff0c;authority&＃xff0c;system, param-flow, gw-flow, gw-api-group)。

默认情况下&＃xff0c;xml 格式是不支持的。需要添加 jackson-dataformat-xml 依赖后才会自动生效。