写点什么

Hystrix 技术专题 - 基础配置说明

发布于: 2021 年 03 月 16 日
Hystrix技术专题-基础配置说明

1. 灾难性雪崩效应-服务熔断

enabled

是否开启熔断 默认时 TRUE 开启

requestVolumeThreshold

一个统计窗口内熔断触发的最小个数/10s 默认 20 个

10s 内请求数大于 20 个的时候就启动熔断器.当请求符合熔断条件时将触发 getFallback()

sleepWindowInMiliseconds

熔断多少秒后去尝试请求 5000ms

errorThresholdPercentage

失败率达到多少百分比后熔断 默认配置下采样周期为 10s,失败率为 50%

请求错误大于 50% 时就熔断,然后 for 循环发起请求,当请求符合熔断条件时将触发 getFallback()

forceOpen

是否强制开启熔断 默认 false 不强制

设置为 true 时.所有请求都将被拒绝,直接返回 fallback

forceClosed

是否强制关闭熔断 默认 false 不强制

置为 true 时,将忽略错误

2.什么情况下会触发 fallback 方法

3.fallback 方法什么情况抛出异常


配置信息(最常用的几项)

default 或 HystrixCommandKey

超时时间

(默认 1000ms,单位:ms) 

  • hystrix.command.default.execution.isolation.thread.timeoutInMilliseconds

在调用方配置,被该调用方的所有方法的超时时间都是该值,优先级低于下边的指定配置

  • hystrix.command.HystrixCommandKey.execution.isolation.thread.timeoutInMilliseconds

在调用方配置,被该调用方的指定方法(HystrixCommandKey 方法名)的超时时间是该值-线程池核心线程数

  • hystrix.threadpool.default.coreSize(默认为 10)

Queue

  • hystrix.threadpool.default.maxQueueSize

(最大排队长度。默认-1,使用 SynchronousQueue。其他值则使用 LinkedBlockingQueue。

如果要从-1 换成其他值则需重启,即该值不能动态调整,若要动态调整,需要使用到下边这个配置)

  • hystrix.threadpool.default.queueSizeRejectionThreshold

(排队线程数量阈值,默认为 5,达到时拒绝,如果配置了该选项,队列的大小是该队列)

注意:如果 maxQueueSize=-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 个,断路器开。

  • hystrix.command.default.circuitBreaker.sleepWindowInMilliseconds

(短路多久以后开始尝试是否恢复,默认 5s)

  • hystrix.command.default.circuitBreaker.errorThresholdPercentage

(出错百分比阈值,当达到此阈值后,开始短路。默认 50%)

fallback

  • hystrix.command.default.fallback.isolation.semaphore.maxConcurrentRequests

(调用线程允许请求 HystrixCommand.GetFallback()的最大数量,默认 10)。

(超出时将会有异常抛出,注意:该项配置对于 THREAD 隔离模式也起作用)。

4.属性配置参数

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

Execution

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

execution.isolation.strategy

隔离策略,有 THREAD SEMAPHORE

  • THREAD - 它在单独的线程上执行,并发请求受线程池中的线程数量的限制

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

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


只想控制并发度

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

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

execution.isolation.thread.timeoutInMilliseconds

超时时间

默认值:1000

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

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

设置标准:

有 retry,99 meantime+ avg meantime

没有 retry,99.5 meantime

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 模式有效

Fallback

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

ExecutionIsolationStrategy.SEMAPHORE

fallback.isolation.semaphore.maxConcurrentRequests

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

SEMAPHORE 模式有效

默认值:10

fallback.enabled

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

默认值为 true

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,此属性不执行任何操作。

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

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 默认值:当前执行方法名

 

用户头像

我们始于迷惘,终于更高的迷惘。 2020.03.25 加入

一个酷爱计算机技术、健身运动、悬疑推理的极客狂人,大力推荐安利Java官方文档:https://docs.oracle.com/javase/specs/index.html

评论

发布
暂无评论
Hystrix技术专题-基础配置说明