熔断是一种流量管理的策略，用于在系统出现故障或超负荷的情况下，保护系统免受进一步的损害。在传统的Java服务中，使用Resilience4j等框架可以实现熔断功能。然而，与传统方式相比，Istio的熔断功能在网络级别提供支持，不需要在每个服务的应用程序代码中进行集成。您可以通过配置连接池来实现熔断功能，提高系统的稳定性和可靠性，保护目标服务免受异常请求的影响。
前提条件
连接池参数说明
启用熔断功能前，您需要创建一个目标规则为目标服务配置熔断。关于目标规则的字段说明，请参见目标规则（Destination Rule）CRD说明。
连接池connectionPool字段定义了与熔断功能相关的参数。常见的连接池参数说明如下。
参数 | 类型 | 是否必选 | 说明 | 默认值 |
| int32 | 否 | 到目标主机的最大HTTP1或TCP连接数。连接数限制会在客户端及服务端 Sidecar 两侧均生效，即，单个客户端Pod无法向该服务发起超过该配置的连接数，单个服务端也不能接受超过该连接数的连接。整个服务端应用服务可接受的连接数计算方法为min(client pod数量, server pod数量) * maxConnections。 | 2³²-1 |
| int32 | 否 | 等待就绪的连接池连接时，可以排队等待的最大请求数量。 | 1024 |
| int32 | 否 | 对后端服务的最大活跃请求数。 | 1024 |
在简单场景中，例如一个客户端和一个目标服务实例（在Kubernetes环境中，一个实例相当于一个Pod）的情况下参数的配置较为清晰。但在实际生产环境中，可能出现以下场景：
一个客户端实例和多个目标服务实例。
多个客户端实例和单个目标服务实例。
多个客户端实例和多个目标服务实例。
在不同的场景中，需要根据实际需求来调整这些参数的值，以确保连接池能够适应高负载和复杂的环境，并提供良好的性能和可靠性。下文将针对以上场景配置连接池，帮助您了解该配置对客户端和目标服务端的约束情况，进而配置适用自身生产环境的熔断策略。
示例介绍
本文创建两个Python脚本，一个表示目标服务，另一个表示调用服务的客户端。
服务器脚本使用Flask框架创建一个应用程序，并在根路由上定义一个API端点。当访问根路由时，服务器会休眠5秒，然后返回一个包含
"Hello World!"字符串的JSON响应。客户端脚本以10个为一组调用服务器端点，即10个并行请求。在发送下一批10个请求之前，客户端脚本会休眠一段时间。该脚本会在无限循环中执行此操作。为了确保当运行客户端的多个Pod时，它们都同时发送批处理，本示例使用系统时间（每分钟的第0、20和40秒）发送批处理。
部署示例应用
使用以下内容创建YAML文件，然后执行
kubectl apply -f ${YAML文件名称}.yaml命令，部署示例应用。执行以下命令，查看客户端和服务器端对应的Pod。
kubectl get po |grep circuit预期输出：
circuit-breaker-sample-client-d4f64d66d-fwrh4 2/2 Running 0 1m22s circuit-breaker-sample-server-6d6ddb4b-gcthv 2/2 Running 0 1m22s
在没有明确定义目标规则限制的情况下，服务器端可以处理并发的10个客户端请求，因此服务器的响应结果始终为200。客户端的日志示例如下：
----------Info----------
Status: 200, Start: 02:39:20, End: 02:39:25, Elapsed Time: 5.016539812088013
Status: 200, Start: 02:39:20, End: 02:39:25, Elapsed Time: 5.012614488601685
Status: 200, Start: 02:39:20, End: 02:39:25, Elapsed Time: 5.015984535217285
Status: 200, Start: 02:39:20, End: 02:39:25, Elapsed Time: 5.015599012374878
Status: 200, Start: 02:39:20, End: 02:39:25, Elapsed Time: 5.012874364852905
Status: 200, Start: 02:39:20, End: 02:39:25, Elapsed Time: 5.018714904785156
Status: 200, Start: 02:39:20, End: 02:39:25, Elapsed Time: 5.010422468185425
Status: 200, Start: 02:39:20, End: 02:39:25, Elapsed Time: 5.012431621551514
Status: 200, Start: 02:39:20, End: 02:39:25, Elapsed Time: 5.011001348495483
Status: 200, Start: 02:39:20, End: 02:39:25, Elapsed Time: 5.01432466506958配置连接池
通过服务网格技术启用熔断规则，只需要针对目标服务定义对应的目标规则DestinationRule即可。
使用以下内容，创建目标规则。具体操作，请参见管理目标规则。该目标规则定义与目标服务的最大TCP连接数为5。
apiVersion: networking.istio.io/v1beta1
kind: DestinationRule
metadata:
name: circuit-breaker-sample-server
spec:
host: circuit-breaker-sample-server
trafficPolicy:
connectionPool:
tcp:
maxConnections: 5场景一：一个客户端Pod和一个目标服务Pod
启动客户端Pod并监控日志。
建议重启下客户端以获得更直观的统计结果。可以看到类似如下日志：
----------Info---------- Status: 200, Start: 02:49:40, End: 02:49:45, Elapsed Time: 5.0167787075042725 Status: 200, Start: 02:49:40, End: 02:49:45, Elapsed Time: 5.011920690536499 Status: 200, Start: 02:49:40, End: 02:49:45, Elapsed Time: 5.017078161239624 Status: 200, Start: 02:49:40, End: 02:49:45, Elapsed Time: 5.018405437469482 Status: 200, Start: 02:49:40, End: 02:49:45, Elapsed Time: 5.018689393997192 Status: 200, Start: 02:49:40, End: 02:49:50, Elapsed Time: 10.018936395645142 Status: 200, Start: 02:49:40, End: 02:49:50, Elapsed Time: 10.016417503356934 Status: 200, Start: 02:49:40, End: 02:49:50, Elapsed Time: 10.019930601119995 Status: 200, Start: 02:49:40, End: 02:49:50, Elapsed Time: 10.022735834121704 Status: 200, Start: 02:49:40, End: 02:49:55, Elapsed Time: 15.02303147315979可以看到所有请求都成功。但是，每批中只有5个请求的响应时间约为5秒，其余请求的响应较慢（大部分为10秒以上）。该结果表明仅使用
tcp.maxConnections会导致过多的请求排队，等待连接释放。默认情况下，可以排队的请求数为2³²-1。使用以下内容，更新目标规则，仅允许1个待处理请求。具体操作，请参见管理目标规则。
为了实现真正的熔断行为（即快速失败），您还需要设置
http.http1MaxPendingRequests限制排队的请求数量。该参数的默认值为1024。如果将该参数设置为0，将回滚到默认值。因此，必须至少将其设置为1。apiVersion: networking.istio.io/v1alpha3 kind: DestinationRule metadata: name: circuit-breaker-sample-server spec: host: circuit-breaker-sample-server trafficPolicy: connectionPool: tcp: maxConnections: 5 http: http1MaxPendingRequests: 1重启客户端Pod，避免统计结果出现偏差，并继续观察日志。
日志示例如下：
----------Info---------- Status: 503, Start: 02:56:40, End: 02:56:40, Elapsed Time: 0.005339622497558594 Status: 503, Start: 02:56:40, End: 02:56:40, Elapsed Time: 0.007254838943481445 Status: 503, Start: 02:56:40, End: 02:56:40, Elapsed Time: 0.0044133663177490234 Status: 503, Start: 02:56:40, End: 02:56:40, Elapsed Time: 0.008964776992797852 Status: 200, Start: 02:56:40, End: 02:56:45, Elapsed Time: 5.018309116363525 Status: 200, Start: 02:56:40, End: 02:56:45, Elapsed Time: 5.017424821853638 Status: 200, Start: 02:56:40, End: 02:56:45, Elapsed Time: 5.019804954528809 Status: 200, Start: 02:56:40, End: 02:56:45, Elapsed Time: 5.01643180847168 Status: 200, Start: 02:56:40, End: 02:56:45, Elapsed Time: 5.025975227355957 Status: 200, Start: 02:56:40, End: 02:56:50, Elapsed Time: 10.01716136932373可以看到4个请求立即被限制，5个请求发送到目标服务，1个请求排队，符合预期。
执行以下命令，查看客户端Istio代理与目标服务中的Pod建立的活跃连接数。
kubectl exec $(kubectl get pod --selector app=circuit-breaker-sample-client --output jsonpath='{.items[0].metadata.name}') -c istio-proxy -- curl -X POST http://localhost:15000/clusters | grep circuit-breaker-sample-server | grep cx_active预期输出：
outbound|9080||circuit-breaker-sample-server.default.svc.cluster.local::172.20.192.124:9080::cx_active::5可以看到客户端Istio代理与目标服务中的Pod建立的活跃连接数为5。
场景二：一个客户端Pod和多个目标服务Pod
本小节将验证连接数限制是否应用于Pod级别或服务级别。假设有一个客户端Pod和三个目标服务Pod。
若连接数限制应用于Pod级别，目标服务的每个Pod最多5个连接。
该场景应该看不到限制或排队，因为允许的最大连接数为15（3个Pod，每个Pod为5个连接）。由于一次只发送10个请求，所有请求都应该成功并在大约5秒内返回。
若连接数限制应用于服务级别，无论目标服务中的Pod数量为多少，总共最多5个连接。
该场景可以看到4个请求立即被限制，5个请求发送到目标服务，1个请求排队。
执行以下命令，将目标服务部署扩展到多个副本（例如3个）。
kubectl scale deployment/circuit-breaker-sample-server --replicas=3重启客户端Pod并监控日志。
日志示例如下：
----------Info---------- Status: 503, Start: 03:06:20, End: 03:06:20, Elapsed Time: 0.011791706085205078 Status: 503, Start: 03:06:20, End: 03:06:20, Elapsed Time: 0.0032286643981933594 Status: 503, Start: 03:06:20, End: 03:06:20, Elapsed Time: 0.012153387069702148 Status: 503, Start: 03:06:20, End: 03:06:20, Elapsed Time: 0.011871814727783203 Status: 200, Start: 03:06:20, End: 03:06:25, Elapsed Time: 5.012892484664917 Status: 200, Start: 03:06:20, End: 03:06:25, Elapsed Time: 5.013102769851685 Status: 200, Start: 03:06:20, End: 03:06:25, Elapsed Time: 5.016939163208008 Status: 200, Start: 03:06:20, End: 03:06:25, Elapsed Time: 5.014261484146118 Status: 200, Start: 03:06:20, End: 03:06:25, Elapsed Time: 5.01246190071106 Status: 200, Start: 03:06:20, End: 03:06:30, Elapsed Time: 10.021712064743042可以看到如上类似的限制和排队，表明增加目标服务的实例数量不会增加客户端的连接数限制。因此，连接数限制应用于服务级别。
运行一段时间之后，执行以下命令，查看客户端Istio代理与目标服务中的Pod建立的活跃连接数。
kubectl exec $(kubectl get pod --selector app=circuit-breaker-sample-client --output jsonpath='{.items[0].metadata.name}') -c istio-proxy -- curl -X POST http://localhost:15000/clusters | grep circuit-breaker-sample-server | grep cx_active预期输出：
outbound|9080||circuit-breaker-sample-server.default.svc.cluster.local::172.20.192.124:9080::cx_active::2 outbound|9080||circuit-breaker-sample-server.default.svc.cluster.local::172.20.192.158:9080::cx_active::2 outbound|9080||circuit-breaker-sample-server.default.svc.cluster.local::172.20.192.26:9080::cx_active::2可以看到客户端代理与目标服务中的每个Pod有2个活动连接，总共6个连接，而不是5个。如Envoy和Istio文档中所述，代理在连接数量方面具有一定的弹性。
场景三：多个客户端Pod和一个目标服务Pod
执行以下命令，调整目标服务和客户端的副本数。
kubectl scale deployment/circuit-breaker-sample-server --replicas=1 kubectl scale deployment/circuit-breaker-sample-client --replicas=3重启客户端Pod并监控日志。
每个客户端上的503错误数量增加。系统限制了来自所有三个客户端实例Pod的并发请求为5个。
查看客户端代理日志。
可以看到有两种不同类型的日志，用于解释被限制的请求（503错误）。在日志中，
RESPONSE_FLAGS字段包括了UO和URX这两个值。UO：表示上游溢出（断路）。URX：表示请求被拒绝，因为已达到上游重试限制（HTTP）或最大连接尝试次数（TCP）。
根据日志中的其他字段的值（例如
DURATION、UPSTREAM_HOST和UPSTREAM_CLUSTER），进一步得出结论：带有
UO标志的请求由客户端代理在本地进行限制，而带有URX标志的请求被目标服务代理拒绝。验证上一步结论的正确性，检查目标服务端的代理日志。
与预期一致，目标服务代理的日志出现了503响应码。这也是导致客户端代理日志中出现
"response_code":"503"和"response_flags":"URX"的原因。
总而言之，客户端代理根据它们的连接数限制（每个Pod最多5个连接）发送请求，并对多余的请求进行排队或限制（使用UO响应标志）。在批处理开始时，所有三个客户端代理最多可以发送15个并发请求。但是，只有5个请求成功，因为目标服务代理也在使用相同的配置（最多5个连接）进行限制。目标服务代理将仅接受5个请求并限制其余请求，这些请求在客户端代理日志中带有URX响应标志。
上述场景对应的示意图如下：
场景四：多个客户端Pod和多个目标服务Pod
当增加目标服务副本时，应该会看到请求的成功率整体增加，因为每个目标代理可以允许5个并发请求。通过此方式，可以观察到客户端和目标服务代理上的限制。
执行以下命令，将目标服务的副本数增加到2，将客户端的副本数增加到3。
kubectl scale deployment/circuit-breaker-sample-server --replicas=2 kubectl scale deployment/circuit-breaker-sample-client --replicas=3可以看到所有三个客户端代理在一个批次中生成的30个请求中有10个请求成功。
执行以下命令，将目标服务的副本数增加到3。
kubectl scale deployment/circuit-breaker-sample-server --replicas=3可以看到15个成功的请求。
执行以下命令，将目标服务的副本数增加到4。
kubectl scale deployment/circuit-breaker-sample-server --replicas=3可以看到目标服务的副本数从3增加到4，仍然只有15个成功的请求。无论目标服务有多少个副本，客户端代理上的限制都适用于整个目标服务。因此，无论有多少个副本，每个客户端代理最多可以向目标服务发出5个并发请求。
相关操作
查看连接池熔断相关指标
连接池熔断通过限制到目标主机的最大TCP连接数来达到熔断的目的。连接池熔断可以产生一系列相关指标，以帮助判断熔断是否发生，部分指标的说明如下：
指标 | 指标类型 | 描述 |
envoy_cluster_circuit_breakers_default_cx_open | Gauge | 表示当前是否触发了连接池熔断。若触发则为1，没有触发则为0. |
envoy_cluster_circuit_breakers_default_rq_pending_open | Gauge | 排队等待就绪的连接池连接的请求数量是否已经超过给定值。若超过则为1，没有超过则为0。 |
您可以通过配置Sidecar代理的proxyStatsMatcher使Sidecar代理上报相关指标，然后使用Prometheus采集并查看熔断相关指标。
通过proxyStatsMatcher配置Sidecar代理上报熔断指标。在配置proxyStatsMatcher时，选中正则匹配，配置为
.*circuit_breaker.*。具体操作，请参见proxyStatsMatcher。重新部署circuit-breaker-sample-server和 circuit-breaker-sample-client无状态工作负载。具体操作，请参见重新部署工作负载。
参照上文步骤，完成连接池熔断配置及请求访问。
执行以下命令，查看circuit-breaker-sample-client服务的连接池熔断相关指标。
kubectl exec -it deploy/circuit-breaker-sample-client -c istio-proxy -- curl localhost:15090/stats/prometheus | grep circuit_breaker | grep circuit-breaker-sample-server预期输出：
kubectl exec -it deploy/circuit-breaker-sample-client -c istio-proxy -- curl localhost:15090/stats/prometheus | grep circuit_breaker | grep circuit-breaker-sample-server envoy_cluster_circuit_breakers_default_cx_open{cluster_name="outbound|9080||circuit-breaker-sample-server.default.svc.cluster.local"} 1 envoy_cluster_circuit_breakers_default_cx_pool_open{cluster_name="outbound|9080||circuit-breaker-sample-server.default.svc.cluster.local"} 0 envoy_cluster_circuit_breakers_default_remaining_cx{cluster_name="outbound|9080||circuit-breaker-sample-server.default.svc.cluster.local"} 0 envoy_cluster_circuit_breakers_default_remaining_cx_pools{cluster_name="outbound|9080||circuit-breaker-sample-server.default.svc.cluster.local"} 18446744073709551613 envoy_cluster_circuit_breakers_default_remaining_pending{cluster_name="outbound|9080||circuit-breaker-sample-server.default.svc.cluster.local"} 1 envoy_cluster_circuit_breakers_default_remaining_retries{cluster_name="outbound|9080||circuit-breaker-sample-server.default.svc.cluster.local"} 4294967295 envoy_cluster_circuit_breakers_default_remaining_rq{cluster_name="outbound|9080||circuit-breaker-sample-server.default.svc.cluster.local"} 4294967295 envoy_cluster_circuit_breakers_default_rq_open{cluster_name="outbound|9080||circuit-breaker-sample-server.default.svc.cluster.local"} 0 envoy_cluster_circuit_breakers_default_rq_pending_open{cluster_name="outbound|9080||circuit-breaker-sample-server.default.svc.cluster.local"} 0 envoy_cluster_circuit_breakers_default_rq_retry_open{cluster_name="outbound|9080||circuit-breaker-sample-server.default.svc.cluster.local"} 0 envoy_cluster_circuit_breakers_high_cx_open{cluster_name="outbound|9080||circuit-breaker-sample-server.default.svc.cluster.local"} 0 envoy_cluster_circuit_breakers_high_cx_pool_open{cluster_name="outbound|9080||circuit-breaker-sample-server.default.svc.cluster.local"} 0 envoy_cluster_circuit_breakers_high_rq_open{cluster_name="outbound|9080||circuit-breaker-sample-server.default.svc.cluster.local"} 0 envoy_cluster_circuit_breakers_high_rq_pending_open{cluster_name="outbound|9080||circuit-breaker-sample-server.default.svc.cluster.local"} 0 envoy_cluster_circuit_breakers_high_rq_retry_open{cluster_name="outbound|9080||circuit-breaker-sample-server.default.svc.cluster.local"} 0
配置连接池熔断指标采集及告警
配置完成连接池熔断相关指标后，您可以配置采集相关指标到Prometheus，并基于关键指标配置告警规则，实现熔断发生时的及时告警。以下以可观测监控Prometheus版为例说明如何配置连接池熔断指标采集和告警。
在可观测监控Prometheus版中，为数据面集群接入阿里云ASM组件或升级至最新版，以保证可观测监控Prometheus版可以采集到暴露的熔断指标。有关更新接入组件的具体操作，参考接入组件管理。（如果参考集成自建Prometheus实现网格监控配置了通过自建Prometheus采集服务网格指标，则无需操作。）
创建针对连接池熔断的告警规则。具体操作，请参见通过自定义PromQL创建Prometheus告警规则。配置告警规则的关键参数的填写示例如下，其余参数可参考上述文档根据自身需求填写。
参数 | 示例 | 说明 |
自定义PromQL语句 | (sum by(cluster_name, pod_name,namespace) (envoy_cluster_circuit_breakers_default_cx_open)) != 0 | 示例通过查询envoy_cluster_circuit_breakers_default_cx_open指标来判断当前集群中是否正在发生连接池熔断，基于上游服务主机名称，上报指标的pod名称来确定发生连接池熔断的位置。 |
告警内容 | 发生连接池熔断，代理建立的TCP连接已达到最大限制！命名空间：{{$labels.namespace}}，触发连接池熔断的pod：{{$labels.pod_name}}，连接的上游服务信息：{{ $labels.cluster_name }} | 示例的告警信息展示了触发连接池熔断的pod，pod连接的上游服务以及pod所在命名空间。 |
连接池约束
连接池配置对客户端和目标服务端的约束如下。
角色 | 说明 |
客户端 | 每个客户端代理独立应用该限制。如果限制为100，则每个客户端代理在应用本地限制之前可以有100个未完成的请求。如果有N个客户端调用目标服务，则总共最多可以有100*N个未完成的请求。 客户端代理的限制是针对整个目标服务，而不是针对目标服务的单个副本。即使目标服务有200个活动Pod，限流仍然会是100。 |
目标服务端 | 每个目标服务代理应用该限制。如果该服务有50个活动的Pod，则在应用限流并返回503错误之前，每个Pod最多可以有100个来自客户端代理的未完成请求。 |