Sentinel 可以简单的分为 Sentinel 核心库 (sentinel-core依赖) 和 Dashboard (Sentinel控制台)。核心库不依赖 Dashboard，但是结合 Dashboard 可以取得最好的效果 (因为通过Sentinel控制台，我们可以更方便的设置规则，不仅效率提高了，还能进行实时监控，而无需编写java代码来设置规则)。 - - > 当然学习中还是以代码方式为准。

这篇文章主要介绍 Sentinel 核心库的使用。如果希望有一个最快最直接的了解，可以参考 新手指南 来获取一个最直观的感受。

我们说的资源，可以是任何东西，服务，服务里的方法，甚至是一段代码。使用 Sentinel 来进行资源保护，主要分为几个步骤:

1. 定义资源
2. 定义规则
3. 检验规则是否生效

先把可能需要保护的资源定义好（埋点），之后再配置规则。也可以理解为，只要有了资源，我们就可以在任何时候灵活地定义各种流量控制规则。在编码的时候，只需要考虑这个代码是否需要保护，如果需要保护，就将之定义为一个资源。

对于主流的框架，我们提供适配，只需要按照适配中的说明配置，Sentinel 就会默认定义提供的服务，方法等为资源。

注意：Sentinel 需要 JDK 1.8 或更高版本。

需要注意的是，Sentinel 并不是一定要在 Spring Cloud Alibaba 上使用的，我们可以单纯的去使用 Sentinel 核心库。它可以在分布式架构中使用，而不是一定要在微服务架构中使用。

如果您使用的是 Maven，只需在pom.xml中添加以下依赖项。

<dependency><groupId>com.alibaba.csp</groupId><artifactId>sentinel-core</artifactId>
</dependency>

Sentinel 的流控规则、降级规则等都是针对项目中的接口来进行设置的，需要依赖 web 接口，需要引入 web场景启动器 spring-boot-starter-web 依赖。

<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId>
</dependency>

创建一个接口，在接口中定义资源，资源名称一般和接口地址一致。

@GetMapping("/hello")public String hello(){Entry entry = null;try {// sentinel 针对资源进行限制的，通常这个资源名称会跟接口的地址名称保持一致entry = SphU.entry(RESOURCE_NAME);// 被保护的业务逻辑String str = "hello word";log.info("- - -> " + str + " <- - -");return str;} catch (BlockException e) {// 资源访问阻止，被限流 或 被降级// 进行相应的处理操作log.info("block");return "被流控了";} catch (Exception e) {// 若需要配置降级规则，需要通过这种方式记录业务异常Tracer.traceEntry(e, entry);}finally {if(entry != null){entry.exit();}}return null;}

接下来，通过流控规则来指定允许该资源通过的请求次数，例如下面的代码定义了资源 HelloWorld 每秒最多只能通过 1 个请求。

@PostConstruct // Spring的初始化方法
private static void initFlowRules(){// 流控规则List<FlowRule> rules = new ArrayList<>();// 流控FlowRule rule = new FlowRule();// 设置受保护的资源（即为哪个资源进行流量控制）rule.setResource(RESOURCE_NAME);// 设置流控规则 QPSrule.setGrade(RuleConstant.FLOW_GRADE_QPS);// 设置受保护的资源阈值// Set limit QPS to 20，设置每秒的访问数为20，超过20的部分就会进行限流//rule.setCount(20);// Set limit QPS to 1，设置每秒的访问数为1，超过1的部分就会到catch(BlockException e)里去rule.setCount(1);rules.add(rule);// 加载配置好的规则FlowRuleManager.loadRules(rules);
}

完成上面 3 步，Sentinel 就能够正常工作了。更多的信息可以参考 使用文档。

完整代码

@RestController
@Slf4j
public class HelloController {private static final String RESOURCE_NAME = "hello";private static final String USER_RESOURCE_NAME = "user";private static final String DEGRADE_RESOURCE_NAME = "degrade";/*** 进行Sentinel流控规则** Sentinel 所有的规则都是针对于接口来的，准确点说是针对资源来设置的*/@GetMapping("/hello")public String hello(){Entry entry = null;try {// sentinel 针对资源进行限制的，通常这个资源名称会跟接口的地址名称保持一致entry = SphU.entry(RESOURCE_NAME);// 被保护的业务逻辑，如果是RPC调用远程服务的接口，那么这里被保护的就是RPC远程服务接口String str = "hello word";log.info("- - -> " + str + " <- - -");// 如果没有被流控，则正常返回return str;} catch (BlockException e) {// 资源访问阻止，被限流 或 被降级// 进行相应的处理操作log.info("block");// 如果被流控了，则返回被流控了return "被流控了";} catch (Exception e) {// 若需要配置降级规则，需要通过这种方式记录业务异常Tracer.traceEntry(e, entry);}finally {if(entry != null){entry.exit();}}return null;}@PostConstruct // Spring的初始化方法private static void initFlowRules(){// 流控规则List<FlowRule> rules = new ArrayList<>();// 流控FlowRule rule = new FlowRule();// 设置受保护的资源（即为哪个资源进行流量控制）rule.setResource(RESOURCE_NAME);// 设置流控规则 QPSrule.setGrade(RuleConstant.FLOW_GRADE_QPS);// 设置受保护的资源阈值// Set limit QPS to 20，设置每秒的访问数为20，超过20的部分就会进行限流//rule.setCount(20);// Set limit QPS to 1，设置每秒的访问数为1，超过1的部分就会到catch(BlockException e)里去rule.setCount(1);rules.add(rule);// 加载配置好的规则FlowRuleManager.loadRules(rules);}}