首页手记 Sentinel初识：入门级用户快速上手指南

Sentinel初识：入门级用户快速上手指南

标签：

Spring Cloud

概述

Sentinel是一款由阿里巴巴开源的分布式服务保护框架，旨在提供一站式的流量控制、超时熔断和系统自适应保护等功能。本文将介绍Sentinel的核心功能、适用场景以及环境搭建的详细步骤，帮助入门级用户快速上手Sentinel初识。

Sentinel初识：入门级用户快速上手指南

Sentinel简介

Sentinel是什么

Sentinel 是阿里巴巴开源的一款分布式服务保护框架，它的目标是提供一站式的流量控制、超时熔断和系统自适应保护等功能。

Sentinel的核心功能

Sentinel 提供了以下核心功能：

流量控制：支持多种维度的流量控制，包括请求量、并发数、系统负载、平均响应时间等。
超时熔断：在请求超时时自动熔断，并根据预设的规则自动恢复。
系统保护：监控系统的整体负载情况，根据系统当前的状态动态调整流量。
异常检测：自动检测系统中的异常，例如慢调用比例超过阈值时触发熔断。
资源访问链路：提供链路追踪功能，帮助用户快速定位问题。
实时监控：提供实时的监控视图，方便用户了解系统的运行状态。

Sentinel的适用场景

微服务架构：在微服务架构中，Sentinel 可以作为服务网格的一部分，提供服务级别的保护。
云原生应用：在云原生应用中，Sentinel 可以提供动态流量调整和保护功能。
高并发系统：在高并发系统中，Sentinel 可以帮助系统在高负载情况下进行流量控制，避免系统崩溃。
分布式系统：在分布式系统中，Sentinel 可以提供全局流量控制和保护功能。

环境搭建

下载与安装Sentinel

Sentinel 的安装和配置相对简单。以下是详细的安装步骤：

下载 Sentinel：前往 Sentinel 的 GitHub 仓库，下载最新版本的 Sentinel：
```
git clone https://github.com/alibaba/Sentinel.git
cd Sentinel
```

配置环境：根据你使用的 Java 版本，下载对应的 JAR 包，并将 JAR 包添加到项目依赖中。

<!-- Maven 依赖配置示例 -->
<dependency>
   <groupId>com.alibaba.csp</groupId>
   <artifactId>sentinel-core</artifactId>
   <version>1.8.2</version>
</dependency>

<!-- Gradle 依赖配置示例 -->
dependencies {
   implementation 'com.alibaba.csp:sentinel-core:1.8.2'
}

配置Sentinel环境

配置文件：在项目的 src/main/resources 目录下创建 sentinel.properties 文件，用于配置 Sentinel 的相关属性。

# 配置项目名称
project.name=MyApp
# 启用或禁用链路追踪
tracing.enabled=true
# 配置熔断降级规则
flow.rule.file=flow-rules.json

初始化配置：在应用启动时初始化 Sentinel 配置。

import com.alibaba.csp.sentinel.init.InitFunc;
import com.alibaba.csp.sentinel.slots.block.flow.FlowRuleManager;
import com.alibaba.csp.sentinel.slots.block.flow.FlowRule;
import java.util.ArrayList;
import java.util.List;

public class SentinelConfig implements InitFunc {
   @Override
   public void init() throws Exception {
       List<FlowRule> rules = new ArrayList<>();
       FlowRule rule = new FlowRule();
       rule.setResource("MyResource");
       rule.setGrade(FlowRuleManager.FLOW_GRADE_QPS);
       rule.setCount(10);
       rules.add(rule);
       FlowRuleManager.loadRules(rules);
   }
}

第一次运行Sentinel

启动应用：启动包含 Sentinel 配置的 Java 应用，确保应用能正确加载 Sentinel 配置文件。
监控控制台：启动 Sentinel 控制台，查看应用的监控数据。
```
java -jar sentinel-dashboard-1.8.2.jar
```
打开浏览器，访问 http://localhost:8080，查看应用的监控数据。

基础概念讲解

流控规则

流控规则用于控制进入系统的流量，以保护系统免于过载。流控规则有多种类型，包括通过请求量、并发数、系统负载等维度进行控制。

