本文将详细介绍clientcontrol插件功能、配置和使用。 功能说明 clientcontrol 插件通过设置客户端请求体大小上限来动态控制客户端的请求。当设置较大的限制时可能导致内存使用增加，需根据实际需求合理配置。 配置字段 名称 类型 填写要求 默认值 有效值 描述 maxbodysize integer 可选 [0,...] 动态设置 clientmaxbodysize 的大小 配置示例 clientcontrol 使用示例 plaintext maxbodysize: 1 根据该场景请求路由 plaintext curl d '123' 由于请求路由的请求体大小超过了所设置的客户端请求体大小上限，请求返回413. plaintext HTTP/1.1 413 Request Entity Too Large ...... 413 Request Entity Too Large 413 Request Entity Too Large openresty Powered by CGW. 配置模板 plaintext [可选]设置客户端请求体大小上限.有效范围[0,...] maxbodysize: 1024

本文将详细介绍limitcount插件功能、配置和使用。 功能说明 limitcount 插件使用固定时间窗口算法，主要用于限制单个客户端在指定的时间范围内对服务的总请求数，并且会在 HTTP 响应头中返回剩余可以请求的个数. 配置字段 名称 类型 填写要求 默认值 有效值 描述 count integer 必填 count> 0 每个客户端在指定时间窗口内的总请求数量阈值。 timewindow integer 必填 timewindow> 0 时间窗口的大小（以秒为单位）。超过该属性定义的时间，则会重新开始计数。 rejectedcode integer 可选 503 [200,...,599] 当请求超过阈值被拒绝时，返回的 HTTP 状态码。 keytype string 可选 "var" ["var", "varcombination", "constant"] key 的类型。 key string 可选 "remoteaddr" 用来做请求计数的依据。如果 keytype 为 constant，那么 key 会被当作常量；如果 keytype 为 var，那么 key 会被当作变量；如果 keytype 为 varcombination，那么 key 会被当作变量组合，如 $remoteaddr $consumername，插件会同时受 $remoteaddr 和 $consumername 两个变量的约束；如果 key 的值为空，$remoteaddr 会被作为默认 key。 rejectedmsg string 可选 非空 当请求超过阈值被拒绝时，返回的响应体。 allowdegradation boolean 可选 false 当插件功能临时不可用时（例如 Redis 超时），当设置为 true 时，则表示可以允许插件降级并进行继续请求的操作。 showlimitquotaheader boolean 可选 true 当设置为 true 时，在响应头中显示 XRateLimitLimit（限制的总请求数）和 XRateLimitRemaining（剩余还可以发送的请求数）字段。

[可选]请求超过阈值被拒绝时，返回的 HTTP 状态码 rejectedcode: 429 [可选]当设置rejectedmsg时，非空。默认可不填 rejectedmsg: "Requests are too frequent, please try again later." [可选] 在异常错误时，是否中断用户请求，false 不中断，true 中断，默认不中断 errorinterrupt: false [可选] APP（消费者）限速规则，约定对指定APP(消费者)的限速规则 rulemap: 消费者名称 app1: [可选] 当前消费者的限流计数，不传时取最外层默认的count值 count: 3 [] 当前消费者的限流时间窗口大小（以秒为单位），不传时取最外层的默认timewindow值 timewindow: 10 消费者名称 app2: [可选] 当前消费者的限流计数，不传时取最外层默认的count值 count: 3 [可选] 当前消费者的限流时间窗口大小（以秒为单位），不传时取最外层的默认timewindow值 timewindow: 10

