微服務網(wǎng)關SIA-GateWay使用指南

一、DeskTop

DeskTop展示當前注冊的各個網(wǎng)關組，點擊一個 網(wǎng)關組 將選中該網(wǎng)關組并跳轉至首頁。

每個網(wǎng)關組包括如下四項：

• 角色值：網(wǎng)關應用名前綴，用于區(qū)分網(wǎng)關組
• 擁有實例：網(wǎng)關組實例個數(shù)
• 網(wǎng)關狀態(tài)：網(wǎng)關組當前狀態(tài)
• 網(wǎng)關描述：網(wǎng)關組描述信息，可修改

二、首頁

首頁展示網(wǎng)關當前的運行情況。

主要包含如下部分：

• 網(wǎng)關調用趨勢：每小時各節(jié)點調用量，共30小時
• 網(wǎng)關健康狀況：每小時各節(jié)點健康狀況，共30小時
• 監(jiān)控告警：運行過程中發(fā)送的警告
• 網(wǎng)關集群狀態(tài)：各節(jié)點CPU、JVM和連接數(shù)監(jiān)控，其中CPU和JVM數(shù)據(jù)取自Actuator

三、路由管理

路由管理分如下四部分：

3.1 新建路由

新建路由填寫如下選項：

• 路由ID：路由唯一標示，也是數(shù)據(jù)庫表primary key
• 網(wǎng)關集群組名：填寫當前網(wǎng)關組名，右上角可見
• 應用名稱：選填，一般填應用名
• 匹配路徑：后端服務的path
• 后端服務策略：存在如下三種選擇：

• 后端服務URL：后端服務策略選擇后端服務URL和ListofServer時填寫后端ip:port
• 前綴是否生效：選擇是則真正的匹配路徑= 匹配路徑 +公共前綴

3.2 路由導入導出

路由導入導出可用于測試環(huán)境與生產(chǎn)環(huán)境路由數(shù)據(jù)同步

• 路由導出：默認導出當前網(wǎng)關組全部路由，可選擇部分路由導出，點擊 路由導出 將下載routerList.json文件
• 路由導入：點擊 路由導入 選擇導入的路由文件，導入后將提示導入成功和失敗的路由ID，導入的路由為編輯狀態(tài)

3.3 路由操作

路由操作分為以下兩部分：

• 修改路由狀態(tài)：路由狀態(tài)分為編輯、發(fā)布、下線三種狀態(tài)，對應有發(fā)布、下線、修改、刪除和查看操作
• 路由組件管理：API網(wǎng)關提供了功能豐富的組件，在組件管理中綁定了路由后，可在該路由下查看或配置組件，各組件功能和用法參考組件管理

3.4 路由拓撲

點擊 路由拓撲圖 展示路由的實時拓撲圖，拓撲圖分為三段：應用->網(wǎng)關->后端服務，如果該路由沒有請求則路由拓撲圖為空。

四、組件管理

網(wǎng)關提供了功能豐富的公共組件，同時支持用戶上傳第三方組件。使用組件時首先需要在 組件管理 中綁定路由，然后在 路由管理 中查看或配置組件。

4.1 公共組件

公共組件描述說明了組件的功能和用法，分為如下幾種：

• 日志：分為請求日志組件和影響日志組件
• 灰度：分為藍綠部署組件和金絲雀組件
• 監(jiān)控：統(tǒng)計組件，統(tǒng)計路由訪問情況
• 限流：限流組件，限制路由單位時間請求數(shù)
• 安全：安全認證組件和黑白名單組件

4.2 第三方組件

第三方組件由用戶自定義實現(xiàn)，上傳后即可使用。點擊 第三方組件 查看已經(jīng)上傳的第三方組件，點擊 組件上傳 可上傳自定義的第三方組件。

五、網(wǎng)關監(jiān)控

網(wǎng)關監(jiān)控分為兩部分：運行狀態(tài)監(jiān)控和拓撲圖

5.1 運行狀態(tài)監(jiān)控

運行狀態(tài)監(jiān)控包含如下監(jiān)控項：