流控规则类型

QPS 控制：限制每秒请求数量。
并发数控制：限制同一时间内的请求数量。
系统负载控制：根据系统当前的负载情况动态调整流量。

示例代码

以下是一个简单的 QPS 流控规则示例：

import com.alibaba.csp.sentinel.annotation.SentinelResource;
import com.alibaba.csp.sentinel.slots.block.BlockException;
import com.alibaba.csp.sentinel.slots.block.RuleConstant;
import com.alibaba.csp.sentinel.slots.block.flow.FlowRule;
import com.alibaba.csp.sentinel.slots.block.flow.FlowRuleManager;
import java.util.ArrayList;
import java.util.List;

public class FlowControlDemo {

    static {
        List<FlowRule> rules = new ArrayList<>();
        FlowRule rule = new FlowRule();
        rule.setResource("MyResource");
        rule.setGrade(RuleConstant.FLOW_GRADE_QPS);
        rule.setCount(10);
        rules.add(rule);
        FlowRuleManager.loadRules(rules);
    }

    @SentinelResource(value = "MyResource", blockHandler = "blockHandler")
    public void accessResource() {
        System.out.println("Accessing resource...");
    }

    public void blockHandler(BlockException ex) {
        System.out.println("Flow control: " + ex.getMessage());
    }
}

熔断降级

熔断降级机制用于在系统出现异常时自动切断流量，避免系统过载。当请求超时时，Sentinel 会自动开启熔断降级机制，并根据预设的规则自动恢复。

熔断降级规则类型

慢调用比例：当请求的平均响应时间超过设定阈值时，触发熔断。
异常比例：当请求的失败比例超过设定阈值时，触发熔断。
慢调用数量：当请求的平均响应时间和请求数量超过设定阈值时，触发熔断。

示例代码

以下是一个简单的熔断降级规则示例：

import com.alibaba.csp.sentinel.annotation.SentinelResource;
import com.alibaba.csp.sentinel.slots.block.BlockException;
import com.alibaba.csp.sentinel.slots.block.RuleConstant;
import com.alibaba.csp.sentinel.slots.block.flow.FlowRule;
import com.alibaba.csp.sentinel.slots.block.flow.FlowRuleManager;
import java.util.ArrayList;
import java.util.List;

public class CircuitBreakerDemo {

    static {
        List<FlowRule> rules = new ArrayList<>();
        FlowRule rule = new FlowRule();
        rule.setResource("MyResource");
        rule.setGrade(RuleConstant.FLOW_GRADE_RT);
        rule.setCount(1000);
        rule.setMinRequestAmount(10);
        rules.add(rule);
        FlowRuleManager.loadRules(rules);
    }

    @SentinelResource(value = "MyResource", blockHandler = "blockHandler")
    public void accessResource() {
        System.out.println("Accessing resource...");
    }

    public void blockHandler(BlockException ex) {
        System.out.println("Circuit breaking: " + ex.getMessage());
    }
}

系统保护

系统保护机制用于监控系统的整体负载情况，根据系统的当前状态动态调整流量。系统保护规则有以下几种：

CPU 使用率：监控系统 CPU 使用率，当超过设定阈值时触发限流。
系统负载：监控系统的系统负载（如 Linux 的负载），当超过设定阈值时触发限流。
内存使用率：监控系统的内存使用率，当超过设定阈值时触发限流。

示例代码

以下是一个简单的系统保护规则示例：

import com.alibaba.csp.sentinel.annotation.SentinelResource;
import com.alibaba.csp.sentinel.slots.block.BlockException;
import com.alibaba.csp.sentinel.slots.system.SystemRule;
import com.alibaba.csp.sentinel.slots.system.SystemRuleManager;
import java.util.ArrayList;
import java.util.List;

public class SystemProtectionDemo {

    static {
        List<SystemRule> rules = new ArrayList<>();
        SystemRule rule = new SystemRule();
        rule.setResource("MyResource");
        rule.setGrade(SystemRuleConstant.SYSTEM_PROTECT_GRADE_CPU);
        rule.setCount(80);
        rules.add(rule);
        SystemRuleManager.loadRules(rules);
    }

