SpringCloud- 第六篇 Hystrix参数配置(三)

1：概述

Hystrix使用Archaius做为配置属性的默认实现。官方配置文档： https://github.com/Netflix/Hystrix/wiki/Configuration
每一个属性有四个优先级，依次增大：

• 1：代码的全局默认值
• 2：动态全局默认属性
  能够使用全局属性文件来更改全局默认值。
  
• 3：代码实例默认
  定义特定于实例的默认值，好比在HystrixCommand构造函数中设置的值
  
• 4：动态实例属性
  能够动态设置实例特定的值，从而覆盖前面三个默认级别，格式是：
  hystrix.command.命令key.属性名称=值
  
  

2：请求上下文

1：requestCache.enabled
设置是否开启请求的缓存功能，默认true
2：requestLog.enabled
设置是否开启请求的日志功能，默认true

3：命令执行

• execution.isolation.strategy
  指示HystrixCommand.run()执行哪一个隔离策略，选项：
  1：THREAD - 它在单独的线程上执行，并发请求受线程池中线程数的限制
  2：SEMAPHORE - 它在调用线程上执行，并发请求受信号计数的限制
  3：官方推荐使用线程隔离策略，默认也是按照线程隔离进行处理。
  4：信号量隔离的方式是限制了总的并发数，每一次请求过来，请求线程和调用依赖服务的线程是同一个线程，那么若是不涉及远程RPC调用（没有网络开销）则使用信号量来隔离，更为轻量，开销更小。
  5：信号量的大小能够动态调整, 线程池大小不能够动态调整。
  6：配置示例：

  @HystrixCommand(fallbackMethod = "error", commandProperties = { @HystrixProperty(name="execution.isolation.strategy", value = "THREAD") })

  
  
  
  
  
  
  
  
• execution.isolation.thread.timeoutInMilliseconds
  表示请求线程总超时时间，若是超过这个设置的时间hystrix就会调用fallback方法。value的参数为毫秒，默认值为1000ms。

  @HystrixCommand(fallbackMethod = "error", commandProperties = { @HystrixProperty(name = "execution.isolation.thread.timeoutInMilliseconds", value = "4000") })

  
  
• execution.timeout.enabled
  这个超时开关表示，当超时后是否触发fallback方法，默认为true。
  
• execution.isolation.thread.interruptOnTimeout
  表示HystrixCommand.run()在发生超时时是否应该中断执行，默认true
  
• execution.isolation.thread.interruptOnCance
  表示HystrixCommand.run()在发生取消时是否应该中断执行，默认false
  
• execution.isolation.semaphore.maxConcurrentRequests
  当隔离策略使用SEMAPHORE时，最大的并发请求量，若是请求超过这个最大值将拒绝后续的请求，默认值为10
  

4：回退

• fallback.isolation.semaphore.maxConcurrentRequests
  设置HystrixCommand.getFallback()方法容许从调用线程进行请求的最大数量，默认10
  若是达到最大并发限制，则随后的请求将被拒绝，并抛出异常。
  
  
• fallback.enabled
  开启fallback功能，默认true
  

5：断路器

• circuitBreaker.enabled
  设置是否将使用断路器来跟踪健康情况，而且若是断路器跳闸则将其短路。默认true
  
• circuitBreaker.requestVolumeThreshold
  设置滚动窗口中将使电路跳闸的最小请求数量，默认20。
  熔断器在整个统计时间内是否开启的阀值，每一个熔断器默认维护10个bucket,每秒一个bucket,每一个bucket记录成功,失败,超时,拒绝的状态，该阈值默认20次。也就是一个统计窗口时间内（10秒钟）至少请求20次，熔断器才启动。
  
  
• circuitBreaker.sleepWindowInMilliseconds
  熔断器默认工做时间,默认值为5秒，熔断器中断请求5秒后会进入半打开状态,放部分流量过去重试，若是重试成功则会恢复正常请求。
  
• circuitBreaker.errorThresholdPercentage
  熔断器错误阈值，默认为50%。当在一个时间窗口内出错率超过50%后熔断器自动启动。熔断器启动后会自动转发到配置的fallbackMethod，进行降级处理。
  
• circuitBreaker.forceOpen
  断路器强制开关，若是设置为true则表示强制打开熔断器，全部请求都会拒绝，默认false
  
• circuitBreaker.forceClosed
  断路器强制开关，若是设置为true则表示强制关闭熔断器，全部请求都会容许，默认false
  

6: 度量指标

• metrics.rollingStats.timeInMilliseconds
  设置统计滚动窗口的持续时间，以毫秒为单位。默认10秒
  
• metrics.rollingStats.numBuckets
  该属性设置滚动统计窗口分红的桶的数量。默认10
  
• metrics.rollingPercentile.enabled
  表示执行延迟是否应该跟踪和计算为百分比。若是被禁用，则全部汇总统计返回为-1。默认true
  
• metrics.rollingPercentile.timeInMilliseconds
  设置滚动窗口的持续时间，在该窗口中保留执行时间以容许百分数计算（单位毫秒），默认1分钟。
  
• metrics.rollingPercentile.numBuckets
  设置rollingPercentile窗口将被分红的桶的数量，默认6
  
• metrics.rollingPercentile.bucketSize
  设置每一个存储桶的最大执行次数，若是在执行屡次，将在桶的开头重写。默认100
  例如，若是存储区大小设置为100，并表示10秒的存储区窗口，但在此期间发生500次执行，则只有最后100次执行将保留在该10秒存储区中
  
  
• metrics.healthSnapshot.intervalInMilliseconds
  设置容许执行健康快照之间等待的时间（以毫秒为单位）。默认500
  

7: ThreadPool配置

• coreSize
  线程池核心线程数，默认值为10。
  
• MAXIMUMSIZE
  设置线程池大小，默认10
  
• maxQueueSize
  配置线程池任务队列的大小，默认值为 -1。当使用 -1 时，SynchronousQueue将被使用，即意味着其实这个队列只是一个交换器，任务将被直接交给工做线程处理。若是工做线程不足，那任务将被拒绝；若是使用任何正整数，LinkedBlockingQueue将被使用
  
• queueSizeRejectionThreshold
  表示等待队列超过阈值后开始拒绝线程请求，默认值为5，若是maxQueueSize为-1，则该属性失效。
  
• keepAliveTimeMinutes
  设置活动保持时间，以分钟为单位，默认1分钟
  
• allowMaximumSizeToDivergeFromCoreSize
  配置maximumSize生效。这个值能够等于或高于coreSize，默认false