微服务网关SIA-GateWay使用指南

1、DeskTop

DeskTop展现当前注册的各个网关组，点击一个网关组将选中该网关组并跳转至首页。

每一个网关组包括以下四项：

• 角色值：网关应用名前缀，用于区分网关组
• 拥有实例：网关组实例个数
• 网关状态：网关组当前状态
• 网关描述：网关组描述信息，可修改

2、首页

首页展现网关当前的运行状况。

主要包含以下部分：

• 网关调用趋势：每小时各节点调用量，共30小时
• 网关健康情况：每小时各节点健康情况，共30小时
• 监控告警：运行过程当中发送的警告
• 网关集群状态：各节点CPU、JVM和链接数监控，其中CPU和JVM数据取自Actuator

3、路由管理

路由管理分以下四部分：

3.1 新建路由

新建路由填写以下选项：

• 路由ID：路由惟一标示，也是数据库表primary key
• 网关集群组名：填写当前网关组名，右上角可见
• 应用名称：选填，通常填应用名
• 匹配路径：后端服务的path
• 后端服务策略：存在以下三种选择：

后端服务策略	说明
后端服务ID	填写注册到注册中心的应用名，路由匹配时将根据注册中心的服务列表匹配对应实例
后端服务URL	路由匹配后直接转发到填写的URL
ListofServer	路由匹配后使用轮询策略选择一个实例转发

• 后端服务URL：后端服务策略选择后端服务URL和ListofServer时填写后端ip:port
• 前缀是否生效：选择是则真正的匹配路径=匹配路径+公共前缀

3.2 路由导入导出

路由导入导出可用于测试环境与生产环境路由数据同步

• 路由导出：默认导出当前网关组所有路由，可选择部分路由导出，点击路由导出将下载routerList.json文件
• 路由导入：点击路由导入选择导入的路由文件，导入后将提示导入成功和失败的路由ID，导入的路由为编辑状态

3.3 路由操做

路由操做分为如下两部分：

• 修改路由状态：路由状态分为编辑、发布、下线三种状态，对应有发布、下线、修改、删除和查看操做
• 路由组件管理：API网关提供了功能丰富的组件，在组件管理中绑定了路由后，可在该路由下查看或配置组件，各组件功能和用法参考组件管理

3.4 路由拓扑

点击路由拓扑图展现路由的实时拓扑图，拓扑图分为三段：应用->网关->后端服务，若是该路由没有请求则路由拓扑图为空。

4、组件管理

网关提供了功能丰富的公共组件，同时支持用户上传第三方组件。使用组件时首先须要在组件管理中绑定路由，而后在路由管理中查看或配置组件。

4.1 公共组件

公共组件描述说明了组件的功能和用法，分为以下几种：

• 日志：分为请求日志组件和影响日志组件
• 灰度：分为蓝绿部署组件和金丝雀组件
• 监控：统计组件，统计路由访问状况
• 限流：限流组件，限制路由单位时间请求数
• 安全：安全认证组件和黑白名单组件

4.2 第三方组件

第三方组件由用户自定义实现，上传后便可使用。点击第三方组件查看已经上传的第三方组件，点击组件上传可上传自定义的第三方组件。

5、网关监控

网关监控分为两部分：运行状态监控和拓扑图

5.1 运行状态监控

运行状态监控包含以下监控项：

• 监控：集成Hystrix dashboard
• 日志：展现当前日志文件内容，数据来自Actuator
• JVM：监控负载、类加载、线程等，数据来自Actuator
• 内存：监控JVM内存，数据来自Actuator
• 垃圾回收：监控parnew和CMS回收器，数据来自Actuator
• 配置：包括内部和外部的配置文件，数据来自Actuator

5.2 拓扑图

拓扑图展现了该网关的服务流图，是所有路由拓扑图的集合。

6、日志管理

日志管理集成了Kibana，用户点击日志管理时将跳转至Kibana展现网关组ES索引的日志数据。若是路由绑定了日志请求组件或日志响应组件， 可在路由管理-操做->请求日志组件或响应日志组件跳转。

7、熔断管理

熔断管理展现了网关运行过程当中被Hystrix熔断的请求信息，包括熔断类型、错误信息和堆栈信息等。

8、注册中心管理

注册中心管理主要包括两部分：注册信息查询和动态修改注册中心地址

8.1 注册信息查询

注册信息来自于当前网关组所在的Eureka，点击查询符合条件的应用。

8.2 动态修改注册中心地址

Eureka服务端地址默认使用本地配置，用户可经过设置Eureka修改Eureka地址，设置成功后新设置的Eureka地址将保存在数据库中， 同时通知该网关组节点修改内存中注册中心地址并从新注册。点击重置Eureka将清除数据库中的Eureka地址并通知该网关组节点使用本地配置。 设置/重置后将弹窗提示结果。

注册中心地址设置/重置成功条件：

• 该网关组下无状态为发布的路由
• 管理端能够请求通新注册中心地址

9、路由联通性测试

支持GET和POST两种方式测试路由是否联通。

10、网关Swagger

网关Swagger整合了注册中心注册的服务的所有网关接口文档，可经过右上角选择不一样服务查看接口文档。

11、系统黑名单

系统黑名单可设置全局黑名单，目前支持IP拦截策略，设置后全部来自该IP的请求都将被拦截。

12、网关审计

网关审计展现了全部在网关管理端操做的用户、行为和性能，方便监控和分析用户行为。

十3、网关设置

网关设置分为三部分：预警邮箱、日志级别操做、查看版本号

13.1 预警邮箱

发生预警时将发送预警邮件至设置的邮箱

13.2 日志级别操做

网关日志级别默认为INFO，用户调试时可查看或动态调整日志级别。日志名可选com.creditease和root，日志级别可选INFO和DEBUG。

在Logback等日志框架中，logger层级相似于java继承，以名称组织，使用"."将logger名切分父logger与子logger，当子logger未设置日志级别， 则使用父日志级别，直到ROOT，ROOT至关于Java中的Object。子日志级别被设置后，父（含ROOT）日志级别将再也不对子日志有效， 相似于java子类重写父类方法。

13.3 查看版本号

网关版本号用于区分网关各实例的版本，默认配置下版本号形式为：sag_x.y_timestamp，timestamp为打包时间戳， 可在配置文件中经过zuul.version修改。

SIA相关开源产品连接

• 微服务任务调度框架 ：github.com/siaorg/sia-…
• 微服务路由网关 ：github.com/siaorg/sia-…
• Rabbitmq队列服务PLUS：github.com/siaorg/sia-…