SpringCloudAlibaba之Sentinel简单使用

2024-04-23 21:52

本文主要是介绍SpringCloudAlibaba之Sentinel简单使用,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

SpringCloudAlibaba之Sentinel简单使用

文章目录

    • SpringCloudAlibaba之Sentinel简单使用
      • sentinel入门
      • 资源定义
        • SphU(抛出异常方式)
        • SphO(布尔类型方式)
        • @SentinelResource(注解的方式定义)
          • @SentinelResource使用前置条件
          • 使用@SentinelResource定义资源
          • 定义blockHandler和fallback方法(方法名称和@sentinelResoruce的参数名称需要一直,并且方法必须是public修饰)
          • @SentinelResoruce参数释义
          • 完整的service代码(资源定义)
      • 定义sentinel规则
      • 校验规则是否生效

使用sentinel三部曲,

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

sentinel入门

  1. 创建基础模块sentinel-boot-service
  • 引入依赖
<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency><dependency><groupId>com.alibaba.csp</groupId><artifactId>sentinel-core</artifactId><version>1.8.0</version>
</dependency>
  • 创建主类
@SpringBootApplication
public class SentinelBootServiceApplication {public static void main(String[] args) {SpringApplication.run(SentinelBootServiceApplication.class,args);}
}
  • 创建application.yml
server:port: 8080

资源定义

  1. 定义sentinel资源,sentinel中的资源可以是一段代码,一个方法,甚至是整个应用。sentinel可以保护整个应用

资源必须定义资源名称

  • 创建service/SentinelTestService
SphU(抛出异常方式)
public String sphuTest(){// 1.5.0 版本开始可以直接利用 try-with-resources 特性try(Entry ignored = SphU.entry("sphuTest")) {// 被保护的逻辑return "hello world";} catch (BlockException ex) {// 处理被流控的逻辑return "blocked";}
}

Sphu.entry(resourceName) 可以定义一段sentinel资源,当访问超出sentinel定义的规则后,Sphu.entry方法会抛出BlockException

所以可以在try语句块中定义sentinel的资源,也就是被保护的逻辑。在catch块中捕获BlockException,用来对降级进行处理

