Hystrix使⽤说明，配置参数说明
什么情况下会触发fallback⽅法？
⼀、
⼀、什么情况下会触发
名字描述触发fallback
EMIT值传递NO
SUCCESS执⾏完成，没有错误NO
FAILURE执⾏抛出异常YES
TIMEOUT执⾏开始，但没有在允许的时间内完成YES
BAD_REQUEST执⾏抛出HystrixBadRequestException NO
SHORT_CIRCUITED断路器打开，不尝试执⾏YES
THREAD_POOL_REJECTED线程池拒绝，不尝试执⾏YES
SEMAPHORE_REJECTED信号量拒绝，不尝试执⾏YES
⼆、fallback⽅法在什么情况下会抛出异常
名字描述抛异常
FALLBACK_EMIT Fallback值传递NO
FALLBACK_SUCCESS Fallback执⾏完成，没有错误NO
FALLBACK_FAILURE Fallback执⾏抛出出错YES
FALLBACK_REJECTED Fallback信号量拒绝，不尝试执⾏YES
FALLBACK_MISSING没有Fallback实例YES
三、hystrix dashboard界⾯监控参数
四、配置信息（default或HystrixCommandKey）最常⽤的⼏项
超时时间（默认1000ms，单位：ms）
（1）ution.isolation.thread.timeoutInMilliconds
在调⽤⽅配置，被该调⽤⽅的所有⽅法的超时时间都是该值，优先级低于下边的指定配置
（2）ution.isolation.thread.timeoutInMilliconds
在调⽤⽅配置，被该调⽤⽅的指定⽅法（HystrixCommandKey⽅法名）的超时时间是该值
线程池核⼼线程数
hystrix.Size（默认为10）
Queue
（1）hystrix.threadpool.default.maxQueueSize（最⼤排队长度。默认-1，使⽤SynchronousQueue。其他值则使⽤ LinkedBlockingQueue。如果要从-1换成其他值则需重启，即该值不能动态调整，若要动态调整，需要使⽤到下边这个配置）
（2）hystrix.threadpool.default.queueSizeRejectionThreshold（排队线程数量阈值，默认为5，达到
时拒绝，如果配置了该选项，队列的⼤⼩是该队列）注意：如果maxQueueSize=-1的话，则该选项不起作⽤
断路器
（1）and.questVolumeThreshold（当在配置时间窗⼝内达到此数量的失败后，进⾏短路。默认20个）
For example, if the value is 20, then if only 19 requests are received in the rolling window (say a window of 10 conds) the circuit will not trip open even if all 19 failed.
简⾔之，10s内请求失败数量达到20个，断路器开。
（2）and.default.circuitBreaker.sleepWindowInMilliconds（短路多久以后开始尝试是否恢复，默认5s）
（3）and.ThresholdPercentage（出错百分⽐阈值，当达到此阈值后，开始短路。默认50%）
fallback
五、属性配置参数
（⼀）Command Properties
以下属性控制HystrixCommand⾏为：
1、Execution
以下属性控制HystrixCommand.run()如何执⾏。
参数描述默认值
execution.isolation.strategy隔离策略，有THREAD和SEMAPHORE
THREAD - 它在单独的线程上执⾏，并发请求受
线程池中的线程数量的限制
SEMAPHORE - 它在调⽤线程上执⾏，并发请求
受到信号量计数的限制默认使⽤THREAD模式，以下⼏种场景可以使⽤SEMAPHORE模式：
只想控制并发度
外部的⽅法已经做了线程隔离
调⽤的是本地⽅法或者可靠度⾮常⾼、耗时特别⼩的⽅法（如medis）
execution.isolation.thread.timeoutInMilliconds超时时间默认值：1000
在THREAD模式下，达到超时时间，可以中
断
在SEMAPHORE模式下，会等待执⾏完成
后，再去判断是否超时
设置标准：
有retry，99meantime+avg meantime
没有retry，99.5meantime
abled HystrixCommand.run（）执⾏是否应该有超时。默认值：true
execution.isolation.thread.interruptOnTimeout在发⽣超时时是否应中
断HystrixCommand.run（）执⾏。默认值：true THREAD模式有效
execution.isolation.thread.interruptOnCancel当发⽣取消时，执⾏是否应该中断。默认值为fal
THREAD模式有效
execution.isolation.maphore.maxConcurrentRequests设置在使⽤时允许到HystrixCommand.run（）⽅
法的最⼤请求数。默认值：10 SEMAPHORE模式有效
2、Fallback
以下属性控制Fallback()如何执⾏。这些属性适⽤
于ExecutionIsolationStrategy.THREAD和ExecutionIsolationStrategy.SEMAPHORE。
参数描述默认值
fallback.isolation.maphore.maxConcurrentRequests设置从调⽤线程允许Fallback（）⽅法的最⼤请求
数。SEMAPHORE模式有效
默认值：10
⽤Fallback（）。
默认值为true 3、Circuit Breaker
断路器属性控制HystrixCircuitBreaker的⾏为。
参数描述默认值
跳闸）。
默认值为true
circuitBreaker.sleepWindowInMilliconds熔断多少秒后去尝试请求默认值：5000
主要根据依赖重要性进⾏调整circuitBreaker.forceOpen属性如果为真，强制断路器进⼊打开（跳闸）状态，
其中它将拒绝所有请求。
默认值为fal
此属性优先于circuitBreaker.forceClod circuitBreaker.forceClod该属性如果为真，则迫使断路器进⼊闭合状态，其中
它将允许请求，⽽不考虑误差百分⽐。
默认值为fal
如果是强依赖，应该设置为true
circuitBreaker.forceOpen属性优先，因此如
果forceOpen设置为true，此属性不执⾏任何操作。
4、Metrics
以下属性与从HystrixCommand和HystrixObrvableCommand执⾏捕获指标有关。
参数描述默认值
多长时间的指标。默认值：10000
以下必须为true - “llingStats.llingStats.numBuckets ==
0” -否则将抛出异常。默认值：10
均值，百分位数）都将返回-1。默认值为true
llingPercentile.numBuckets此属性设置rollingPercentile窗⼝将划分的桶的数量。
以下内容必须为true -
“llingPercentile.llingPercentile.numBuckets == 0” -否
则将抛出异常。
默认值：6
发⽣更多的执⾏，它们将绕回
并开始在桶的开始处重写。默认值：100
metrics.healthSnapshot.intervalInMilliconds此属性设置在允许计算成功和错误百分⽐并影响断路器状态的健康快照之间等待的时间（以毫
秒为单位）。默认值：500
5、Request Context
这些属性涉及HystrixCommand使⽤的HystrixRequestContext功能。
参数描述默认值
true
（⼆
（⼆）
）Collapr Properties
下列属性控制HystrixCollapr⾏为。
参数描述默认值maxRequestsInBatch此属性设置在触发批处理执⾏之前批处理中允许的最⼤请求数。Integer.MAX_VALUE timerDelayInMilliconds此属性设置创建批处理后触发其执⾏的毫秒数。默认值：abled此属性指⽰是否为ute（）和HystrixCollapr.queue（）调⽤启⽤请求⾼速缓存。默认值：true （三）ThreadPool Properties
以下属性控制Hystrix命令在其上执⾏的线程池的⾏为。
⼤多数时候，默认值为10的线程会很好（通常可以做得更⼩）。
参数描述默认值
coreSize线程池coreSize默认值：10
设置标
准：qps*99meantime+breathing
room
maximumSize此属性设置最⼤线程池⼤⼩。这是在不开始拒绝HystrixCommands的情
况下可以⽀持的最⼤并发数。请注意，此设置仅在您还设
置allowMaximumSizeToDivergeFromCoreSize时才会⽣效。
默认值：10 maxQueueSize请求等待队列默认值：-1
如果使⽤正数，队列将
从SynchronizeQueue改
为LinkedBlockingQueue
queueSizeRejectionThreshold此属性设置队列⼤⼩拒绝阈值 - 即使未达到maxQueueSize也将发⽣拒绝
的⼈为最⼤队列⼤⼩。此属性存在，因
为BlockingQueue的maxQueueSize不能动态更改，我们希望允许您动态默认值：5
注意：如果maxQueueSize == -
更改影响拒绝的队列⼤⼩。1，则此属性不适⽤。keepAliveTimeMinutes此属性设置保持活动时间，以分钟为单位。默认值：1
allowMaximumSizeToDivergeFromCoreSize此属性允许maximumSize的配置⽣效。那么该值可以等于或⾼
默认值：fal
于coreSize。设置coreSize <maximumSize会创建⼀个线程池，该线程池
可以⽀持maximumSize并发，但在相对不活动期间将向系统返回线程。
（以keepAliveTimeInMinutes为准）
llingStats.timeInMilliconds此属性设置statistical rolling窗⼝的持续时间（以毫秒为单位）。
这是为
默认值：10000
线程池保留多长时间。
默认值：10
注意：以下必须为true -
“llingStats.llingStats.numBuckets
== 0” -否则将引发异常。
（四）其他
参数描述默认值
groupKey表⽰所属的group，⼀个group共⽤线程池默认值：getClass().getSimpleName();
commandKey默认值：当前执⾏⽅法名
