在 Spring Cloud Alibaba 中,Sentinel 是一种常用的流量控制和熔断框架,用于保护微服务免受过载流量的影响。Sentinel 提供了丰富的流量控制手段,包括限流、熔断、降级等。以下是配置和使用 Sentinel 进行流量控制的步骤。
1. 引入 Sentinel 依赖
首先,你需要在项目的 pom.xml
文件中引入 Sentinel 的相关依赖:
<!-- 引入 Sentinel 核心库 -->
<dependency>
<groupId>com.alibaba.csp</groupId>
<artifactId>sentinel-core</artifactId>
</dependency>
<!-- 引入 Sentinel 与 Spring Cloud Alibaba 集成的依赖 -->
<dependency>
<groupId>com.alibaba.csp</groupId>
<artifactId>sentinel-spring-cloud-gateway-adapter</artifactId>
</dependency>
<!-- 引入 Sentinel 的仪表板依赖 -->
<dependency>
<groupId>com.alibaba.csp</groupId>
<artifactId>sentinel-dashboard</artifactId>
</dependency>
2. 配置 Sentinel
在 application.properties
或 application.yml
文件中配置 Sentinel 的相关信息:
# application.yml 示例
spring:
cloud:
sentinel:
transport:
dashboard: localhost:8080 # Sentinel 控制台地址
port: 8719 # Sentinel 客户端与 Sentinel 控制台通信的端口
eager: true # 启动时立即初始化 Sentinel
3. 使用 Sentinel 进行流量控制
3.1 在控制器中使用 Sentinel
你可以在控制器的方法上使用 Sentinel 的注解来实现流量控制。例如:
import com.alibaba.csp.sentinel.annotation.SentinelResource;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class MyController {
@GetMapping("/hello")
@SentinelResource(value = "hello", fallback = "handleException") // 指定降级方法
public String hello() {
return "Hello, world!";
}
public String handleException(Exception e) {
return "Too many requests, please try again later.";
}
}
3.2 配置限流规则
通过 Sentinel 控制台为服务配置限流规则。登录到 Sentinel 控制台 (http://localhost:8080
),选择你的应用,然后配置 QPS 限流规则或其他类型的规则。
4. 配置 Sentinel 控制台
如果你想要使用 Sentinel 控制台来监控和管理规则,需要确保 Sentinel 控制台已经启动并且可以访问:
java -jar sentinel-dashboard.jar
5. 高级配置
5.1 动态规则
Sentinel 支持通过配置中心(如 Nacos)动态更新规则。这样可以在不重启应用的情况下改变规则。
5.2 熔断和降级
除了限流外,Sentinel 还支持熔断和降级功能,可以根据错误率、响应时间等指标来触发熔断或降级逻辑。
5.3 自定义异常处理器
你可以自定义异常处理器来处理 Sentinel 抛出的异常:
import com.alibaba.csp.sentinel.adapter.spring.webmvc.exception.SentinelWebExceptionHandler;
import org.springframework.boot.autoconfigure.web.ServerProperties;
import org.springframework.boot.autoconfigure.web.servlet.error.BasicErrorController;
import org.springframework.boot.web.servlet.error.ErrorAttributes;
import org.springframework.context.ApplicationContext;
import org.springframework.web.context.request.RequestAttributes;
import org.springframework.web.servlet.HandlerExceptionResolver;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
public class CustomSentinelWebExceptionHandler extends SentinelWebExceptionHandler {
public CustomSentinelWebExceptionHandler(ErrorAttributes errorAttributes,
ApplicationContext applicationContext,
ServerProperties serverProperties) {
super(errorAttributes, applicationContext, serverProperties);
}
@Override
protected String getResponseBody(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) {
// 自定义异常处理逻辑
return super.getResponseBody(request, response, handler, ex);
}
}
6. 监控与日志
确保配置好日志记录,以便在出现问题时进行诊断。同时,可以利用 Sentinel 控制台的监控功能来监控规则的效果。
通过以上步骤,你可以在 Spring Cloud Alibaba 中配置和使用 Sentinel 进行流量控制。Sentinel 的强大之处在于它的灵活性和扩展性,可以根据实际需求进行定制化配置,以满足不同场景下的流量控制需求。