Minbox Logging?是一款分布式、零侵入式的鏈路日志分析框架，支持 SpringCloud?微服務架構下配置使用，內部封裝了 RestTemplate、OpenFeign?兩種方式透傳鏈路信息。

零侵入式

MinBoxLogging無需使用注解配置采集鏈路日志，只需要添加 依賴后簡單配置 MinboxLogginAdmin的相關 地址或 服務名稱即可，每次在收到請求時就會把請求對應的鏈路日志詳細信息自動上報到 MinBoxLoggingAdmin進行后續分析、告警通知等。

鏈路日志分析圖

日志客戶端

鏈路日志的采集端，也就是具體的業務服務，只需要添加 minbox-logging-client客戶端進行簡單的配置就可以實現日志的采集以及日志的異步上報。

日志管理端

對外提供 安全的日志上報功能，通過整合 SpringSecurity來完成 BasicAuth基礎認證，管理端接收到采集端上報的日志后會自動將日志存儲到數據庫，考慮到擴展方便，同樣也提供監聽 日志上報事件(ReportLogEvent)的方式來自定義存儲日志到 消息隊列、 logstash、 文件等存儲介質。

日志管理界面

MinBoxLoggingAdmin提供了界面管理應用程序，通過 VUE前端框架進行編寫界面與管理端的接口通訊，實時展示 鏈路日志、 日志采集服務列表等信息，可查看每條鏈路日志的詳細信息（包含：請求頭、請求參數、響應內容、響應頭、狀態碼、異常堆棧信息等）。

整合 Spring Security 后的登錄界面

可以直接整合 SpringSecurity來完成 Basic安全認證。

上報日志的服務列表

請求日志的采集服務在第一次上報時，會自動創建一條服務記錄，服務的唯一性是根據： 服務ID + 服務IP + 服務端Port 來進行定義。

在每次上報日志成功后會修改服務的最后一次上報時間。

鏈路日志列表

鏈路日志是我們訪問的入口服務生成，比如： bff-user -> user-service，鏈路日志產生的位置則是 bff-user服務，鏈路日志是接口 請求的入口也是做出 響應的結束位置，因此我們可以在頁面上查看接口的請求 參數詳情、 頭信息以及 響應的內容，至于鏈路日志內的 日志單元目前界面還未做展示，可以根據 traceId鏈路日志編號自行去數據庫查詢。

鏈路日志詳情

每一個請求的鏈路日志都會包含上圖中的全部字段，從請求開始 -> 響應結束一條鏈路閉合記錄。

安全性

MinBoxLoggingAdminUI內部提供了 login.html登錄頁面，可以整合 SpringSecurity通過配置 loginPageUrl登錄跳轉地址來使用內置的登錄頁面，當然也可以自定義登錄頁面。

可與 MinBoxLoggingAdmin共同使用 SpringSecurity的相同配置提升安全性。

文檔

當前版本的文檔，請訪問?Wikis

快速開始

請訪問快速開始的 wikis文檔來查看并快速接入 MinBoxLogging，快速接入文檔

源碼方式構建

MinBoxLogging使用 Maven進行構建項目。

先決條件

源碼拉取需使用 Git，具體使用方式詳見安裝 Git

源碼采用 JDK1.8版本進行編寫，請注意修改使用項目的 JDK版本，JDK 1.8下載地址

需本地安裝 Maven環境，Maven 下載地址

因 logging-admin-ui所需 vue-cli-service命令支持，本地需要安裝 vue-cli。

拉取源碼到本地

git clone [email protected]:minbox-projects/minbox-logging.git

安裝到本地Maven倉庫

mvn install

編譯 & 打包生成 jar 包

mvn clean package

Maven倉庫依賴構建

MinBoxLogging內的模塊都已經上傳到 ApacheMavenCenter中央倉庫，添加對應的依賴到 pom.xml會自動下載到本地。

歡迎提交貢獻代碼

MinBoxLogging歡迎廣大開發者創建 PullRequest來貢獻代碼，代碼通過審核后會被合并到 master主分支。