Hystrix使用说明,配置参数说明

    科技2024-10-02  28

    一、什么情况下会触发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)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)hystrix.command.default.circuitBreaker.errorThresholdPercentage(出错百分比阈值,当达到此阈值后,开始短路。默认50%)

    fallback

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

     

    五、属性配置参数

    参数说明英文地址: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

     

    (一)Command Properties

    以下属性控制HystrixCommand行为:

    1、Execution

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

     

    参数

    描述

    默认值

    execution.isolation.strategy

    隔离策略,有THREAD和SEMAPHORE

    THREAD - 它在单独的线程上执行,并发请求受线程池中的线程数量的限制 SEMAPHORE - 它在调用线程上执行,并发请求受到信号量计数的限制

    默认使用THREAD模式,以下几种场景可以使用SEMAPHORE模式:

    只想控制并发度

    外部的方法已经做了线程隔离

    调用的是本地方法或者可靠度非常高、耗时特别小的方法(如medis)

     

    execution.isolation.thread.timeoutInMilliseconds

    超时时间

    默认值:1000

    在THREAD模式下,达到超时时间,可以中断

    在SEMAPHORE模式下,会等待执行完成后,再去判断是否超时

    设置标准:

    有retry,99meantime+avg meantime

    没有retry,99.5meantime

     

    execution.timeout.enabled

    HystrixCommand.run()执行是否应该有超时。

    默认值:true

    execution.isolation.thread.interruptOnTimeout

    在发生超时时是否应中断HystrixCommand.run()执行。

    默认值:true

    THREAD模式有效

    execution.isolation.thread.interruptOnCancel

    当发生取消时,执行是否应该中断。

    默认值为false

    THREAD模式有效

    execution.isolation.semaphore.maxConcurrentRequests

    设置在使用时允许到HystrixCommand.run()方法的最大请求数。

    默认值:10

    SEMAPHORE模式有效

     

    2、Fallback

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

    参数

    描述

    默认值

    fallback.isolation.semaphore.maxConcurrentRequests

    设置从调用线程允许HystrixCommand.getFallback()方法的最大请求数。

    SEMAPHORE模式有效

    默认值:10

    fallback.enabled

    确定在发生失败或拒绝时是否尝试调用HystrixCommand.getFallback()。

    默认值为true

     

    3、Circuit Breaker

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

     

    参数

    描述

    默认值

    circuitBreaker.enabled

    确定断路器是否用于跟踪运行状况和短路请求(如果跳闸)。

    默认值为true

    circuitBreaker.requestVolumeThreshold

    熔断触发的最小个数/10s

    默认值:20

    circuitBreaker.sleepWindowInMilliseconds

    熔断多少秒后去尝试请求

    默认值:5000

    circuitBreaker.errorThresholdPercentage

    失败率达到多少百分比后熔断

    默认值:50

    主要根据依赖重要性进行调整

     

    circuitBreaker.forceOpen

     

    属性如果为真,强制断路器进入打开(跳闸)状态,其中它将拒绝所有请求。

    默认值为false

    此属性优先于circuitBreaker.forceClosed

    circuitBreaker.forceClosed

    该属性如果为真,则迫使断路器进入闭合状态,其中它将允许请求,而不考虑误差百分比。

    默认值为false

    如果是强依赖,应该设置为true

    circuitBreaker.forceOpen属性优先,因此如果forceOpen设置为true,此属性不执行任何操作。

     

    4、Metrics

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

    参数

    描述

    默认值

    metrics.rollingStats.timeInMilliseconds

    此属性设置统计滚动窗口的持续时间(以毫秒为单位)。对于断路器的使用和发布Hystrix保持多长时间的指标。

    默认值:10000

    metrics.rollingStats.numBuckets

    此属性设置rollingstatistical窗口划分的桶数。

    以下必须为true - “metrics.rollingStats.timeInMilliseconds%metrics.rollingStats.numBuckets == 0” -否则将抛出异常。

    默认值:10

    metrics.rollingPercentile.enabled

    此属性指示是否应以百分位数跟踪和计算执行延迟。 如果禁用它们,则所有摘要统计信息(平均值,百分位数)都将返回-1。

    默认值为true

    metrics.rollingPercentile.timeInMilliseconds

     

    此属性设置滚动窗口的持续时间,其中保留执行时间以允许百分位数计算,以毫秒为单位。

    默认值:60000

    metrics.rollingPercentile.numBuckets

    此属性设置rollingPercentile窗口将划分的桶的数量。

    以下内容必须为true - “metrics.rollingPercentile.timeInMilliseconds%metrics.rollingPercentile.numBuckets == 0” -否则将抛出异常。

    默认值:6

    metrics.rollingPercentile.bucketSize

    此属性设置每个存储桶保留的最大执行次数。如果在这段时间内发生更多的执行,它们将绕回并开始在桶的开始处重写。

    默认值:100

    metrics.healthSnapshot.intervalInMilliseconds

    此属性设置在允许计算成功和错误百分比并影响断路器状态的健康快照之间等待的时间(以毫秒为单位)。

    默认值:500

     

    5、Request Context

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

     

    参数

    描述

    默认值

    requestCache.enabled

    HystrixCommand.getCacheKey()是否应与HystrixRequestCache一起使用,以通过请求范围的缓存提供重复数据删除功能。

    默认值为true

    requestLog.enabled

    HystrixCommand执行和事件是否应记录到HystrixRequestLog。

    默认值为true

     

     

    (二)Collapser Properties

    下列属性控制HystrixCollapser行为。

    参数

    描述

    默认值

    maxRequestsInBatch

     

    此属性设置在触发批处理执行之前批处理中允许的最大请求数。

    Integer.MAX_VALUE

    timerDelayInMilliseconds

     

    此属性设置创建批处理后触发其执行的毫秒数。

    默认值:10

    requestCache.enabled

     

    此属性指示是否为HystrixCollapser.execute()和HystrixCollapser.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为准)

    默认值:false

    metrics.rollingStats.timeInMilliseconds

    此属性设置statistical rolling窗口的持续时间(以毫秒为单位)。 这是为线程池保留多长时间。

    默认值:10000

    metrics.rollingStats.numBuckets

    此属性设置滚动统计窗口划分的桶数。 注意:以下必须为true - “metrics.rollingStats.timeInMilliseconds%metrics.rollingStats.numBuckets == 0” -否则将引发异常。

    默认值:10

     

     

    (四)其他

     

    参数

    描述

    默认值

    groupKey

    表示所属的group,一个group共用线程池

    默认值:getClass().getSimpleName();

    commandKey

     

    默认值:当前执行方法名

     

    配置举例: 

    "hystrix": {     "command": {       //针对某个具体的Command设置       //"ClientServiceCommand": {       //  "execution": {       //    "isolation": {       //      "thread": {       //        "timeoutInMilliseconds": 10       //      }       //    }       //  }       //},       //默认设置       "default": {         "execution": {           "timeout": {             "enabled": true           },           "isolation": {             "strategy": "THREAD",             "thread": {               //客户端请求处理超时时间               "timeoutInMilliseconds": 15000             }           }         },         "circuitBreaker": {           //是否启用,默认是true           "enabled": true,           //在指定时间窗口内,熔断触发的最小个数           "requestVolumeThreshold": 5,           //熔断多少时间后去尝试请求           "sleepWindowInMilliseconds": 5000,           //失败率达到多少百分比后熔断           "errorThresholdPercentage": 50,           //是否强制开启熔断           "forceOpen": false,           //是否强制关闭熔断           "forceClosed": false         },         //是否启用fallback         "fallback": {           "enabled": true         }       }     }   }

    Processed: 0.009, SQL: 8