    @SentinelResource(value = "MyResource", blockHandler = "blockHandler")
    public void accessResource() {
        System.out.println("Accessing resource...");
    }

    public void blockHandler(BlockException ex) {
        System.out.println("System protection: " + ex.getMessage());
    }
}

实战演练

实战案例一：简单流控

案例描述

假设我们有一个资源名为 SimpleResource，我们需要限制该资源的 QPS 不超过 10。

示例代码

import com.alibaba.csp.sentinel.annotation.SentinelResource;
import com.alibaba.csp.sentinel.slots.block.BlockException;
import com.alibaba.csp.sentinel.slots.block.RuleConstant;
import com.alibaba.csp.sentinel.slots.block.flow.FlowRule;
import com.alibaba.csp.sentinel.slots.block.flow.FlowRuleManager;

public class SimpleFlowControlDemo {

    static {
        List<FlowRule> rules = new ArrayList<>();
        FlowRule rule = new FlowRule();
        rule.setResource("SimpleResource");
        rule.setGrade(RuleConstant.FLOW_GRADE_QPS);
        rule.setCount(10);
        rules.add(rule);
        FlowRuleManager.loadRules(rules);
    }

    @SentinelResource(value = "SimpleResource", blockHandler = "blockHandler")
    public void accessSimpleResource() {
        System.out.println("Accessing SimpleResource...");
    }

    public void blockHandler(BlockException ex) {
        System.out.println("Flow control: " + ex.getMessage());
    }
}

实战案例二：熔断降级

案例描述

假设我们有一个资源名为 CircuitResource，我们需要在请求的平均响应时间超过 1 秒时触发熔断。

示例代码

import com.alibaba.csp.sentinel.annotation.SentinelResource;
import com.alibaba.csp.sentinel.slots.block.BlockException;
import com.alibaba.csp.sentinel.slots.block.RuleConstant;
import com.alibaba.csp.sentinel.slots.block.flow.FlowRule;
import com.alibaba.csp.sentinel.slots.block.flow.FlowRuleManager;

public class CircuitBreakerDemo {

    static {
        List<FlowRule> rules = new ArrayList<>();
        FlowRule rule = new FlowRule();
        rule.setResource("CircuitResource");
        rule.setGrade(RuleConstant.FLOW_GRADE_RT);
        rule.setCount(1000);
        rule.setMinRequestAmount(10);
        rules.add(rule);
        FlowRuleManager.loadRules(rules);
    }

    @SentinelResource(value = "CircuitResource", blockHandler = "blockHandler")
    public void accessCircuitResource() {
        System.out.println("Accessing CircuitResource...");
    }

    public void blockHandler(BlockException ex) {
        System.out.println("Circuit breaking: " + ex.getMessage());
    }
}

实战案例三：系统保护

案例描述

假设我们有一个资源名为 SystemResource，我们需要在 CPU 使用率超过 80% 时触发限流。

示例代码

import com.alibaba.csp.sentinel.annotation.SentinelResource;
import com.alibaba.csp.sentinel.slots.block.BlockException;
import com.alibaba.csp.sentinel.slots.system.SystemRule;
import com.alibaba.csp.sentinel.slots.system.SystemRuleManager;

public class SystemProtectionDemo {

    static {
        List<SystemRule> rules = new ArrayList<>();
        SystemRule rule = new SystemRule();
        rule.setResource("SystemResource");
        rule.setGrade(SystemRuleConstant.SYSTEM_PROTECT_GRADE_CPU);
        rule.setCount(80);
        rules.add(rule);
        SystemRuleManager.loadRules(rules);
    }

    @SentinelResource(value = "SystemResource", blockHandler = "blockHandler")
    public void accessSystemResource() {
        System.out.println("Accessing SystemResource...");
    }

    public void blockHandler(BlockException ex) {
        System.out.println("System protection: " + ex.getMessage());
    }
}

常见问题与解决方案

Sentinel报错排查

常见错误和解决方法

FlowException：当请求量超过设定的限流阈值时，会抛出 FlowException，可以通过增加资源的限流阈值或优化处理逻辑来解决。

import com.alibaba.csp.sentinel.SentinelException;
import com.alibaba.csp.sentinel.annotation.SentinelResource;
import com.alibaba.csp.sentinel.slots.block.BlockException;

