SpringCloud 熔断参数配置说明

桃扇骨 2022-04-17 05:27 636阅读 0赞

原

# Spring Cloud Hystrix（服务容错保护） #

2017年06月26日 17:57:42 [jack281706][] 阅读数：3763

![image2017-6-7_23-9-30.png_version_1_modificationDate_1496848170000_api_v2][]

# Hystrix介绍 #

## 简介 ##

Hystrix是由Netflix创建一个类库。

在微服务的分布式环境中，系统存在许多服务依赖。在高并发访问下,这些依赖的稳定性与否对系统的影响非常大,但是依赖有很多不可控问题:如网络连接缓慢，资源繁忙，暂时不可用，服务脱机等。 Hystrix可以通过添加延迟容错和容错逻辑来帮助我们控制这些分布式服务之间的交互。 Hystrix通过隔离服务之间的接入点，阻止它们之间的级联故障，并提供备用选项，从而提高系统的整体弹性。

## Hystrix流程结构 ##

![image2017-6-12_1-20-18.png_version_1_modificationDate_1497201619000_api_v2][]

### 流程说明: ###

1.  每次调用创建一个新的HystrixCommand,把依赖调用封装在run()方法中.
2.  执行execute()/queue做同步或异步调用.
3.  是否开启请求缓存，如果开启了，并且如果缓存中对请求的响应可用，则此缓存响应将立即以“Observable”的形式返回。
4.  判断熔断器(circuit-breaker)是否打开,如果打开跳到步骤8,进行降级策略,如果关闭进入步骤.
5.  判断线程池/队列/信号量是否跑满，如果跑满进入降级步骤8,否则继续后续步骤.
6.  调用HystrixCommand的run方法.运行依赖逻辑
    
    1.  依赖逻辑调用超时,进入步骤8.
7.  判断逻辑是否调用成功
    
    1.  返回成功调用结果
    2.  调用出错，进入步骤8.
8.  计算熔断器状态,所有的运行状态(成功, 失败, 拒绝,超时)上报给熔断器，用于统计从而判断熔断器状态.
9.  getFallback()降级逻辑.
    
     *  以下四种情况将触发getFallback调用：
        
        1.  (1):run()方法抛出非HystrixBadRequestException异常。
        2.  (2):run()方法调用超时
        3.  (3):熔断器开启拦截调用
        4.  (4):线程池/队列/信号量是否跑满
    
    1.  没有实现getFallback的Command将直接抛出异常
    2.  fallback降级逻辑调用成功直接返回
    3.  降级逻辑调用失败抛出异常
10. 返回执行成功结果

## 为什么要使用Hystrix ##

分布式微服务系统中有多依赖，在高并发访问下,这些依赖的稳定性与否对系统的影响非常大,但是依赖有很多不可控问题:如网络连接缓慢，资源繁忙，暂时不可用，服务脱机等。高并发情况下，某个依赖服务(如下面的Vehicle Service)失败，其他依赖服务可用。

![image2017-6-12_1-25-33.png_version_1_modificationDate_1497201934000_api_v2][]

如果不对失败依赖采取隔离措施，将会生产雪崩效应，最终可能导致当前应用服务就有被拖垮的风险。

![image2017-6-12_1-26-9.png_version_1_modificationDate_1497201970000_api_v2][]

**解决以上问题的方案-断路器：**

断路器（英文名称：circuit-breaker，circuit breaker）是指能够关合、承载和开断正常回路条件下的电流并能关合、在规定的时间内承载和开断异常回路条件下的电流的开关装置。

下图是家用配电箱

![image2017-6-12_1-28-3.png_version_1_modificationDate_1497202084000_api_v2][]

![image2017-6-12_1-29-5.png_version_1_modificationDate_1497202146000_api_v2][]

Hystrix实现的断路器模式，在分布式微服务系统中当对特定服务的呼叫达到一定阈值时（Hystrix中默认为20秒，20秒），电路将打开，不进行通话。在错误和开路的情况下，开发人员可以提供后备  
还是回到刚才的底层依赖服务失败的场景，在消费者一端多次调用依赖服务失败，达到断路器开启的阈值，断路器被打开，对应 的FallBack方法被执行，一段时间内将不会再向失败的服务发起请求。

![image2017-6-12_1-34-7.png_version_1_modificationDate_1497202448000_api_v2][]

## 资料 ##

### 官方文档 ###

