Hystrix参数说明

末蓝、 2023-05-29 11:44 27阅读 0赞

# 一、什么情况下会触发fallback方法？ #

<table> 
 <thead> 
  <tr> 
   <th><strong>名字</strong></th> 
   <th><strong>描述</strong></th> 
   <th><strong>触发fallback</strong></th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>EMIT</td> 
   <td>值传递</td> 
   <td>NO</td> 
  </tr> 
  <tr> 
   <td>SUCCESS</td> 
   <td>执行完成，没有错误</td> 
   <td>NO</td> 
  </tr> 
  <tr> 
   <td>FAILURE</td> 
   <td>执行抛出异常</td> 
   <td>YES</td> 
  </tr> 
  <tr> 
   <td>TIMEOUT</td> 
   <td>执行开始，但没有在允许的时间内完成</td> 
   <td>YES</td> 
  </tr> 
  <tr> 
   <td>BAD_REQUEST</td> 
   <td>执行抛出HystrixBadRequestException</td> 
   <td>NO</td> 
  </tr> 
  <tr> 
   <td>SHORT_CIRCUITED</td> 
   <td>断路器打开，不尝试执行</td> 
   <td>YES</td> 
  </tr> 
  <tr> 
   <td>THREAD_POOL_REJECTED</td> 
   <td>线程池拒绝，不尝试执行</td> 
   <td>YES</td> 
  </tr> 
  <tr> 
   <td>SEMAPHORE_REJECTED</td> 
   <td>信号量拒绝，不尝试执行</td> 
   <td>YES</td> 
  </tr> 
 </tbody> 
</table>

# 二、fallback方法在什么情况下会抛出异常 #

<table> 
 <thead> 
  <tr> 
   <th><strong>名字</strong></th> 
   <th><strong>描述</strong></th> 
   <th><strong>抛异常</strong></th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>FALLBACK_EMIT</td> 
   <td>Fallback值传递</td> 
   <td>NO</td> 
  </tr> 
  <tr> 
   <td>FALLBACK_SUCCESS</td> 
   <td>Fallback执行完成，没有错误</td> 
   <td>NO</td> 
  </tr> 
  <tr> 
   <td>FALLBACK_FAILURE</td> 
   <td>Fallback执行抛出出错</td> 
   <td>YES</td> 
  </tr> 
  <tr> 
   <td>FALLBACK_REJECTED</td> 
   <td>Fallback信号量拒绝，不尝试执行</td> 
   <td>YES</td> 
  </tr> 
  <tr> 
   <td>FALLBACK_MISSING</td> 
   <td>没有Fallback实例</td> 
   <td>YES</td> 
  </tr> 
 </tbody> 
</table>

# 三、配置信息（default或HystrixCommandKey）最常用的几项 #

**超时时间（默认1000ms，单位：ms）**

（1）hystrix.command.default.execution.isolation.thread.timeoutInMilliseconds

在调用方配置，被该调用方的所有方法的超时时间都是该值，优先级低于下边的指定配置

（2）hystrix.command.HystrixCommandKey.execution.isolation.thread.timeoutInMilliseconds

在调用方配置，被该调用方的指定方法（HystrixCommandKey方法名）的超时时间是该值

**线程池核心线程数**

hystrix.threadpool.default.coreSize（默认为10）

**Queue**

（1）hystrix.threadpool.default.maxQueueSize（最大排队长度。默认-1，使用SynchronousQueue。其他值则使用 LinkedBlockingQueue。如果要从-1换成其他值则需重启，即该值不能动态调整，若要动态调整，需要使用到下边这个配置）

（2）hystrix.threadpool.default.queueSizeRejectionThreshold（排队线程数量阈值，默认为5，达到时拒绝，如果配置了该选项，队列的大小是该队列）

注意：如果maxQueueSize=-1的话，则该选项不起作用

**断路器**

（1）hystrix.command.default.circuitBreaker.requestVolumeThreshold（当在配置时间窗口内达到此数量的失败后，进行短路。默认20个）

For example, if the value is 20, then if only 19 requests are received in the rolling window (say a window of 10 seconds) the circuit will not trip open even if all 19 failed.

简言之，10s内请求失败数量达到20个，断路器开。

（2）hystrix.command.default.circuitBreaker.sleepWindowInMilliseconds（短路多久以后开始尝试是否恢复，默认5s）

（3）ystrix.command.default.circuitBreaker.errorThresholdPercentage（出错百分比阈值，当达到此阈值后，开始短路。默认50%）

**fallback**

hystrix.command.default.fallback.isolation.semaphore.maxConcurrentRequests（调用线程允许请求HystrixCommand.GetFallback()的最大数量，默认10。超出时将会有异常抛出，注意：该项配置对于THREAD隔离模式也起作用）