名称 类型 填写要求 默认值 有效值 描述 count integer 必填 count> 0 每个客户端在指定时间窗口内的总请求数量阈值。 timewindow integer 必填 timewindow> 0 时间窗口的大小（以秒为单位）。超过该属性定义的时间，则会重新开始计数。 rejectedcode integer 可选 429 [200,599] 当请求超过阈值被拒绝时，返回的 HTTP 状态码。 keytype string 可选 "var" ["var", "varcombination", "constant"] key 的类型。 key string 可选 "remoteaddr" 用来做请求计数的依据。如果 keytype 为 var，则 key 将被解释为变量。变量不需要以美元符号（$）为前缀。如果 keytype 为 varcombination，那么 key 会被当作变量组合，所有变量都应该以美元符号 ($) 为前缀。如 $remoteaddr $consumername，插件会同时受 $remoteaddr 和 $consumername 两个变量的约束；如果 keytype 为 constant，那么 key 会被当作常量。如果 key 的值为空，$remoteaddr 会被作为默认 key。 rejectedmsg string 可选 非空 当请求超过阈值被拒绝时，返回的响应体。 showlimitquotaheader boolean 可选 true 当设置为 true 时，在响应头中显示 XRateLimitLimit（限制的总请求数）和 XRateLimitRemaining（剩余还可以发送的请求数）字段。 group string 可选 非空 对多个API设置相同 group，则路由可以共享相同的速率限制计数器。注意同一个group下的插件配置值需相同。 policy string 可选 "local" ["local","redis"] 速率限制计数器的策略。如果是 local，则计数器存储在本地内存中，按照单个实例节点计数。如果是 redis，则计数器存储在 Redis 实例上，按照实例集群计数。 redishost string 当 policy 为 redis 时必填 Redis 节点的地址。 redisport integer 当 policy 为 redis 时必填 6379 [1,65535] Redis 节点的端口。 redisusername string 可选 如果使用 Redis ACL，则为 Redis 的用户名。如果使用旧式身份验证方法 requirepass，则仅配置 redispassword。 redispassword string 可选 Redis 节点的密码。

有条件地缓存响应 以下示例演示了如何配置 proxycache 插件以有条件地缓存响应。 使用 proxycache 插件创建路由并配置 nocache 属性，这样如果 URL 参数 nocache 和标头 nocache 的值中至少有一个不为空且不等于 0，则不会缓存响应： plaintext nocache: ["$argnocache", "$httpnocache"] 向路由发送一些请求，其中 URL 参数的 nocache 值表示绕过缓存： plaintext curl i " 您应该收到所有请求的 HTTP/1.1 200 OK 响应，并且每次都观察到以下标头： plaintext AgwCacheStatus: EXPIRED 向路由发送一些其他请求，其中 URL 参数 nocache 值为零： plaintext curl i " 您应该收到所有请求的 HTTP/1.1 200 OK 响应，并开始看到缓存被命中： plaintext AgwCacheStatus: HIT 您还可以在 nocache 标头中指定以下值： plaintext curl i " H "nocache: 1" 响应不应该被缓存： plaintext AgwCacheStatus: EXPIRED 有条件地从缓存中检索响应 以下示例演示了如何配置 proxycache 插件以有条件地从缓存中检索响应。 使用 proxycache 插件创建路由并配置 cachebypass 属性，这样如果 URL 参数 bypass 和标头 bypass 的值中至少有一个不为空且不等于 0，则不会从缓存中检索响应： plaintext cachebypass: ["$argbypass", "$httpbypass"] 向路由发送一个请求，其中 URL 参数值为 bypass，表示绕过缓存： plaintext curl i " 您应该看到带有以下标头的 HTTP/1.1 200 OK 响应： plaintext AgwCacheStatus: BYPASS 向路由发送另一个请求，其中 URL 参数 bypass 值为零： plaintext curl i " 您应该看到带有以下标头的 HTTP/1.1 200 OK 响应： plaintext AgwCacheStatus: MISS 您还可以在 bypass 标头中指定以下值： plaintext curl i " H "bypass: 1" 响应应该显示绕过缓存： plaintext AgwCacheStatus: BYPASS

本章节介绍服务网格全链路灰度控制的原理 在微服务架构中，对单个服务的灰度控制可以在请求进入该服务前的代理进行，比如ingress gateway或者客户端sidecar（如基于请求头部选择不同的版本的后端服务），全链路灰度中对链路中的每个服务的灰度也是基于此原理（定义DestinationRule、VirtualService实现），不同于单服务的灰度控制，全链路灰度需要调用链上的所有服务都有统一的VS、DR配置，并且需要在整个调用链上传递版本控制信息，每个服务基于统一的版本控制信息和VS、DR配置实现统一的灰度控制，这里就依赖业务必须接入链路追踪能力。服务网格全链路灰度利用链路追踪的trace id在sidecar里实现了inbound请求中的灰度控制信息透传到outbound请求，解决了灰度控制信息在调用链中透传的问题，如图所示： 步骤说明如下： 1. 用户请求时带上特定版本控制头部xversion，业务接入了分布式链路追踪系统，请求会带上traceid。 2. 经过ingress网关将请求转发到后端服务的sidecar。 3. sidecar内通过自研wasm插件在内存中缓存版本控制信息（key为traceid值，value为版本控制信息）。 4. sidecar将请求转发到业务，此时请求头部包含traceid和xversion。 5. 由于业务接入了全链路追踪，默认会透传traceid，因此app1向外部请求时也会带上traceid。 6. sidecar outbound方向从缓存中获取版本控制信息，并添加到头部中转发到app2。 7. 链路内后续的调用情况类似。 通过以上过程就是服务网格全链路灰度控制的原理。

