MinBox Logging

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

零侵入式

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

鏈路日誌分析圖

日誌客戶端

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

日誌管理端

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

日誌管理界面

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

初版更新內容

1. 完成https://gitee.com/minbox-projects/minbox-logging/issues/I10UR2特性

2. 完成https://gitee.com/minbox-projects/minbox-logging/issues/I111N0特性

3. 完成https://gitee.com/minbox-projects/minbox-logging/issues/I11L13特性

4. 完成https://gitee.com/minbox-projects/minbox-logging/issues/I11NPP特性

5. 修復https://gitee.com/minbox-projects/minbox-logging/issues/I11NPT

6. 支持SpringCloud服務註冊中心獲取logging-admin管理端地址上報日誌

7. 支持RestTemplate透傳鏈路信息

8. 支持OpenFeign透傳鏈路信息

9. 支持SpringSecurity安全上報請求日誌

10. 支持指定logging-admin管理地址上報日誌

11. 支持資料庫存儲日誌信息、採集日誌服務基本信息

12. 支持自定義存儲方式

13. 支持自定義生成traceId

14. 支持自定義生成spanId

15. 支持控制台列印日誌信息

16. 支持控制台格式化日誌信息

17. 支持隨機權重負載均衡上報日誌到logging-admin

18. 支持平滑輪詢權重負載均衡上報日誌到logging-admin

19. 提供logging-admin-ui界面查看日誌信息、上報日誌服務信息

20. 支持定時上報日誌

源碼地址

https://gitee.com/minbox-projects/minbox-logging

文檔地址

https://gitee.com/minbox-projects/minbox-logging/wikis

提交使用中遇到的問題

遇到你在集成使用過程中遇到了問題，請提交issues，提交地址：創建Issues

ApiBoot集成實踐示例

ApiBoot作為 MinBox開源組織的組件最佳集成方案，在第一時間會進行整合minbox-projects開源組織內新發布的組件， MinBoxLogging整合實踐請訪問 ApiBoot源碼，整合源碼詳見 org.minbox.framework.api.boot.autoconfigure.logging。