《Spring Cloud Netflix官方文档》3.熔断器:Hystrix Clients
原文链接
Netfilix创建了一个名为Hystrix的库,实现了熔断器模式。在微服务架构中,它通常有多个服务调用层。
![](http://ifeve.com/wp-content/uploads/2017/12/HystrixGraph.png)
图3.1 微服务图
一个底层服务的故障会引发直至用户交互层的连锁故障。在一个设定时长为“metrics.rollingStats.timeInMilliseconds”(默认为十秒)的滚动窗口内,对一个特定服务的请求数大于“circuitBreaker.requestVolumeThreshold”(默认为20个),并且故障率大于“circuitBreaker.errorThresholdPercentage”(默认大于百分之五十)的时候,启用熔断机制以使请求失效。在熔断和报错的情况下,开发者可以启用回退机制。
![](http://ifeve.com/wp-content/uploads/2017/12/HystrixFallback.png)
图3.2 Hystrix回退以防止连锁故障
启用熔断机制能防止连锁故障的情况,给故障服务提供时间以恢复正常。回退操作可以是另一个Hystrix受保护的调用、静态数据或是一个恰当的空值。回退操作可能是成串的,所以第一个回退操作会做一些其他的业务请求,让故障回退到预设的值。
扫描二维码关注公众号,回复:
2985423 查看本文章
3.1 如何引入Hystrix
使用group为“org.springframework.cloud”, artifact id为“spring-cloud-starter-hystrix”的启动器引入Hystrix。请参阅Spring Cloud Project页面,以获取有关使用当前Spring Cloud Release Train设置构建系统的详细信息。
Boot app 样例:
01 |
@SpringBootApplication |
03 |
public class Application { |
05 |
public static void main(String[] args) { |
06 |
new SpringApplicationBuilder(Application. class ).web( true ).run(args); |
12 |
public class StoreIntegration { |
14 |
@HystrixCommand (fallbackMethod = "defaultStores" ) |
15 |
public Object getStores(Map<String, Object> parameters) { |
16 |
//do stuff that might fail |
19 |
public Object defaultStores(Map<String, Object> parameters) { |
20 |
return /* something useful */ ; |
注解@HystrixCommand由Netflix contrib library提供,被称作“javanica”。Spring Cloud会自动将包含该注释的Spring bean封装在连接到Hystrix熔断器的代理中。熔断器会计算何时启用或关闭熔断机制,并决定在故障时该做什么。
可以使用带有@HystrixProperty注解列表的commandProperties属性配置@HystrixCommand。点击这里获取更多详情。另外,有关可用属性的详细信息,请参阅Hystrix wiki。
3.2传播Security Context或使用Spring Scope
如果想要一些线程本地上下文传播到@HystrixCommand,默认的声明将不起作用,因为它执行的是线程池中的命令(在超时的情况下)。可以使用某种配置将Hystrix切换为使用与调用方相同的线程,或直接在注解中请求使用不同的“隔离策略”。如下所示:
1 |
@HystrixCommand (fallbackMethod = "stubMyService" , |
3 |
@HystrixProperty (name= "execution.isolation.strategy" , value= "SEMAPHORE" ) |
以上操作,同样适用于使用@SessionScope或@RequestScope的时候。当抛出“无法找到范围内的上下文”的运行时异常,就需要执行这些操作。
同样可以设置属性“hystrix.shareSecurityContext”为true。这样做会自动配置一个Hystrix并发策略插件钩子,它将从主线程传输SecurityContext到Hystrix命令使用的钩子。Hystrix不允许注册多个hystrix并发策略。因此会通过将自己的HystrixConcurrencyStrategy声明为Spring bean的方法,使用扩展机制。Spring Cloud会在上下文中查找你的实现,并封装进它自己的插件中。
3.3健康监控
连接熔断器的状态也可以在请求应用程序的/health端口查看。
3 |
"openCircuitBreakers" : [ |
4 |
"StoreIntegration::getStoresByLocationLink" |
6 |
"status" : "CIRCUIT_OPEN" |
3.4 Hystrix 数据流
配置spring-boot-starter-actuator的依赖以启用Hystrix 数据流。这将启用端口/hystrix.stream作为一个管理终端。
2 |
<groupId>org.springframework.boot</groupId> |
3 |
<artifactId>spring-boot-starter-actuator<artifactId> |