@SentinelResource(value = "MyResource", blockHandler = "blockHandler")
public void accessResource() {
   System.out.println("Accessing resource...");
}

public void blockHandler(BlockException ex) {
   if (ex instanceof SentinelException) {
       System.out.println("FlowException: " + ex.getMessage());
   }
}

BlockException：当请求被阻塞时，会抛出 BlockException，可以通过调整限流规则或优化系统资源来解决。

import com.alibaba.csp.sentinel.annotation.SentinelResource;
import com.alibaba.csp.sentinel.slots.block.BlockException;

@SentinelResource(value = "MyResource", blockHandler = "blockHandler")
public void accessResource() {
   System.out.println("Accessing resource...");
}

public void blockHandler(BlockException ex) {
   System.out.println("BlockException: " + ex.getMessage());
}

常见配置问题解答

资源名称不匹配：确保资源名称与配置文件中的资源名称一致。
```
# 配置文件示例
project.name=MyApp
flow.rule.file=flow-rules.json
```

配置文件路径错误：确保配置文件路径正确，并且文件存在。

import com.alibaba.csp.sentinel.init.InitFunc;

public class SentinelConfig implements InitFunc {
   @Override
   public void init() throws Exception {
       // 加载配置文件路径
       System.setProperty("sentinel.flow.file", "path/to/flow-rules.json");
   }
}

结语与资源推荐

Sentinel社区与文档资源

GitHub 仓库：https://github.com/alibaba/Sentinel
官方文档：https://sentinelguard.io/zh-cn/docs/index.html
社区论坛：https://github.com/alibaba/Sentinel/issues

进阶学习建议

慕课网：推荐在慕课网（https://www.imooc.com/）上学习更多关于 Sentinel 的课程。
官方教程：阅读 Sentinel 官方文档中的教程部分，深入理解 Sentinel 的核心功能。
实战演练：通过实战演练项目，掌握 Sentinel 在实际项目中的使用方法。

通过以上内容的学习和实践，你将能够更好地理解和使用 Sentinel，提高系统的可靠性和稳定性。

点击查看更多内容

为 TA 点赞

若觉得本文不错，就分享一下吧！

评论

评论

共同学习，写下你的评论

评论加载中...

展开查看更多评论

作者其他优质文章

正在加载中

森栏

手记
篇

粉丝

101

获赞与收藏

475

关注作者，订阅最新文章

阅读免费教程

Spring Cloud Hystrix

15个小节 6180 121

后端通用面试教程

41个小节 30936 346

网络编程入门教程

20个小节 12729 240

推荐

评论

收藏

共同学习，写下你的评论



感谢您的支持，我会继续努力的～

扫码打赏，你说多少就多少

赞赏金额会直接到老师账户

支付方式

打开微信扫一扫，即可进行扫码打赏哦

今天注册有机会得

100积分直接送

付费专栏免费学

大额优惠券免费领

立即参与放弃机会

点击
抽奖

慕课手记新用户专享福利

恭喜你，你的运气太好了，居然抽中了 100个积分！

恭喜你，抽中了价值元的专栏！

太棒了，直接落到你账户里！

积分商城里的罗技鼠标、机械键盘、
Kindle 阅读器、小米平衡车
Apple iPad （10.2英寸）、大额优惠券
在等着你去兑换了噢

作者：

免费赠送

兑换码：1111222211 复制

优惠券可用于购买实战课、体系课
无门槛使用

先去看看，有什么好东西马上兑换我爱学习，选课去


热搜

最近搜索清空

Sentinel初识：入门级用户快速上手指南

Sentinel是什么

Sentinel的核心功能

Sentinel的适用场景

下载与安装Sentinel

配置Sentinel环境

第一次运行Sentinel

流控规则

流控规则类型

示例代码

熔断降级

熔断降级规则类型

示例代码

系统保护

示例代码

实战案例一：简单流控

案例描述

示例代码

实战案例二：熔断降级

案例描述

示例代码

实战案例三：系统保护

案例描述

示例代码

Sentinel报错排查

常见错误和解决方法

常见配置问题解答

Sentinel社区与文档资源

进阶学习建议

阅读免费教程