• 監(jiān)控：集成Hystrix dashboard
• 日志：展示當前日志文件內容，數(shù)據(jù)來自Actuator
• JVM：監(jiān)控負載、類加載、線程等，數(shù)據(jù)來自Actuator
• 內存：監(jiān)控JVM內存，數(shù)據(jù)來自Actuator
• 垃圾回收：監(jiān)控parnew和CMS回收器，數(shù)據(jù)來自Actuator
• 配置：包括內部和外部的配置文件，數(shù)據(jù)來自Actuator

5.2 拓撲圖

拓撲圖展示了該網(wǎng)關的服務流圖，是全部路由拓撲圖的集合。

六、日志管理

日志管理集成了Kibana，用戶點擊 日志管理 時將跳轉至Kibana展示網(wǎng)關組ES索引的日志數(shù)據(jù)。如果路由綁定了日志請求組件或日志響應組件， 可在 路由管理 - 操作 -> 請求日志組件 或 響應日志組件 跳轉。

七、熔斷管理

熔斷管理展示了網(wǎng)關運行過程中被Hystrix熔斷的請求信息，包括熔斷類型、錯誤信息和堆棧信息等。

八、注冊中心管理

注冊中心管理主要包括兩部分：注冊信息查詢和動態(tài)修改注冊中心地址

8.1 注冊信息查詢

注冊信息來自于當前網(wǎng)關組所在的Eureka，點擊 查詢 符合條件的應用。

8.2 動態(tài)修改注冊中心地址

Eureka服務端地址默認使用本地配置，用戶可通過 設置Eureka 修改Eureka地址，設置成功后新設置的Eureka地址將保存在數(shù)據(jù)庫中， 同時通知該網(wǎng)關組節(jié)點修改內存中注冊中心地址并重新注冊。點擊 重置Eureka 將清除數(shù)據(jù)庫中的Eureka地址并通知該網(wǎng)關組節(jié)點使用本地配置。 設置/重置后將彈窗提示結果。

注冊中心地址設置/重置成功條件：

• 該網(wǎng)關組下無狀態(tài)為 發(fā)布 的路由
• 管理端可以請求通新注冊中心地址

九、路由聯(lián)通性測試

支持GET和POST兩種方式測試路由是否聯(lián)通。

十、網(wǎng)關Swagger

網(wǎng)關Swagger整合了注冊中心注冊的服務的全部網(wǎng)關接口文檔，可通過右上角選擇不同服務查看接口文檔。

十一、系統(tǒng)黑名單

系統(tǒng)黑名單可設置全局黑名單，目前支持IP攔截策略，設置后所有來自該IP的請求都將被攔截。

十二、網(wǎng)關審計

網(wǎng)關審計展示了所有在網(wǎng)關管理端操作的用戶、行為和性能，方便監(jiān)控和分析用戶行為。

十三、網(wǎng)關設置

網(wǎng)關設置分為三部分：預警郵箱、日志級別操作、查看版本號

13.1 預警郵箱

發(fā)生預警時將發(fā)送預警郵件至設置的郵箱

13.2 日志級別操作

網(wǎng)關日志級別默認為INFO，用戶調試時可查看或動態(tài)調整日志級別。日志名可選com.creditease和root，日志級別可選INFO和DEBUG。

在Logback等日志框架中，logger層級類似于java繼承，以名稱組織，使用"."將logger名切分父logger與子logger，當子logger未設置日志級別， 則使用父日志級別，直到ROOT，ROOT相當于Java中的Object。子日志級別被設置后，父（含ROOT）日志級別將不再對子日志有效， 類似于java子類重寫父類方法。

13.3 查看版本號

網(wǎng)關版本號用于區(qū)分網(wǎng)關各實例的版本，默認配置下版本號形式為：sag_x.y_timestamp，timestamp為打包時間戳， 可在配置文件中通過 zuul.version 修改。

SIA相關開源產(chǎn)品鏈接

• 微服務任務調度框架 ：https://github.com/siaorg/sia-task
• 微服務路由網(wǎng)關 ：https://github.com/siaorg/sia-gateway
• Rabbitmq隊列服務PLUS：https://github.com/siaorg/sia-rabbitmq-plus