# **五、属性配置参数** #

参数说明英文地址：[https://github.com/Netflix/Hystrix/wiki/Configuration][https_github.com_Netflix_Hystrix_wiki_Configuration]

HystrixProperty参考代码地址：[http://www.programcreek.com/java-api-examples/index.php?source\_dir=Hystrix-master/hystrix-contrib/hystrix-javanica/src/test/java/com/netflix/hystrix/contrib/javanica/test/common/configuration/command/BasicCommandPropertiesTest.java][http_www.programcreek.com_java-api-examples_index.php_source_dir_Hystrix-master_hystrix-contrib_hystrix-javanica_src_test_java_com_netflix_hystrix_contrib_javanica_test_common_configuration_command_BasicCommandPropertiesTest.java]

## **（一）Command Properties** ##

以下属性控制HystrixCommand行为：

### 1、**Execution** ###

以下属性控制HystrixCommand.run()如何执行。

<table> 
 <thead> 
  <tr> 
   <th><strong>参数</strong></th> 
   <th><strong>描述</strong></th> 
   <th><strong>默认值</strong></th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>execution.isolation.strategy</td> 
   <td>隔离策略，有THREAD和SEMAPHORETHREAD - 它在单独的线程上执行，并发请求受线程池中的线程数量的限制 SEMAPHORE - 它在调用线程上执行，并发请求受到信号量计数的限制</td> 
   <td>默认使用THREAD模式，以下几种场景可以使用SEMAPHORE模式：只想控制并发度外部的方法已经做了线程隔离调用的是本地方法或者可靠度非常高、耗时特别小的方法（如medis）</td> 
  </tr> 
  <tr> 
   <td>execution.isolation.thread.timeoutInMilliseconds</td> 
   <td>超时时间</td> 
   <td>默认值：1000在THREAD模式下，达到超时时间，可以中断在SEMAPHORE模式下，会等待执行完成后，再去判断是否超时设置标准：有retry，99meantime+avg meantime没有retry，99.5meantime</td> 
  </tr> 
  <tr> 
   <td>execution.timeout.enabled</td> 
   <td>HystrixCommand.run（）执行是否应该有超时。</td> 
   <td>默认值：true</td> 
  </tr> 
  <tr> 
   <td>execution.isolation.thread.interruptOnTimeout</td> 
   <td>在发生超时时是否应中断HystrixCommand.run（）执行。</td> 
   <td>默认值：trueTHREAD模式有效</td> 
  </tr> 
  <tr> 
   <td>execution.isolation.thread.interruptOnCancel</td> 
   <td>当发生取消时，执行是否应该中断。</td> 
   <td>默认值为falseTHREAD模式有效</td> 
  </tr> 
  <tr> 
   <td>execution.isolation.semaphore.maxConcurrentRequests</td> 
   <td>设置在使用时允许到HystrixCommand.run（）方法的最大请求数。</td> 
   <td>默认值：10SEMAPHORE模式有效</td> 
  </tr> 
 </tbody> 
</table>

### 2、**Fallback** ###

以下属性控制HystrixCommand.getFallback()如何执行。这些属性适用于ExecutionIsolationStrategy.THREAD和ExecutionIsolationStrategy.SEMAPHORE。

<table> 
 <thead> 
  <tr> 
   <th><strong>参数</strong></th> 
   <th><strong>描述</strong></th> 
   <th><strong>默认值</strong></th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>fallback.isolation.semaphore.maxConcurrentRequests</td> 
   <td>设置从调用线程允许HystrixCommand.getFallback（）方法的最大请求数。</td> 
   <td>SEMAPHORE模式有效默认值：10</td> 
  </tr> 
  <tr> 
   <td>fallback.enabled</td> 
   <td>确定在发生失败或拒绝时是否尝试调用HystrixCommand.getFallback（）。</td> 
   <td>默认值为true</td> 
  </tr> 
 </tbody> 
</table>

### 3、**Circuit Breaker** ###

断路器属性控制HystrixCircuitBreaker的行为。

<table> 
 <thead> 
  <tr> 
   <th><strong>参数</strong></th> 
   <th><strong>描述</strong></th> 
   <th><strong>默认值</strong></th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>circuitBreaker.enabled</td> 
   <td>确定断路器是否用于跟踪运行状况和短路请求（如果跳闸）。</td> 
   <td>默认值为true</td> 
  </tr> 
  <tr> 
   <td>circuitBreaker.requestVolumeThreshold</td> 
   <td>熔断触发的最小个数/10s</td> 
   <td>默认值：20</td> 
  </tr> 
  <tr> 
   <td>circuitBreaker.sleepWindowInMilliseconds</td> 
   <td>熔断多少秒后去尝试请求</td> 
   <td>默认值：5000</td> 
  </tr> 
  <tr> 
   <td>circuitBreaker.errorThresholdPercentage</td> 
   <td>失败率达到多少百分比后熔断</td> 
   <td>默认值：50主要根据依赖重要性进行调整</td> 
  </tr> 
  <tr> 
   <td>circuitBreaker.forceOpen</td> 
   <td>属性如果为真，强制断路器进入打开（跳闸）状态，其中它将拒绝所有请求。</td> 
   <td>默认值为false此属性优先于circuitBreaker.forceClosed</td> 
  </tr> 
  <tr> 
   <td>circuitBreaker.forceClosed</td> 
   <td>该属性如果为真，则迫使断路器进入闭合状态，其中它将允许请求，而不考虑误差百分比。</td> 
   <td>默认值为false如果是强依赖，应该设置为truecircuitBreaker.forceOpen属性优先，因此如果forceOpen设置为true，此属性不执行任何操作。</td> 
  </tr> 
 </tbody> 
</table>

### 4、**Metrics** ###

以下属性与从HystrixCommand和HystrixObservableCommand执行捕获指标有关。

<table> 
 <thead> 
  <tr> 
   <th><strong>参数</strong></th> 
   <th><strong>描述</strong></th> 
   <th><strong>默认值</strong></th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>metrics.rollingStats.timeInMilliseconds</td> 
   <td>此属性设置统计滚动窗口的持续时间（以毫秒为单位）。对于断路器的使用和发布Hystrix保持多长时间的指标。</td> 
   <td>默认值：10000</td> 
  </tr> 
  <tr> 
   <td>metrics.rollingStats.numBuckets</td> 
   <td>此属性设置rollingstatistical窗口划分的桶数。以下必须为true - “metrics.rollingStats.timeInMilliseconds%metrics.rollingStats.numBuckets == 0” -否则将抛出异常。</td> 
   <td>默认值：10</td> 
  </tr> 
  <tr> 
   <td>metrics.rollingPercentile.enabled</td> 
   <td>此属性指示是否应以百分位数跟踪和计算执行延迟。 如果禁用它们，则所有摘要统计信息（平均值，百分位数）都将返回-1。</td> 
   <td>默认值为true</td> 
  </tr> 
  <tr> 
   <td>metrics.rollingPercentile.timeInMilliseconds</td> 
   <td>此属性设置滚动窗口的持续时间，其中保留执行时间以允许百分位数计算，以毫秒为单位。</td> 
   <td>默认值：60000</td> 
  </tr> 
  <tr> 
   <td>metrics.rollingPercentile.numBuckets</td> 
   <td>此属性设置rollingPercentile窗口将划分的桶的数量。以下内容必须为true - “metrics.rollingPercentile.timeInMilliseconds%metrics.rollingPercentile.numBuckets == 0” -否则将抛出异常。</td> 
   <td>默认值：6</td> 
  </tr> 
  <tr> 
   <td>metrics.rollingPercentile.bucketSize</td> 
   <td>此属性设置每个存储桶保留的最大执行次数。如果在这段时间内发生更多的执行，它们将绕回并开始在桶的开始处重写。</td> 
   <td>默认值：100</td> 
  </tr> 
  <tr> 
   <td>metrics.healthSnapshot.intervalInMilliseconds</td> 
   <td>此属性设置在允许计算成功和错误百分比并影响断路器状态的健康快照之间等待的时间（以毫秒为单位）。</td> 
   <td>默认值：500</td> 
  </tr> 
 </tbody> 
</table>

### 5、**Request Context** ###

这些属性涉及HystrixCommand使用的HystrixRequestContext功能。

<table> 
 <thead> 
  <tr> 
   <th><strong>参数</strong></th> 
   <th><strong>描述</strong></th> 
   <th><strong>默认值</strong></th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>requestCache.enabled</td> 
   <td>HystrixCommand.getCacheKey（）是否应与HystrixRequestCache一起使用，以通过请求范围的缓存提供重复数据删除功能。</td> 
   <td>默认值为true</td> 
  </tr> 
  <tr> 
   <td>requestLog.enabled</td> 
   <td>HystrixCommand执行和事件是否应记录到HystrixRequestLog。</td> 
   <td>默认值为true</td> 
  </tr> 
 </tbody> 
</table>

## **（二）Collapser Properties** ##

下列属性控制HystrixCollapser行为。

<table> 
 <thead> 
  <tr> 
   <th><strong>参数</strong></th> 
   <th><strong>描述</strong></th> 
   <th><strong>默认值</strong></th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>maxRequestsInBatch</td> 
   <td>此属性设置在触发批处理执行之前批处理中允许的最大请求数。</td> 
   <td>Integer.MAX_VALUE</td> 
  </tr> 
  <tr> 
   <td>timerDelayInMilliseconds</td> 
   <td>此属性设置创建批处理后触发其执行的毫秒数。</td> 
   <td>默认值：10</td> 
  </tr> 
  <tr> 
   <td>requestCache.enabled</td> 
   <td>此属性指示是否为HystrixCollapser.execute（）和HystrixCollapser.queue（）调用启用请求高速缓存。</td> 
   <td>默认值：true</td> 
  </tr> 
 </tbody> 
</table>

## （三）**ThreadPool Properties** ##

以下属性控制Hystrix命令在其上执行的线程池的行为。

大多数时候，默认值为10的线程会很好（通常可以做得更小）。

<table> 
 <thead> 
  <tr> 
   <th><strong>参数</strong></th> 
   <th><strong>描述</strong></th> 
   <th><strong>默认值</strong></th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>coreSize</td> 
   <td>线程池coreSize</td> 
   <td>默认值：10设置标准：qps*99meantime+breathing room</td> 
  </tr> 
  <tr> 
   <td>maximumSize</td> 
   <td>此属性设置最大线程池大小。 这是在不开始拒绝HystrixCommands的情况下可以支持的最大并发数。 请注意，此设置仅在您还设置allowMaximumSizeToDivergeFromCoreSize时才会生效。</td> 
   <td>默认值：10</td> 
  </tr> 
  <tr> 
   <td>maxQueueSize</td> 
   <td>请求等待队列</td> 
   <td>默认值：-1如果使用正数，队列将从SynchronizeQueue改为LinkedBlockingQueue</td> 
  </tr> 
  <tr> 
   <td>queueSizeRejectionThreshold</td> 
   <td>此属性设置队列大小拒绝阈值 - 即使未达到maxQueueSize也将发生拒绝的人为最大队列大小。 此属性存在，因为BlockingQueue的maxQueueSize不能动态更改，我们希望允许您动态更改影响拒绝的队列大小。</td> 
   <td>默认值：5注意：如果maxQueueSize == -1，则此属性不适用。</td> 
  </tr> 
  <tr> 
   <td>keepAliveTimeMinutes</td> 
   <td>此属性设置保持活动时间，以分钟为单位。</td> 
   <td>默认值：1</td> 
  </tr> 
  <tr> 
   <td>allowMaximumSizeToDivergeFromCoreSize</td> 
   <td>此属性允许maximumSize的配置生效。 那么该值可以等于或高于coreSize。 设置coreSize &lt;maximumSize会创建一个线程池，该线程池可以支持maximumSize并发，但在相对不活动期间将向系统返回线程。 （以keepAliveTimeInMinutes为准）</td> 
   <td>默认值：false</td> 
  </tr> 
  <tr> 
   <td>metrics.rollingStats.timeInMilliseconds</td> 
   <td>此属性设置statistical rolling窗口的持续时间（以毫秒为单位）。 这是为线程池保留多长时间。</td> 
   <td>默认值：10000</td> 
  </tr> 
  <tr> 
   <td>metrics.rollingStats.numBuckets</td> 
   <td>此属性设置滚动统计窗口划分的桶数。 注意：以下必须为true - “metrics.rollingStats.timeInMilliseconds%metrics.rollingStats.numBuckets == 0” -否则将引发异常。</td> 
   <td>默认值：10</td> 
  </tr> 
 </tbody> 
</table>

## （四）**其他** ##

<table> 
 <thead> 
  <tr> 
   <th><strong>参数</strong></th> 
   <th><strong>描述</strong></th> 
   <th><strong>默认值</strong></th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>groupKey</td> 
   <td>表示所属的group，一个group共用线程池</td> 
   <td>默认值：getClass().getSimpleName();</td> 
  </tr> 
  <tr> 
   <td>commandKey</td> 
   <td></td> 
   <td>默认值：当前执行方法名</td> 
  </tr> 
 </tbody> 
</table>

[https_github.com_Netflix_Hystrix_wiki_Configuration]: https://github.com/Netflix/Hystrix/wiki/Configuration
[http_www.programcreek.com_java-api-examples_index.php_source_dir_Hystrix-master_hystrix-contrib_hystrix-javanica_src_test_java_com_netflix_hystrix_contrib_javanica_test_common_configuration_command_BasicCommandPropertiesTest.java]: http://www.programcreek.com/java-api-examples/index.php?source_dir=Hystrix-master/hystrix-contrib/hystrix-javanica/src/test/java/com/netflix/hystrix/contrib/javanica/test/common/configuration/command/BasicCommandPropertiesTest.java