字段 类型 说明 namematch string 对应VirtualService里面的某条规则 headermatch []HeaderMatcher 匹配服务请求的Header

本文介绍带宽标准资费。 带宽标准资费 带宽阶梯 标准资费 (0Mbps,100Mbps] 0.67元/Mbps (100Mbps,500Mbps] 0.6元/Mbps (500Mbps,5Gbps] 0.53元/Mbps (5Gbps,+∞) 0.49元/Mbps 固定单价 0.67元/Mbps 计费项：国内 计费方式：按日带宽峰值计费（阶梯计费模式） 计费周期：按日结算，定时扣费（每日12:00后出前一日账单并扣费，具体出账时间以系统为准） 示例 假设5月1日峰值带宽为10Mbps，5月2日峰值带宽为10Gbps。 带宽计费示例 日期 峰值带宽 计价区间 标准资费 (元/Mbps) 金额 5月1日 10Mbps [0Mbps, 500Mbps) 0.67 6.7元 5月2日 10Gbps (5G,+∞) 0.49 4900元 5.1日带宽峰值为10Mbps，位于区间[0Mbps, 500Mbps)，执行0.53元/Mbps价位的计费标准，合计费用5.3元，则日账单为5.3元。 5.2日带宽峰值为10Gbps，位于区间(5G,+∞)，执行0.49元/Mbps价位的计算标准，合计费用4900元，则日账单为4900元。

名称 类型 填写要求 默认值 有效值 描述 headerschema object 可选,至少配置 headerschema 和 bodyschema 中任意一个，两者也可以同时使用。 header 数据的 schema 数据结构。 bodyschema object 可选,至少配置 headerschema 和 bodyschema 中任意一个，两者也可以同时使用。 body 数据的 schema 数据结构。 rejectedcode integer 可选 400 [200,...,599] 当请求被拒绝时要返回的状态码。 rejectedmsg string 可选 当请求被拒绝时返回的信息。

本章节介绍如何在服务网格中使用本地限流 前提条件 1. 已开通云容器引擎，至少有一个云容器引擎集群实例。产品入口：云容器引擎。 2. 开通天翼云服务网格实例。 操作步骤 我们以bookinfo应用为例演示本地限流能力，首先在default命名空间部署bookinfo应用。 然后在default命名空间部署针对productpage服务的限流策略，token数量最大为5，每2秒重新填充5个token： apiVersion: istio.ctyun.cn/v1beta1 kind: LocalRateLimiter metadata: name: productpagelimit spec: workloadSelector: 匹配工作负载 labels: app: productpage context: SIDECARINBOUND statPrefix: httplocalratelimiter configs: name: productpage routeConfig: vhost: name: 'inboundhttp9080' rateLimitConfig: tokenBucket: maxTokens: 5 tokensPerFill: 5 fillInterval: 2s filterEnabled: runtimeKey: localratelimitenabled defaultValue: numerator: 100 denominator: HUNDRED filterEnforced: runtimeKey: localratelimitenforced defaultValue: numerator: 100 denominator: HUNDRED responseHeadersToAdd: appendAction: OVERWRITEIFEXISTSORADD header: key: xlocalratelimit value: 'true' 我们使用gostresstesting工具验证效果，如下图所示，结果状态码中有200和429（请求被限流）；200的个数每2秒增加5个，符合我们设定的2秒重新填充5个token的设定；429状态码在持续增加。 单独请求productpage服务可以看到请求被限流的情况：

本章节从整体上介绍应用服务网格CSM全链路灰度功能 微服务架构中往往存在多个服务，多数场景下，在做业务灰度时整个调用链中也会有不止一个服务，通过应用服务网格全链路灰度功能可以实现对整个调用链统一的灰度控制。 应用服务网格全链路灰度中的架构包括ingress gateway（入口网关）以及微服务（如下图中的app1、app2、app3）,通过全链路灰度可以实现对app1、app2、app3统一的灰度控制。 应用服务网格全链路灰度中的相关概念说明如下： ingress gateway：服务网格入口网关，实现网格内微服务对外暴露，并提供微服务入口应用的灰度控制能力。 泳道组：可以类比作游泳池，微服务是泳池中的游泳者。 泳道：可以类比做泳池中的泳道，泳道之间相互隔离；微服务可以根据版本的不同分散在不同的泳道游泳。