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

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

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

名字描述抛异常
FALLBACK_EMITFallback 值传递NO
FALLBACK_SUCCESSFallback 执行完成，没有错误NO
FALLBACK_FAILUREFallback 执行抛出出错YES
FALLBACK_REJECTEDFallback 信号量拒绝，不尝试执行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 个。
    • 例如：如果值为 20，那么在滚动窗口（例如 10 秒）内如果只收到 19 个请求，即使这 19 个全部失败，断路器也不会打开。简言之，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 隔离模式也起作用。

五、属性配置参数

（一）Command Properties

以下属性控制 HystrixCommand 行为：

1、Execution

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

参数描述默认值
execution.isolation.strategy隔离策略，有 THREAD 和 SEMAPHORE。
THREAD - 它在单独的线程上执行，并发请求受线程池中的线程数量的限制。
SEMAPHORE - 它在调用线程上执行，并发请求受到信号量计数的限制。		默认使用 THREAD 模式，以下几种场景可以使用 SEMAPHORE 模式：
1. 只想控制并发度。
2. 外部的方法已经做了线程隔离。
3. 调用的是本地方法或者可靠度非常高、耗时特别小的方法（如 Redis）。
execution.isolation.thread.timeoutInMilliseconds超时时间。默认值：1000。
在 THREAD 模式下，达到超时时间，可以中断。
在 SEMAPHORE 模式下，会等待执行完成后，再去判断是否超时。
设置标准：
有 retry：99 meantime + avg meantime
没有 retry：99.5 meantime
execution.timeout.enabledHystrixCommand.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() 方法的最大请求数。默认值：10（SEMAPHORE 模式有效）
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此属性设置 rolling statistical 窗口划分的桶数。
以下必须为 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.enabledHystrixCommand.getCacheKey() 是否应与 HystrixRequestCache 一起使用，以通过请求范围的缓存提供重复数据删除功能。默认值为 true
requestLog.enabledHystrixCommand 执行和事件是否应记录到 HystrixRequestLog。默认值为 true

（二）Collapser Properties

下列属性控制 HystrixCollapser 行为。

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

（三）ThreadPool Properties

以下属性控制 Hystrix 命令在其上执行的线程池的行为。大多数时候，默认值为 10 的线程会很好（通常可以做得更小）。

参数描述默认值
coreSize线程池 coreSize。
设置标准：qps * 99 meantime + breathing room		默认值：10
maximumSize此属性设置最大线程池大小。这是在不开始拒绝 HystrixCommands 的情况下可以支持的最大并发数。请注意，此设置仅在您还设置 allowMaximumSizeToDivergeFromCoreSize 时才会生效。默认值：10
maxQueueSize请求等待队列。
如果使用正数，队列将从 SynchronousQueue 改为 LinkedBlockingQueue。		默认值：-1
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命令键。默认值：当前执行方法名
说明：Netflix Hystrix 目前已进入维护模式（Maintenance Mode），不再开发新功能。建议在新项目中考虑使用 Resilience4j 或 Sentinel 等替代方案。本文档内容适用于 Hystrix 历史版本参考。