概述
云原生网关体验流程如下:
创建网关实例 > 绑定ELB > 添加服务来源 > 添加服务 > 配置路由规则 > 测试验证 > 查看监控
前置条件
- 已创建云原生网关实例;
- 已创建ELB实例;
- 已开通天翼云日志服务(LTS)和应用性能监控服务(APM),网关实例开启了指标监控、链路追踪和日志服务;
绑定ELB
实例开通成功后,需要绑定到ELB提供外部访问;当前支持私网ELB和公网ELB;可以到ELB开通页面在网关同VPC下创建ELB实例;
从网关列表页选择指定网关进入网关详情页,在基础信息页可以看到网关入口选项,选择绑定ELB,在下拉列表中选择已经开通的公网或者私网ELB实例及端口,绑定即可。
绑定完成后可以看到当前绑定的ELB列表及访问地址。
添加服务来源
通过网关列表页面选择网关实例进入对应实例的详情页,在服务来源子菜单下可以添加云原生网关的服务来源,当前支持将与网关同vpc下的nacos实例和云容器引擎集群作为服务来源
添加服务
在网关实例服务列表菜单下可以创建服务,当前支持从容器、Nacos服务来源创建服务,或者创建固定地址的服务;
选择从容器创建服务时需要指定:
(1)服务所在的命名空间;
(2)在服务列表栏可以看到选择的命名空间下的服务信息(K8s Service),每个服务可能有多个端口,在云原生网关中,每个端口都可以创建为一个服务;
(3)根据需求可以配置后端服务的请求协议(HTTP、HTTPS、GRPC、GRPCS)、websocket选项、MTLS选项等;
配置路由规则
在路由配置菜单左上角进入路由配置页面,路由匹配规则之间是“与”的关系,必须全部满足才算匹配;核心的路由配置项说明如下:
配置项 | 说明 |
---|---|
名称 | 路由名称,用于标识一条路由规则。 |
域名 | 用于和请求中的域名进行匹配,不填则任何请求都可以匹配。 |
路径 | 匹配请求的path(不含query参数),当前支持前缀匹配和精确匹配。 |
方法 | 匹配请求中的HTTP方法。 |
优先级 | 当多个路由同时匹配一个请求时,路径匹配深度较大的路由优先;路径匹配相同的情况下,路由优先级高(数字大)的优先匹配。 |
请求header | 匹配请求中的HTTP header。 |
请求query | 匹配请求中的HTTP query参数。 |
目标服务 | 当前支持单服务、多服务、标签路由、mock路由和重定向。 |
在路由的目标服务选项中选择刚才创建好的后端服务即可。
测试验证
通过绑定的ELB公网地址访问,结果符合预期。
查看监控
调用链
在观测分析菜单下链路追踪子菜单下可以根据接口路径查询到链路追踪信息(需要确保您的网关实例已开启链路追踪,并且采样率大于零才可以采集到链路追踪数据)。
指标监控
在监控分析子菜单可以看到业务监控信息,当前支持的指标如下:
指标 | 说明 |
---|---|
入流量 | 请求进入网关的带宽。 |
出流量 | 网关应答的带宽。 |
配置中心连接状态 | 网关和控制面连接状态,1为正常,0位异常。 |
请求成功率 | 网关返回HTTP 2XX的比例。 |
404比例 | 网关返回HTTP 404的比例。 |
5XX比例 | 网关返回HTTP 5XX的比例。 |
失败率 | 网关返回HTTP 4XX和5XX的比例。 |
平均延迟 | 网关收到请求到返回应答的平均时延(ms)。 |
P50延迟 | 网关处理请求50分位耗时。 |
P95延迟 | 网关处理请求95分位耗时。 |
P99延迟 | 网关处理请求99分位耗时。 |
QPS | 网关每秒处理请求数。 |
连接数 | 网关连接数统计。 |
访问日志
日志中心记录了网关的访问日志,当前网关访问日志记录的字段有:
字段 | 说明 |
---|---|
server | 请求访问到的网关实例信息。 |
request | 请求信息,主要包括请求method、uri、header等。 |
response | 应答信息,包括状态码、header等。 |
start_time | 请求开始时间戳。 |
client_ip | 请求客户端ip。 |
latency | 网关处理请求总时延。 |
upstream_latency | 上游应答耗时。 |
route_id | 请求匹配到的路由id。 |
apisix_latency | 网关自身处理耗时。 |
service_id | 后端服务id。 |
upstream | 上游服务地址 |