SphO(布尔类型方式)
public String sphoTest() {if(SphO.entry("sphoTest")){try {return "hello world";} finally{SphO.exit();}}else{//被限流了,逻辑处理return "被限流了";}
}

SphO.entry(resourceName) 方法可以返回一个boolean值,用于是否通过sentinel管控,必须与SphO.exit()搭配使用

@SentinelResource(注解的方式定义)
@SentinelResource使用前置条件

由于@SentinelResource是通过aop方式进行管控,所以需要引入aspectj模块

<dependency><groupId>com.alibaba.csp</groupId><artifactId>sentinel-annotation-aspectj</artifactId><version>1.8.0</version>
</dependency>
  • SentinelResourceAspect注入到Spring容器中

sentinel-boot-service 的config包下创建SentinelConfig

@Configuration
public class SentinelConfig {//注入@Beanpublic SentinelResourceAspect sentinelResourceAspect(){return new SentinelResourceAspect();}
}
使用@SentinelResource定义资源
private static AtomicInteger atomicInteger = new AtomicInteger(0);@SentinelResource(value = "annotationTest",blockHandler = "blockHandler",fallback = "fallback")public String annotationTest(){int i = atomicInteger.incrementAndGet();if(i % 2 == 0){return "hello world";}else{throw new RuntimeException("something wrong");}}

blockHandler和fallback是两个概念

blockHandler是sentinel对资源进行限流或者熔断时的处理规则

fallback是资源抛出异常后,对异常捕获后的处理

定义blockHandler和fallback方法(方法名称和@sentinelResoruce的参数名称需要一直,并且方法必须是public修饰)
	public String blockHandler(BlockException ex){ex.printStackTrace();return "block handler";}public String fallback(){return "fallback";}

所以上述代码有三段逻辑,第一段正常逻辑返回hello world,第二段,抛出异常,被fallback捕获,返回fallback,第三段,被sentinel限流,被blockHandler处理,返回block handler

@SentinelResoruce参数释义
参数名称类型描述
valueString必需项,用于指定资源的名称。这个名称通常用于在 Sentinel Dashboard 中进行监控和管理。
entryTypeEntryType可选项,指定 entry 的类型。默认为 EntryType.OUT,表示这是一个出站调用。
blockHandlerString可选项,指定处理 BlockException 的函数名称。当原方法被限流或熔断时,会调用这个函数进行异常处理。该函数的访问范围需要是 public,返回类型需要与原方法相匹配,参数类型需要和原方法相匹配并且最后加一个额外的参数,类型为 BlockException。默认情况下,这个函数需要和原方法在同一个类中。
blockHandlerClassClass<?>可选项,当希望使用其他类的函数作为 blockHandler 时,可以指定这个类的 Class 对象。注意,对应的函数必须为 static 函数。
fallbackString可选项,指定回退函数名称,当原方法调用失败时,会调用这个回退函数。回退函数的签名(返回值类型、参数类型)需要与原方法一致。
fallbackClassClass<?>可选项,当希望使用其他类的函数作为回退函数时,可以指定这个类的 Class 对象。同样,对应的函数必须为 static 函数。
resourceTypeint可选项,用于指定资源的类型。这通常用于区分不同类型的资源,以便进行更精细的控制。
exceptionsToIgnoreClass<? extends Throwable>[]可选项,指定需要忽略的异常类型。当原方法抛出这些异常时,Sentinel 不会触发限流或熔断逻辑。

这个注解允许开发者对方法进行细粒度的流量控制,同时提供了异常处理和回退机制,确保系统的可靠性和稳定性。通过合理配置这些参数,可以更加精准地控制应用的流量,避免由于流量过大或异常导致的系统崩溃。

完整的service代码(资源定义)
@Service
public class SentinelTestService {private static AtomicInteger atomicInteger = new AtomicInteger(0);public String sphuTest(){// 1.5.0 版本开始可以直接利用 try-with-resources 特性try(Entry ignored = SphU.entry("sphuTest")) {// 被保护的逻辑return "hello world";} catch (BlockException ex) {// 处理被流控的逻辑return "blocked";}}public String sphoTest() {if(SphO.entry("sphoTest")){try {return "hello world";} finally{SphO.exit();}}else{//被限流了,逻辑处理return "被限流了";}}@SentinelResource(value = "annotationTest",blockHandler = "blockHandler",fallback = "fallback")public String annotationTest(){int i = atomicInteger.incrementAndGet();if(i % 2 == 0){return "hello world";}else{throw new RuntimeException("something wrong");}}public String blockHandler(BlockException ex){ex.printStackTrace();return "block handler";}public String fallback(){return "fallback";}
}

定义sentinel规则

sentinel的规则有很多种,此文章示例,仅用流控来测试sentinel定义的资源信息

在config/SentinelRuleConfig下分别创建上面三个资源的流控规则,如下

@Configuration
public class SentinelRuleConfig {@PostConstructpublic void init(){List<FlowRule> rules = new ArrayList<>();FlowRule rule = new FlowRule();//定义规则适用的资源名称rule.setResource("sphuTest");rule.setGrade(RuleConstant.FLOW_GRADE_QPS);//定义每秒被保护的代码块最多运行2次rule.setCount(2);rules.add(rule);FlowRule sphoTestRule = new FlowRule();//定义规则适用的资源名称sphoTestRule.setResource("sphoTest");sphoTestRule.setGrade(RuleConstant.FLOW_GRADE_QPS);//定义每秒被保护的代码块最多运行2次sphoTestRule.setCount(2);rules.add(sphoTestRule);FlowRule annotationTestRule = new FlowRule();//定义规则适用的资源名称annotationTestRule.setResource("annotationTest");annotationTestRule.setGrade(RuleConstant.FLOW_GRADE_QPS);//定义每秒被保护的代码块最多运行2次annotationTestRule.setCount(2);rules.add(annotationTestRule);FlowRuleManager.loadRules(rules);}
}
  • setResource:设置资源名称
  • setGrade:设置流控的类型,此处通过QPS,即每秒的访问量
  • setCount: 设置每秒访问量的阈值,当大于2时,触发sentinel流控

校验规则是否生效

  • 新建入口SentinelTestController,并分别创建三个uri对应三个资源的访问
public class SentinelTestController {@Resourceprivate SentinelTestService sentinelTestService;@GetMapping("/sphuTest")public String sphuTest(){return sentinelTestService.sphuTest();}@GetMapping("/sphoTest")public String sphoTest(){return sentinelTestService.sphoTest();}@GetMapping("/annotationTest")public String annotationTest(){return sentinelTestService.annotationTest();}
}
  • 启动sentinel-boot-service项目模块,并通过浏览器访问
  1. sphuTest
  • 访问sphuTest,可以看到正常返回hello world
http://localhost:8080/sentinel/sphuTest
-> hello world
  • 快速刷新sphuTest,可以看到blockedhello world出现
http://localhost:8080/sentinel/sphuTest
-> hello world
-> blocked    
  1. sphotest
  • 访问sphOTest,可以看到正常返回hello world
http://localhost:8080/sentinel/sphoTest
-> hello world
  • 快速刷新sphoTest,可以看到被限流了hello world出现
http://localhost:8080/sentinel/sphoTest
-> hello world
-> 被限流了
  1. annotationTest
  • 低频率刷新annotationTest,可以看到hello world和fallback交替出现,这里由于业务逻辑是执行一次,抛一次异常,异常捕获被fallback执行,所以交替出现
http://localhost:8080/sentinel/annotationTest
-> hello world
-> fallback
-> hello world
-> fallback
-> hello world
-> fallback
  • 高频率刷新,可以看到hello worldfallbackblock handler都会出现。

在高频率刷新中,可能会执行正常逻辑(未限流,未异常情况),可能执行到fallback逻辑(异常情况),block handler(达到设定的流控QPS阈值)

这篇关于SpringCloudAlibaba之Sentinel简单使用的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/929987

相关文章

Java通过驱动包(jar包)连接MySQL数据库的步骤总结及验证方式

《Java通过驱动包(jar包)连接MySQL数据库的步骤总结及验证方式》本文详细介绍如何使用Java通过JDBC连接MySQL数据库,包括下载驱动、配置Eclipse环境、检测数据库连接等关键步骤,... 目录一、下载驱动包二、放jar包三、检测数据库连接JavaJava 如何使用 JDBC 连接 mys

SpringBoot线程池配置使用示例详解

《SpringBoot线程池配置使用示例详解》SpringBoot集成@Async注解,支持线程池参数配置(核心数、队列容量、拒绝策略等)及生命周期管理,结合监控与任务装饰器,提升异步处理效率与系统... 目录一、核心特性二、添加依赖三、参数详解四、配置线程池五、应用实践代码说明拒绝策略(Rejected

C++ Log4cpp跨平台日志库的使用小结

《C++Log4cpp跨平台日志库的使用小结》Log4cpp是c++类库,本文详细介绍了C++日志库log4cpp的使用方法,及设置日志输出格式和优先级,具有一定的参考价值,感兴趣的可以了解一下... 目录一、介绍1. log4cpp的日志方式2.设置日志输出的格式3. 设置日志的输出优先级二、Window

Ubuntu如何分配​​未使用的空间

《Ubuntu如何分配​​未使用的空间》Ubuntu磁盘空间不足,实际未分配空间8.2G因LVM卷组名称格式差异(双破折号误写)导致无法扩展,确认正确卷组名后,使用lvextend和resize2fs... 目录1:原因2:操作3:报错5:解决问题:确认卷组名称​6:再次操作7:验证扩展是否成功8:问题已解

Qt使用QSqlDatabase连接MySQL实现增删改查功能

《Qt使用QSqlDatabase连接MySQL实现增删改查功能》这篇文章主要为大家详细介绍了Qt如何使用QSqlDatabase连接MySQL实现增删改查功能,文中的示例代码讲解详细,感兴趣的小伙伴... 目录一、创建数据表二、连接mysql数据库三、封装成一个完整的轻量级 ORM 风格类3.1 表结构

一文详解SpringBoot中控制器的动态注册与卸载

《一文详解SpringBoot中控制器的动态注册与卸载》在项目开发中,通过动态注册和卸载控制器功能,可以根据业务场景和项目需要实现功能的动态增加、删除,提高系统的灵活性和可扩展性,下面我们就来看看Sp... 目录项目结构1. 创建 Spring Boot 启动类2. 创建一个测试控制器3. 创建动态控制器注

使用Docker构建Python Flask程序的详细教程

《使用Docker构建PythonFlask程序的详细教程》在当今的软件开发领域,容器化技术正变得越来越流行,而Docker无疑是其中的佼佼者,本文我们就来聊聊如何使用Docker构建一个简单的Py... 目录引言一、准备工作二、创建 Flask 应用程序三、创建 dockerfile四、构建 Docker

Python使用vllm处理多模态数据的预处理技巧

《Python使用vllm处理多模态数据的预处理技巧》本文深入探讨了在Python环境下使用vLLM处理多模态数据的预处理技巧,我们将从基础概念出发,详细讲解文本、图像、音频等多模态数据的预处理方法,... 目录1. 背景介绍1.1 目的和范围1.2 预期读者1.3 文档结构概述1.4 术语表1.4.1 核

Java操作Word文档的全面指南

《Java操作Word文档的全面指南》在Java开发中,操作Word文档是常见的业务需求,广泛应用于合同生成、报表输出、通知发布、法律文书生成、病历模板填写等场景,本文将全面介绍Java操作Word文... 目录简介段落页头与页脚页码表格图片批注文本框目录图表简介Word编程最重要的类是org.apach

Python使用pip工具实现包自动更新的多种方法

《Python使用pip工具实现包自动更新的多种方法》本文深入探讨了使用Python的pip工具实现包自动更新的各种方法和技术,我们将从基础概念开始,逐步介绍手动更新方法、自动化脚本编写、结合CI/C... 目录1. 背景介绍1.1 目的和范围1.2 预期读者1.3 文档结构概述1.4 术语表1.4.1 核