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
三、配置信息(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和
SEMAPHORETHREAD - 它在单独的线程上
执⾏,并发请求受线程池中的线程数量的限制
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()执⾏。
默认值:trueTHREAD模式有效
execution.isolation.thread.interruptOnCancel当发⽣取消时,执⾏是否应该中断。默认值为falTHREAD模式有效
execution.isolation.maphore.maxConcurrentRequests
设置在使⽤时允许到
HystrixCommand.run()⽅法的最⼤请求
数。
默认值:10SEMAPHORE模式有效
2、Fallback
以下属性控制Fallback()如何执⾏。这些属性适⽤于ExecutionIsolationStrategy.THREAD和ExecutionIsolationStrategy.SEMAPHORE。
参数描述默认值
fallback.isolation.maphore.maxConcurrentRequests 设置从调⽤线程允许Fallback()⽅法的最⼤
请求数。
SEMAPHORE模式有效默认
值:10
天的笔顺abled
确定在发⽣失败或拒绝时是否尝试调⽤
默认值为true
3、Circuit Breaker
断路器属性控制HystrixCircuitBreaker的⾏为。
参数描述默认值
求(如果跳闸)。
默认值为true
circuitBreaker.forceOpen 属性如果为真,强制断路器进⼊打开(跳
闸)状态,其中它将拒绝所有请求。
默认值为fal此属性优先于circuitBreaker.forceClod
circuitBreaker.forceClod 该属性如果为真,则迫使断路器进⼊闭合状
态,其中它将允许请求,⽽不考虑误差百分
⽐。
默认值为fal如果是强依赖,应该设置为
truecircuitBreaker.forceOpen属性优先,因此如果forceOpen设置
为true,此属性不执⾏任何操作。
参数描述默认值
4、Metrics
以下属性与从HystrixCommand和HystrixObrvableCommand执⾏捕获指标有关。
参数描述默认值
的指标。
默认
值:
10000
此属性设置rollingstatistical窗⼝划分的桶数。以下必须为true -
“llingStats.llingStats.numBuckets == 0” -否则将抛
出异常。
默认
值:10
邀请函的英文分位数)都将返回-1。
默认值
为true
默认值:60000
心驰神往
此属性设置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的配置⽣效。 那么该值可以等于或⾼于coreSize。 设置
coreSize <maximumSize会创建⼀个线程池,该线程池可以⽀持maximumSize并
发,但在相对不活动期间将向系统返回线程。 (以keepAliveTimeInMinutes为千字开头的成语
准)
默认值:fal
留多长时间。
默认值:10000
此属性设置滚动统计窗⼝划分的桶数。 注意:以下必须为true -
“llingStats.llingStats.numBuckets
== 0” -否则将引发异常。
默认值:10
(四)其他
参数描述默认值groupKey表⽰所属的group,⼀个group共⽤线程池默认值:getClass().getSimpleName();
commandKey默认值:当前执⾏⽅法名