[http://cloud.spring.io/spring-cloud-static/Dalston.SR1/\#\_circuit\_breaker\_hystrix\_clients][http_cloud.spring.io_spring-cloud-static_Dalston.SR1_circuit_breaker_hystrix_clients]

### 源码地址 ###

[https://github.com/Netflix/Hystrix][https_github.com_Netflix_Hystrix]

### 博文推荐 ###

*  Hystrix 使用与分析  [http://hot66hot.iteye.com/blog/2155036][http_hot66hot.iteye.com_blog_2155036]

# 如何集成Hystrix #

### step1. 在消费者微服务的pom.xml中添加Hystrix依赖 ###

展开源码

### step2. 在启动程序中启用断路器 ###

展开源码

### step3. 在具体方法中添加注解并添加FallBack方法 ###

展开源码

## Hystrix配置 ##

### 配置样例： ###

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div title="Hint: double-click to select code"> 
     <div> 
      <code>@HystrixCommand</code> 
      <code>(fallbackMethod =&nbsp;</code> 
      <code>"stubMyServiceFallBack"</code> 
      <code>,</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>commandProperties = { </code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>@HystrixProperty</code> 
      <code>(name=</code> 
      <code>"execution.isolation.strategy"</code> 
      <code>, value=</code> 
      <code>"SEMAPHORE"</code> 
      <code>)</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>}</code> 
     </div> 
     <div> 
      <code>)</code> 
     </div> 
    </div> </td> 
  </tr> 
 </tbody> 
</table>

### Execution相关的属性的配置： ###

*  hystrix.command.default.execution.isolation.strategy 隔离策略，默认是Thread, 可选Thread｜Semaphore
    
     *  thread 通过线程数量来限制并发请求数，可以提供额外的保护，但有一定的延迟。一般用于网络调用
     *  semaphore 通过semaphore count来限制并发请求数，适用于无网络的高并发请求
 *  hystrix.command.default.execution.isolation.thread.timeoutInMilliseconds 命令执行超时时间，默认1000ms
 *  hystrix.command.default.execution.timeout.enabled 执行是否启用超时，默认启用true
 *  hystrix.command.default.execution.isolation.thread.interruptOnTimeout 发生超时是是否中断，默认true
 *  hystrix.command.default.execution.isolation.semaphore.maxConcurrentRequests 最大并发请求数，默认10，该参数当使用ExecutionIsolationStrategy.SEMAPHORE策略时才有效。如果达到最大并发请求数，请求会被拒绝。理论上选择semaphore size的原则和选择thread size一致，但选用semaphore时每次执行的单元要比较小且执行速度快（ms级别），否则的话应该用thread。  
    semaphore应该占整个容器（tomcat）的线程池的一小部分。

### Fallback相关的属性 ###

这些参数可以应用于Hystrix的THREAD和SEMAPHORE策略

*  hystrix.command.default.fallback.isolation.semaphore.maxConcurrentRequests 如果并发数达到该设置值，请求会被拒绝和抛出异常并且fallback不会被调用。默认10
 *  hystrix.command.default.fallback.enabled 当执行失败或者请求被拒绝，是否会尝试调用hystrixCommand.getFallback() 。默认true

### Circuit Breaker相关的属性 ###

*  hystrix.command.default.circuitBreaker.enabled 用来跟踪circuit的健康性，如果未达标则让request短路。默认true
 *  hystrix.command.default.circuitBreaker.requestVolumeThreshold 一个rolling window内最小的请求数。如果设为20，那么当一个rolling window的时间内（比如说1个rolling window是10秒）收到19个请求，即使19个请求都失败，也不会触发circuit break。默认20
 *  hystrix.command.default.circuitBreaker.sleepWindowInMilliseconds 触发短路的时间值，当该值设为5000时，则当触发circuit break后的5000毫秒内都会拒绝request，也就是5000毫秒后才会关闭circuit。默认5000
 *  hystrix.command.default.circuitBreaker.errorThresholdPercentage错误比率阀值，如果错误率>=该值，circuit会被打开，并短路所有请求触发fallback。默认50
 *  hystrix.command.default.circuitBreaker.forceOpen 强制打开熔断器，如果打开这个开关，那么拒绝所有request，默认false
 *  hystrix.command.default.circuitBreaker.forceClosed 强制关闭熔断器 如果这个开关打开，circuit将一直关闭且忽略circuitBreaker.errorThresholdPercentage

### Metrics相关参数 ###

*  hystrix.command.default.metrics.rollingStats.timeInMilliseconds 设置统计的时间窗口值的，毫秒值，circuit break 的打开会根据1个rolling window的统计来计算。若rolling window被设为10000毫秒，则rolling window会被分成n个buckets，每个bucket包含success，failure，timeout，rejection的次数的统计信息。默认10000
 *  hystrix.command.default.metrics.rollingStats.numBuckets 设置一个rolling window被划分的数量，若numBuckets＝10，rolling window＝10000，那么一个bucket的时间即1秒。必须符合rolling window % numberBuckets == 0。默认10
 *  hystrix.command.default.metrics.rollingPercentile.enabled 执行时是否enable指标的计算和跟踪，默认true
 *  hystrix.command.default.metrics.rollingPercentile.timeInMilliseconds 设置rolling percentile window的时间，默认60000
 *  hystrix.command.default.metrics.rollingPercentile.numBuckets 设置rolling percentile window的numberBuckets。逻辑同上。默认6
 *  hystrix.command.default.metrics.rollingPercentile.bucketSize 如果bucket size＝100，window＝10s，若这10s里有500次执行，只有最后100次执行会被统计到bucket里去。增加该值会增加内存开销以及排序的开销。默认100
 *  hystrix.command.default.metrics.healthSnapshot.intervalInMilliseconds 记录health 快照（用来统计成功和错误绿）的间隔，默认500ms

### Request Context 相关参数 ###

hystrix.command.default.requestCache.enabled 默认true，需要重载getCacheKey()，返回null时不缓存  
hystrix.command.default.requestLog.enabled 记录日志到HystrixRequestLog，默认true

### Collapser Properties 相关参数 ###

hystrix.collapser.default.maxRequestsInBatch 单次批处理的最大请求数，达到该数量触发批处理，默认Integer.MAX\_VALUE  
hystrix.collapser.default.timerDelayInMilliseconds 触发批处理的延迟，也可以为创建批处理的时间＋该值，默认10  
hystrix.collapser.default.requestCache.enabled 是否对HystrixCollapser.execute() and HystrixCollapser.queue()的cache，默认true

### ThreadPool 相关参数 ###

线程数默认值10适用于大部分情况（有时可以设置得更小），如果需要设置得更大，那有个基本得公式可以follow：  
requests per second at peak when healthy × 99th percentile latency in seconds + some breathing room  
每秒最大支撑的请求数 *(99%平均响应时间 + 缓存值)  
比如：每秒能处理1000个请求，99%的请求响应时间是60ms，那么公式是：  
1000 *（0.060+0.012）

基本得原则时保持线程池尽可能小，他主要是为了释放压力，防止资源被阻塞。  
当一切都是正常的时候，线程池一般仅会有1到2个线程激活来提供服务

*  hystrix.threadpool.default.coreSize 并发执行的最大线程数，默认10
 *  hystrix.threadpool.default.maxQueueSize BlockingQueue的最大队列数，当设为－1，会使用SynchronousQueue，值为正时使用LinkedBlcokingQueue。该设置只会在初始化时有效，之后不能修改threadpool的queue size，除非reinitialising thread executor。默认－1。
 *  hystrix.threadpool.default.queueSizeRejectionThreshold 即使maxQueueSize没有达到，达到queueSizeRejectionThreshold该值后，请求也会被拒绝。因为maxQueueSize不能被动态修改，这个参数将允许我们动态设置该值。if maxQueueSize == -1，该字段将不起作用
 *  hystrix.threadpool.default.keepAliveTimeMinutes 如果corePoolSize和maxPoolSize设成一样（默认实现）该设置无效。如果通过plugin（[https://github.com/Netflix/Hystrix/wiki/Plugins）使用自定义实现，该设置才有用，默认1][https_github.com_Netflix_Hystrix_wiki_Plugins_1].
 *  hystrix.threadpool.default.metrics.rollingStats.timeInMilliseconds 线程池统计指标的时间，默认10000
 *  hystrix.threadpool.default.metrics.rollingStats.numBuckets 将rolling window划分为n个buckets，默认10

### 官方说明： ###

[https://github.com/Netflix/Hystrix/wiki/Configuration][https_github.com_Netflix_Hystrix_wiki_Configuration]

[jack281706]: https://me.csdn.net/jack281706
[image2017-6-7_23-9-30.png_version_1_modificationDate_1496848170000_api_v2]: /images/20220417/2bbbeb03d68e4f7a9b27b0804dc575c4.png
[image2017-6-12_1-20-18.png_version_1_modificationDate_1497201619000_api_v2]: /images/20220417/f646153978d34551a3d57ffe34c5e540.png
[image2017-6-12_1-25-33.png_version_1_modificationDate_1497201934000_api_v2]: /images/20220417/cdb41dc16a9d4f97ba9cebbe370b6618.png
[image2017-6-12_1-26-9.png_version_1_modificationDate_1497201970000_api_v2]: /images/20220417/e76bd87a83b04907832326d24fca8558.png
[image2017-6-12_1-28-3.png_version_1_modificationDate_1497202084000_api_v2]: /images/20220417/583659007dcc4fb287b602e3c3efd45f.png
[image2017-6-12_1-29-5.png_version_1_modificationDate_1497202146000_api_v2]: /images/20220417/e70010fca68c442c8a356cf644571007.png
[image2017-6-12_1-34-7.png_version_1_modificationDate_1497202448000_api_v2]: /images/20220417/f42a0de7edb047ff9e4849121f670b1b.png
[http_cloud.spring.io_spring-cloud-static_Dalston.SR1_circuit_breaker_hystrix_clients]: http://cloud.spring.io/spring-cloud-static/Dalston.SR1/#_circuit_breaker_hystrix_clients
[https_github.com_Netflix_Hystrix]: https://github.com/Netflix/Hystrix
[http_hot66hot.iteye.com_blog_2155036]: http://hot66hot.iteye.com/blog/2155036
[https_github.com_Netflix_Hystrix_wiki_Plugins_1]: https://github.com/Netflix/Hystrix/wiki/Plugins%EF%BC%89%E4%BD%BF%E7%94%A8%E8%87%AA%E5%AE%9A%E4%B9%89%E5%AE%9E%E7%8E%B0%EF%BC%8C%E8%AF%A5%E8%AE%BE%E7%BD%AE%E6%89%8D%E6%9C%89%E7%94%A8%EF%BC%8C%E9%BB%98%E8%AE%A41
[https_github.com_Netflix_Hystrix_wiki_Configuration]: https://github.com/Netflix/Hystrix/wiki/Configuration