流量管控 on Apache Dubbo

标签路由

Mon, 01 Jan 0001 00:00:00 +0000

使用方法

前置准备

Docker 以及 Docker compose 环境来部署Nacos配置中心。
Nacos 2.x+
Go 1.23+

启动Nacos配置中心

参考这个教程来启动Nacos。

Tag router 介绍

Tag router可以通过标签对流量进行管控，常用于灰度发布（新版本实例打上灰度标签，只有携带该标签的请求会路由过去）、环境隔离（不同泳道的实例用标签区分，避免流量串环境）等场景。以下为示例代码。

服务端部分：

ins, err := dubbo.NewInstance(
		dubbo.WithName("tag-server"),
		dubbo.WithTag("test-tag"), // set application's tag
		dubbo.WithRegistry(
			registry.WithNacos(),
			registry.WithAddress(RegistryAddress),
		),
		dubbo.WithProtocol(
			protocol.WithTriple(),
			protocol.WithPort(20001),
		),
	)

参数：

dubbo.WithTag: 设置该实例携带的tag，用于标记该实例（例如为灰度环境等）。标签会写入注册中心的实例元数据（dubbo.tag）。标签匹配区分大小写，需与客户端携带的标签写法完全一致。

客户端部分：

atta := map[string]string{
	constant.Tagkey: "test-tag",
	constant.ForceUseTag: "true", // 使用string类型
}
ctx := context.WithValue(context.Background(), constant.AttachmentKey, atta)
resp, err := svc.Greet(ctx, &greet.GreetRequest{Name: name})

参数:

脚本路由

Mon, 01 Jan 0001 00:00:00 +0000

示例源码：dubbo-go-samples/router/script。

Script Router 在消费端通过 JavaScript 脚本筛选候选 Provider，目前支持应用级动态规则。它适合根据 Provider URL、RPC 方法、调用附件等运行时信息实现自定义路由，例如将流量固定到指定端口、按租户或灰度标识选择实例。

对于只需按地址、方法或应用名进行简单匹配的场景，优先使用 Condition Router。Script Router 的表达能力更强，但脚本执行和维护成本更高，生产环境应限制脚本复杂度，并验证脚本始终返回可调用的 Provider 列表。

前置准备

Docker 和 Docker Compose，用于运行 Nacos。
Nacos 2.x+。
Go 1.23+。
已下载 dubbo-go-samples/router/script 示例。

启动 Nacos

按照 Nacos 快速开始启动 Nacos。示例中的注册中心和配置中心地址均为 127.0.0.1:8848。

脚本入参

路由脚本以 invokers、invocation、context 三个参数执行，必须返回由原始候选项组成的数组。

入参	含义	常见用法
`invokers`	当前可用的候选 Provider 列表。每项可通过 `GetURL()` 获取服务 URL。	根据 URL 的端口、地址或参数过滤实例。
`invocation`	当前 RPC 调用信息。	根据方法名、参数或 attachments 实现按调用维度的路由。
`context`	当前调用上下文。	在脚本需要时读取调用链路中的上下文信息。

下面的脚本只保留端口为 20000 的 Provider：

(function(invokers, invocation, context) {
 if (!invokers || invokers.length === 0) return [];
 return invokers.filter(function(invoker) {
 var url = invoker.GetURL();
 return url && url.Port === "20000";
 });
})(invokers, invocation, context);

配置 Script Router

示例 consumer 通过 dubbo.WithConfigCenter 连接 Nacos 配置中心。启动 Provider 后，Script Router 会按照 Provider 的应用名订阅规则。

条件路由

Mon, 01 Jan 0001 00:00:00 +0000

使用方法

前置准备

Docker 以及 Docker compose 环境来部署Nacos配置中心。
Nacos 2.x+
Go 1.23+

启动Nacos配置中心

参考这个教程来启动Nacos。

Condition router 介绍

Condition router 与 Tag router 类似，但是提供了更强大的流量管控功能，可以通过表达式consumer => provider，对服务端以及客户端进行流量管控。

匹配表达式示例:

host = 127.0.0.1 => host = 127.0.0.1, 192.168.1.1

可以使用 = 以及 != 等符号进行匹配，使用逗号进行多选择匹配。

示例代码:

服务端部分:

ins, err := dubbo.NewInstance(
		dubbo.WithName("condition-server"),
		dubbo.WithRegistry(
			registry.WithNacos(),
			registry.WithAddress(RegistryAddress),
		),
		dubbo.WithProtocol(
			protocol.WithTriple(),
			protocol.WithPort(TriPort),
		),
	)

客户端部分:

Sentinel限流降级

Mon, 01 Jan 0001 00:00:00 +0000

Dubbo-go 中提供了内置的限流组件，用户可根据自己的业务场景调整限流值、限流后的行为等，具体可 TpsLimiter 定义与具体实现。用户可通过类似以下方式在服务端设置简单的限流策略：

server.WithTpsLimiter("method-service") // 目前支持 method-service、polaris 等几个实现
server.WithTpsLimiterXxx() // 设置限流相关阈值，请根据具体方法填写
//tps.limit.strategy: "slidingWindow"
//tps.limit.rejected.handler: "default"
//tps.limit.interval: 1000
//tps.limit.rate: 3

Dubbo-go 内置限流策略相对简单，对于一些更复杂的场景，我们建议通过使用 Sentinel 等专业的第三方框架可以实现更丰富、更灵活的限流策略。

可在此查看本示例完整源码，也可以参考 Dubbo+Sentinel 的 Java 示例获得更多灵感。

流量管控 on Apache Dubbo

标签路由

使用方法

前置准备

启动Nacos配置中心

Tag router 介绍

脚本路由

前置准备

启动 Nacos

脚本入参

配置 Script Router

条件路由

使用方法

前置准备

启动Nacos配置中心

Condition router 介绍

Sentinel限流降级

Provider 限流

基于 QpS 限流

基于并发任务数限流(当前在运行任务数)

Consumer 限流

熔断策略

基于并发请求数限流(未收到响应的请求数)